Contlo Integration
In this article we will show you how to set up the Contlo Integration on your Nector dashboard.
Visit the Integrations Page. Click on Email & WhatsApp Marketing in the side-bar. Scroll below to look for Contlo in that section.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_i17ca4.png)
Click on Configure to open up the Contlo integration page.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_1gvf1e.png)
First to enable the integration, you need to get the private API key from your Contlo dashboard.
Login to your Contlo dashboard.
Click on your store name in the top right area, and click on Settings.
Click on Marketing Settings tab on the left area.
Click on API Keys tab in the top.
Under Private API Keys, create a new API key by click on the Create API Key button and giving any name.
Copy the newly create API Key and paste in the nector dashboard. See below image for reference.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_miscuv.png)
Now paste it in your Nector dashboard. Under Choose Common property, select Email as the mode of communication
Choose Common Property - This refers to the user property of Nector which will be used when sending the event.
Finally, click on Initialize button to button to enable the integration. Once it is enabled, you will see the below view.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_guond3.png)
Nector app needs to be installed and enabled on Contlo as well. Follow these steps to install the app:
Go to your Contlo dashboard
From the left side menu, click on App Market
Search for Nector here and click on it.
Install the app
After installing the Nector app on Contlo, you should be able to see the below view on Contlo.
![](https://storage.crisp.chat/users/helpdesk/website/e60d7b076b79b800/ff3e1afe-fb5e-4cfb-b2ab-f38b97_iclvz4.png)
Events can be sent to Contlo when certain things happen on Nector. You can then setup automations on Contlo, which can be triggered when the event occurs on Nector. For example, when a customer is rewarded with wallet coins, an event can be sent to Contlo, which in turn will trigger an automation that sends an email to the customer.
Switch to the Events tab and click on Create An Event. It opens up to the Events page with the Send Events tab. Now you have to select the event on which you want to notify the external integration.
There are many events supported on Nector. If you don't know which to choose, here are the two events that are most relevant and commonly used:
Wallet Coins Rewarded: This event will be sent whenever wallet coins are rewarded on nector.
Coupon Is Created: This event will be sent whenever a customer uses his wallet coins to get a discount/coupon code on nector.
For example,
To send an Wallet Reward Event to Contlo whenever wallet coins are rewarded to a customer on Nector, you would create the event as shown below.
Click on "+" button to create an event.
For "Event" option, select Wallet Coins Rewarded
For "Send event to" option, by default Contlo will be selected.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_syycyg.png)
Once you have entered all the details, click on the Create button in the popup. The event will be created as below.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_r5upoa.png)
In order to make this event available in your Contlo dashboard, you need to send a test event from Nector as shown below. After this, you can setup the flow on Contlo using this event as the trigger.
Click on the Event you just created
You can send a test event by clicking on Send Test Event.
A popup opens, enter the email id where you want to send the test email.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_kc0335.png)
Kindly note, the Email id of customer to whom email has to be sent needs to exist in the Customers database of your store.
After you are done setting up events to be sent to Contlo from Nector, you can create automations on Contlo to do some action when the event occurs.
For this, visit your Contlo dashboard and create a new automation. In the trigger part of the automation, you can choose any event that is sent from Nector. Following the example from before: to send an email whenever a customer is rewarded with wallet coins, this is how a basic automation setup would look like:
![](https://storage.crisp.chat/users/helpdesk/website/9da1e6a9f893400/0a3718b7-876e-4417-89a0-52e1dc_zrublj.png)
Events can also be sent for other things like when a new customer is referred, for coin expiry notification, for review request, and more. To learn how to setup these events, look into those respective articles.
For a list of events and the data associated with each event, please refer this article for more info: https://nector.crisp.help/en/article/event-details-sent-to-external-integrations
Events
Event details sent to External Integrations
All features of Contlo
Setting up the Integration
Visit the Integrations Page. Click on Email & WhatsApp Marketing in the side-bar. Scroll below to look for Contlo in that section.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_i17ca4.png)
Click on Configure to open up the Contlo integration page.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_1gvf1e.png)
First to enable the integration, you need to get the private API key from your Contlo dashboard.
Getting your private API key
Login to your Contlo dashboard.
Click on your store name in the top right area, and click on Settings.
Click on Marketing Settings tab on the left area.
Click on API Keys tab in the top.
Under Private API Keys, create a new API key by click on the Create API Key button and giving any name.
Copy the newly create API Key and paste in the nector dashboard. See below image for reference.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_miscuv.png)
Now paste it in your Nector dashboard. Under Choose Common property, select Email as the mode of communication
Choose Common Property - This refers to the user property of Nector which will be used when sending the event.
Finally, click on Initialize button to button to enable the integration. Once it is enabled, you will see the below view.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_guond3.png)
Installing the Nector app on Contlo
Nector app needs to be installed and enabled on Contlo as well. Follow these steps to install the app:
Go to your Contlo dashboard
From the left side menu, click on App Market
Search for Nector here and click on it.
Install the app
After installing the Nector app on Contlo, you should be able to see the below view on Contlo.
![](https://storage.crisp.chat/users/helpdesk/website/e60d7b076b79b800/ff3e1afe-fb5e-4cfb-b2ab-f38b97_iclvz4.png)
Sending Events To Contlo
Events can be sent to Contlo when certain things happen on Nector. You can then setup automations on Contlo, which can be triggered when the event occurs on Nector. For example, when a customer is rewarded with wallet coins, an event can be sent to Contlo, which in turn will trigger an automation that sends an email to the customer.
Add new event
Switch to the Events tab and click on Create An Event. It opens up to the Events page with the Send Events tab. Now you have to select the event on which you want to notify the external integration.
There are many events supported on Nector. If you don't know which to choose, here are the two events that are most relevant and commonly used:
Wallet Coins Rewarded: This event will be sent whenever wallet coins are rewarded on nector.
Coupon Is Created: This event will be sent whenever a customer uses his wallet coins to get a discount/coupon code on nector.
For example,
To send an Wallet Reward Event to Contlo whenever wallet coins are rewarded to a customer on Nector, you would create the event as shown below.
Click on "+" button to create an event.
For "Event" option, select Wallet Coins Rewarded
For "Send event to" option, by default Contlo will be selected.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_syycyg.png)
Once you have entered all the details, click on the Create button in the popup. The event will be created as below.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_r5upoa.png)
Sending Test Event
In order to make this event available in your Contlo dashboard, you need to send a test event from Nector as shown below. After this, you can setup the flow on Contlo using this event as the trigger.
Click on the Event you just created
You can send a test event by clicking on Send Test Event.
A popup opens, enter the email id where you want to send the test email.
![](https://storage.crisp.chat/users/helpdesk/website/d9947dc4cf2ed000/image_kc0335.png)
Kindly note, the Email id of customer to whom email has to be sent needs to exist in the Customers database of your store.
Setting Up Automations on Contlo
After you are done setting up events to be sent to Contlo from Nector, you can create automations on Contlo to do some action when the event occurs.
For this, visit your Contlo dashboard and create a new automation. In the trigger part of the automation, you can choose any event that is sent from Nector. Following the example from before: to send an email whenever a customer is rewarded with wallet coins, this is how a basic automation setup would look like:
![](https://storage.crisp.chat/users/helpdesk/website/9da1e6a9f893400/0a3718b7-876e-4417-89a0-52e1dc_zrublj.png)
Events can also be sent for other things like when a new customer is referred, for coin expiry notification, for review request, and more. To learn how to setup these events, look into those respective articles.
For a list of events and the data associated with each event, please refer this article for more info: https://nector.crisp.help/en/article/event-details-sent-to-external-integrations
Related Articles
Events
Event details sent to External Integrations
All features of Contlo
Updated on: 21/05/2024