Developer
Webhooks
this is webhook page
What are Webhooks?
A webhook is a way for one app to automatically send data to another app when something happens. Instead of checking for updates all the time, the receiving app gives a special URL, and the sending app sends information to that URL as soon as the event occurs. This helps automate tasks, keep data updated in real-time, and connect different systems without manual work.Benefits of Using Webhooks in Convertalk
The following are the benefits of using webhooks on Convertalk:- Receive instant alerts on message failures, subscription expiries, and account issues.
- Trigger automated workflows based on real-time message and account events.
- Monitor platform activity with actionable insights on usage and performance.
- Integrate seamlessly with CRMs, marketing tools, and internal systems.
How to use Webhooks on Convertalk:
- Log into your Convertalk account, and then go Developer section under the More section.
-
Click on the third tab to access the “Webhooks” section.
- Here, the user has the options to configure webhooks for 3 types, WhatsApp, Instagram and Account Level.
- Click on a card(WhatsApp, Instagram or Account Level) to configure the section.
-
Click on “Subscribe Webhooks”.
-
A small popup window will open up. Enter your Webhook Endpoint, and verification key. Then, select the bots that you want the webhooks to be triggered for.
- Once selected, the webhooks will be configured. Now, we can go into the specifics of each and select the ones to turn on.
WhatsApp Webhook’s
- There are many webhooks that have been created for WhatsApp. Some of them are as follows:
| Failed Message | Tells when a message could not be delivered |
|---|---|
| Account Alerts | Tells when your account does not meet our notability requirements. You can edit the display name and submit another request after 30 days. |
| Account Review Update | Tells when account review request gets approved. |
| Account Update | Update on the business verification of the WhatsApp account. |
| Business Capability Update | Updates on the max daily limits per day |
| Business Status Update | Updates the status of the business |
| Template Quality Update | Updates on the template quality. |
| Template Status Update | Tells of the approval status of the template. |
| Messages | Tells of the messages that are recieved. |
| Phone Number Name Update | Updates you when the name related to a phone number is updated |
| Phone Number Quality Update | Tells of the plan quality of a new user. |
| Security | Tells information regarding the security of the PIN’s. |
| Template Category Update | Updates the template category. |
- To edit any webhook, click on the “Edit Webhook Subscription” button.
- To disconnect the webhook, turn off the status of the webhook. To disconnect all the webhooks status, click on the “Unsubscribe Webhooks” button and confirm the unhook process.
Instagram Webhook
- Instagram webhooks work similar in manner to WhatsApp Webhooks.
- To edit any webhook subscripton, click on the “Edit Webhook Subscription” button.
-
To disconnect the webhook, turn off the status of the webhook. To disconnect all the webhooks status, click on the “Unsubscribe Webhooks” button and confirm the unhook process.
Account Level Webhooks
| Webhook Name | Use Case |
|---|---|
| Message limit exhausted | Notifies the customer when their available message quota has been fully utilized. Customers can customize this notification to trigger when a certain percentage of their plan has been exhausted. |
| Conversation limit exhausted | Alerts the customer when their WhatsApp conversation limit is reached. |
| Plan expired | Sends a notification when the customer’s subscription plan has expired. |
| Account freeze | Notifies the customer when their account is temporarily frozen due to non-payment or policy violations. |
FAQ’s
These are the commonly asked questions regarding Webhooks:What are webhooks in Convertalk?
What are webhooks in Convertalk?
Webhooks are automated callbacks that notify your system in real-time when specific events occur on Convertalk, such as message delivery failures or subscription changes.
Which platform do Convertalk webhooks support?
Which platform do Convertalk webhooks support?
Webhooks are supported for WhatsApp, Instagram, and application-level events within the Convertalk ecosystem.
What kinds of events can trigger a webhook?
What kinds of events can trigger a webhook?
Events include failed message delivery, auto-reply execution, message limit exhaustion, conversation usage updates, subscription expiry, and account freezes.
Are webhooks real time?
Are webhooks real time?
Yes. Convertalk webhooks are designed to send event notifications immediately as they occur.
What format does the webhook payload use
What format does the webhook payload use
Webhook payloads are sent in JSON format, containing structured data about the triggered event.
How can I test if my webhook is working?
How can I test if my webhook is working?
Convertalk provides testing options within the webhook configuration section, allowing you to simulate event triggers and validate your endpoint setup.
What should I do if my webhook endpoint fails?
What should I do if my webhook endpoint fails?
Ensure your endpoint URL is active and accessible. Convertalk may retry failed deliveries, but persistent failures will require you to debug and update your configuration.