Integrate Connectif with Apisearch to use the search‑data generated by each contact in Connectif workflows, as well as to insert dynamic content generated in Connectif into the search results provided by Apisearch.
In this article, you will learn how to integrate Apisearch with Connectif and how to save contact custom fields into contact custom fields.
Implementation time: 1 hour.
Difficulty: Intermediate
When to use it?: To store the information collected by Apisearch and insert content into searches.
Why implement the extension
1. Use‑cases you will be able to create after this integration
Here are some ideas that may help you implement different strategies once you activate the extension with Apisearch in your Connectif Store:
On the Apisearch layer:
- Personalize the Apisearch search engine with products recommended to the contact based on their search.
-
Include an inline in the Apisearch search engine with a coupon for buyers and recommended products to those who have not purchased.
In the eCommerce:
- Include a recommender on the Home page based on the brand and price ranges that the contact has indicated in Apisearch.
In the communication channels:
- Send an email to the contact with their personalized products based on their searches to contacts who have performed a search in Apisearch including brand and price and have done nothing else.
2. What data will you be able to bring from Apisearch to Connectif?
With this extension, Connectif will receive from Apisearch the information of:
- The search term that a contact uses in Apisearch.
- The minimum and maximum price filter set by the contact in their search.
3. What data from Connectif will you be able to use in Apisearch?
Likewise, in Apisearch you will be able to leverage all the information collected in the Contact Sheet, as well as their real‑time activity, to personalize the Apisearch layer with the contact data from Connectif.
STEP 1: Creation of the custom integration in Connectif
1. Go to Store Settings in the left‑hand menu.
2. In the tab selector, go to "Integrations > Custom Integrations (webhooks)" and click on Create new integration.
3. Set the field "Integration Name" to identify the integration.
4. (Optional) Customize the colour, include a description or categorize the integration.
5. Click Save.
STEP 2: Creating the reception event
2.1. Creating the reception event for search, price, and brand
(This section explains how to create and configure the event to be received from Apisearch).
6. In the Receive Data tab, click Create new reception event and select the Web/Mobile App type.
7. Assign it a name and the alias "Apisearch-event".
You must assign this alias for the integration to work.
8. Click Add new field to create each of the custom fields and complete their information:
- Create a field named "Brand" with ID "brand" of type Text to capture the brand.
- Create a field named "PriceFrom" with ID "pricefrom" of type Decimal to capture the minimum price filter.
- Create a field named "PriceUpTo" with ID "priceupto" of type Decimal to capture the maximum price filter.
9. Click Save.
STEP 3: Storing information in the Connectif Contact Sheet
3.1. Creating custom fields in Connectif
(In this section, the custom fields that will store the information sent from Apisearch, such as brand and price filters, will be created).
10. Go to "Contacts > Contact Fields" and click Add new custom field.
11. Assign it the type Decimal and click Go to editor.
12. Assign the Name "priceFrom" and ID "proceFrom" and click Save. This value will collect the minimum price indicated by the contact.
13. Create a second field, also of type Decimal.
14. Assign the Name "priceUpTo" and the ID "priceUpTo" and click Save. This value will store the contact's maximum price.
3.2. Creating the workflow to update fields
(This section explains how to store the data sent by Apisearch in the Contact Sheet in Connectif through a workflow).
15. Access Workflows from the left menu and create a new Custom Workflow.
16. In the "Start" node settings, under the Select a limitation area, choose All my list and under Select a data source check All existing and new ones.
17. Connect the "Start" node to the Trigger node you created to receive the brand and price from Apisearch.
18. Connect the Trigger node to the "Set field" node.
19. Enter its settings and, within its interface, drag the fields you just created, with Contact as data source, from the left column to the central block, so they match the homonymous fields in the right column.
20. Save the node settings.
21. Save and activate your workflow.
Success!
Your Connectif account integration with Apisearch is ready.
Keep learning!
To take full advantage of your Connectif account, we recommend continuing with the following articles:
Home recommender, to learn how to create a home page recommender banner that can be personalized with Apisearch data.
Custom integration to receive data, to learn how to use information not registered by default on the platform.
Integrations with external systems, to integrate your Connectif account with Facebook, forms, and other webhooks from your site.
API integrations, to manage events like purchase records or contact sign-ups.