Before you start: advantages and limitations of an API integration
- It does not depend on the client, as it is an HTTP call where you can control the response received to ensure that the event arrived and was processed correctly.
- It allows for mass imports, while other options are always updated one by one.
The possible limitations of an API integration are as follows:
- It requires an IT department able to make the necessary Connectif API calls.
- There is a maximum number of API calls per minute, so for mass operations we recommend using the import API, where a single call can synchronize multiple elements.
- It is not possible to integrate all events through the API – you’ll need to combine this with one of the other integration options.
How to integrate Connectif via API
2. Synchronize via API
Configure the synchronization of information about:
- Contacts: para to register the data of visitors to the ecommerce site.
- Products: to synchronize the catalog.
- Purchases: to describe purchases made by customers
- Vouchers: to synchronize voucher codes and their uses.
3. Synchronize all other events by another method
3.1. HTML tags rendered on the server or the client:
- "Current cart status" tag: to describe the contact’s shopping cart at a given moment.
- "Page tag": to assign a tag to a page.
- “Page Category" tag: to assign a product category to a page.
- "Contact has visited a product" tag: to report that the contact has visited a specific product while browsing the website.
- "Contact has searched for a product" tag: to identify a visit to a product as a direct result of a product search.
- “Contact has logged in” tag: to indicate that the contact has logged in.
- “Contact has registered” tag: to indicate a new registration.
- "Newsletter subscription" tag: to indicate that a contact has subscribed to the newsletter.
- Page visited notification: to report that the contact has visited a page while surfing the web.
- Product visited notification: to report that the contact has visited a specific product while browsing the website.
- Cart information notification: to describe the contact’s shopping cart at a given time.
- Notification of search performed: to indicate that a search has been performed and to identify the terms used.
- Login notification: to indicate that the contact is logged in.
- Registration notification: to indicate a new registration.
- Newsletter subscription notification: to indicate that a contact has subscribed to the newsletter.
5. Configuring Web Push notifications
To complete the integration you will also need to configure the Service Worker to receive Web Push subscriptions and send notifications to your contacts.
6. Validate the integration
Once you’ve implemented the sending of information to Connectif, the next step is to confirm that the integration has been carried out correctly.
To make the most of your Connectif account, we recommend reading these articles next:
Onboarding, to learn all about our interface.
Initial workflows, to implement your first strategies in your account.
Integrations with external systems, to integrate your Facebook, website forms and webhooks.
Events that use your Activity allowance, to understand your account consumption better.