Integration with Nector.io
Edgaras Vaninas avatar
Written by Edgaras Vaninas
Updated over a week ago

Nector is a rewards and loyalty solution for ecommerce businesses, helping them improve repeat purchase and conversion rates through discounts, coupons, and points.


Before You Begin

Connect your Nector.io app to the Shopify platform or connect it to your custom ecommerce platform via Nector API.


Once you install the Nector: Loyalty & Rewards app to your ecommerce platform and connect your store, please proceed with the setup guide for Omnisend.


Setup Process

Firstly, visit the Omnisend Integration Page on your Nector dashboard.

Choose the primary selector and get the API key from your Omnisend dashboard to turn on the integration.

Primary Selector is the primary attribute that maps customers between Nector and Omnisend. You can choose "email".

Getting Your API Key

  • Login to your Ominsend dashboard.

  • Click on your Account in the top right corner.

  • Click on Store settings.

  • Scroll down and click on the "API Keys" on the left side menu. See the below image for reference.


  • Click on the "Create API Key" button.

  • Enter a name for the key; you can name it "Nector" or anything you want for easy reference.

  • Select all the permissions. See the below images for reference.

  • After selecting all the permissions, click the "Create API key" button.

  • Copy the newly created API key onto the Nector dashboard. See the below image for reference.

  • After entering the details, click the "Initialize" button to enable the integration. Once it is enabled, you will see the below view.



Sending Events to Omnisend

When specific actions occur on Nector, they can transmit events to Omnisend. Subsequently, you can configure automation within Omnisend, activating them upon the event's incident. For instance, upon a customer receiving wallet coins as a reward, an event notification can be dispatched to Omnisend, prompting automation to deliver an email to the customer.

As the first step, enable the events by toggling the status button on that page. After enabling it, you will see the view below.


Then, you need to set your events. Please refer to this article to learn how to send events from Nector to an external tool.

The following steps assume you have enabled at least one integration from the integration page on the Nector dashboard. In this case, it is a completed integration with the Omnisend app.

Request sent from Nector to external integration has a TTL of 10 seconds; if the request takes more than 10 seconds, it will fail on Nector's side.

Nector will retry the request a maximum of 5 times, with exponential delay.


Add New Event

Now, switch to the "Send Events" tab and click the "Create" button. A popup will open.

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.

Now select the event on which you want to notify the external integration, select the external integration that needs to be notified, and add any filters based on which event sending should be restricted.

To send a Wallet Reward Event to an Omnisend whenever wallet coins are rewarded to a customer on Nector, you would create the event as shown below.

An example is shown in the screenshot below.


Once you have entered all the details, click the "Create" button in the popup.

Events can also be sent for other things like when a new customer is referred, for coin expiry notification, for review requests, and more. Look into those respective articles to learn how to set up these events.


Editing Event

Switch to the "Send Events" tab and click on the event you want to edit.

Here, you can change the external tool to which this event must be sent and add or remove the prefixes from the event name. You can edit the applied filters, too. Once the changes are done, click on the "Update" button.


Deleting Event

Switch to the "Send Events" tab and click on the event that you want to delete.

Here, click on the "Delete" button at the top right area of this page and confirm the action.



Use-case

Automation


Once your created event is triggered from Nector to Omnisend, such an event can be used as an automation trigger. Let's say you want to trigger a specific workflow with an event - lead_create.


Such an event as a workflow trigger would look like in the example below:


Remember that any segment can be used as an automation trigger - more about it here.

Segmentation


Any custom property sent from Nector will be stored as a custom property.


Such properties can be used in segmentation, which can be used to cover various use cases in the automation or simply by campaign targeting.

For any questions or assistance, contact the Nector.io team via [email protected] or at the Nector dashboard. Click the message icon in the bottom right corner to connect with their support team.

Did this answer your question?