How can I set up listeners to receive automatic notifications?
With Zembra, you don't have to continuously ping the API for updates. You can simply set up notifications to be routed to your server over an HTTP request, Slack channel, email, or all. Once configured, we'll notify you upon detecting a change on a profile page (new review posted, rating edited, etc.).
To set up listener(s), go to https://my.zembratech.com/settings or click Settings then API.
1. Configure HTTP Post listeners
Notifications sent in an HTTP post call are in JSON format. The API always expects a 200
status code response to confirm reception. Failing to return the expected response, the system will retry delivery every 5 minutes up to 3 times. Listener will be canceled if the issue is not resolved within the 3 attempts.
First enter your HTTP Post URL then check all the events you'd like to be updated about and receive notification to this URL. You could choose to be notified Right away or receive a Daily digest at a specific time of the day.
Make sure to hit the Save button and you'll notice the status change to Operational in the upper righthand corner.
2. Configure Slack listeners
Notifications format depends on the selected payload.
- For
summary
, you will receive human readable messages with aggregates. - For
all
andchanges
you will still receive the summary, but you'll also find the data as an attached file in JSON format. Content is like receiving direct response from the API as described in our API documentation.
Failure to maintain access to your Slack channel will result in an interruption of all listeners and no reattempts will be made.
To configure Slack listeners, click Add to Slack button. This will take your Slack workspace so that you can choose your preferred channels to receive updates notifications from Zembra.
Then check all the events you'd like to be updated about and the time of notification to this Slack channel. You could choose to be notified Right away or receive a Daily digest at a specific time of the day.
Make sure to hit the Save button and you'll notice the status change to Operational in the upper righthand corner and your Slack channel name will be displayed as well.
3. Configure Email listeners
Notifications format depends on the selected payload.
- For
summary
, you will find a table with aggregates in the email body. - For
all
andchanges
you will still receive the summary, but you'll also find the data as an attached file in JSON format. Content is like receiving direct response from the API as described in our API documentation.
We do not track delivery. We added a convenient way to stop this listener by clicking the unsubscribe link in the email.
First enter your email address destination and then check all the events you'd like to be updated about and the time of notification to this Slack channel. You could choose to be notified Right away or receive a Daily digest at a specific time of the day.
When ready, click Save and a message will pop up asking you to verify you email address and provide a 4-digit code to be able to receive updates notifications on this email address.
Check you email inbox and enter the code. Once verified, your email listeners status will change to Operational.