The API notifies other systems via an HTTP POST request to a registered URL, sending the event-related information in the request body. This technique is known as a Webhook.
Currently, the events (known as Topics) that can be reported to a registered URL are:
-
Creation of a prospect in Zenvia Conversion (after receiving and validating a lead)
-
Update of a quote with a status change
-
Resolution of an interaction by a consultant
Registration and Use of Notifications
To register notifications, follow these steps:
-
Obtain the API Key to access the Zenvia Conversion API.
-
Register a new subscription for specific events (topics) and specify a URL for notifications (callbackURL), all directly in the Notifications section of the API.
-
Once the subscription is registered, whenever the event occurs on the platform, Zenvia Conversion will notify the registered URL via an HTTP POST request.
You can check or remove available subscriptions at any time directly in the Notifications API.
Requirements
Remember that you need an API Key to access the API.