CRM Integration

In order to integrate leads into a CRM system, we will first need to look into the CRM’s API or the CRM’s requirements document.

In another words, we need to understand how the CRM is expecting to receive the information (or leads) that you are planning to send.

In most cases, your CRM system will expect a set of parameters names and their values types (Number, String, Date).

Some parameters can be optional, some can be required, and some can be required even if they holds an empty.

Before we jump into setting the integration in Hover Lead, please make sure that:

1. We have the list of expected parameters and their value types
2. We have a URL address and a method (POST, GET, Web Service)
3. We have an active leads panel in Hover Lead with the fields that we want to integrate
4. We know what the CRM response is after a successful report
5. We made sure that the CRM system is allowing requests from unknown IP addresses or that we have whitelisted Hover Lead’s static IP address (35.188.123.120)

Now, we can configure how to report our leads following the CRM system requirements.

To create a CRM report, follow these steps:

1. Navigate to the “Form Settings” page “CRM” section.
2. Click “Add New Integration”
3. Click on the desired integration type
4. Click on “General” tab, then:
   1. Toggle the buttons as desired:
      1. Enable – activate or deactivate this integration.
      2. Real-Time – Set the integration to fire the lead immediately when received to Hover Lead and wait for the CRM response to inform the client, or turn it off to integrate regardless of the CRM’s response time (can be up to 10 minutes after the lead has been received to Hover Lead).
      3. Static IP – enable when you need to send the lead from a specific IP address
         Note – When real-time is enabled, forms submission may take longer and delay the Thank you message or Thank you page for the user (depending on the CRM response time)
   2. Optionally, use “Filter Sources” to integrate only the leads of users that came from a specified source (ref) or to integrate all leads and exclude leads of users that came from a specified source.
      Note – If you do not know what the “ref” parameter is, or do not understand what is “Lead Sources” than we recommend that you first read Lead Sources article.
      Select “By Ref” or “Exclude Ref” and then, type the source values and separate them by space or commas. For every lead integration, Hover Lead will try to match the lead source based on ref parameter and then include or exclude the lead from integrating to the CRM.
      Note – In order for this feature to work, make sure that your leads have the “ref” parameter that holds the source name values.
   3. Fill up the required fields, based on the integration type:
      1. If you are integrating it using Request method see CRM Integration using POST or GET Requests
      2. If you are integrating it using Web Service method see – CRM Integration Using a Web Service
      3. If you are integrating it using Email see – CRM Integration to an Email
5. Click on the “Fields” to set up the fields that you want to send, and repeat these steps for each field:
   1. Click the “Add Field” button
   2. Under “Expected CRM fields names” column – enter the name of the parameter as described in the CRM requirements
   3. Under “Expected CRM fields values” column – enter a constant value, or select a value holder by clicking on then“Source” menu, for more information on how to use the “Source” menu, please see Selecting integration values using the “Source” menu
   4. Optionally, add a function to manipulate the value right before it has been sent to the CRM, for more information see Using functions to manipulate integration values
6. Click on “Response” tab to set up the expected CRM response
   1. Select your desired “Response Type”, optional response types are:
   2. Nothing – When you do not want to expect any response from the CRM
   3. General Success – Expect any response as long as it is not an error
   4. Custom Text – Expect a string that matches or contains a value
   5. Custom Object – Expect an object holding a specific key or a value
   6. PHP Function – Create a PHP conditional function that provides True or False results
      Note – When Hover Lead integrates leads it indicates on success or failure of the integration based on the expected response type, if the returned answer from the CRM is different from the expected response, Hover Lead will consider it a failure
7. Click “Save” to save the integration

Note – With Hover Lead you can set multiple integrations from different types to the same form.