Why do I need a webhook and how does it work?

Webhooks are user-defined HTTP callbacks that are triggered by specific events and enable asynchronous event delivery (notifications, messages, etc.). Webhooks are called by tyntec’s WhatsApp Business API by a callback URL.

    You can use webhooks in two ways:

    The tyntec API is using webhooks for delivery of incoming messages to your WABA. We need to expose an HTTP endpoint by implementing the `POST’ HTTP method to set up the webhook URL with tyntec. This endpoint of your application will be responsible for processing the incoming messages.

    The Conversations API triggers the webhook on the following events (configurable):

    MessageStatus::accepted
MessageStatus::delivered
MessageStatus::seen
MessageStatus::failed
MessageStatus::channelFailed
MessageStatus::deleted
MoMessage
WhatsAppGroupEvent::userJoined
WhatsAppGroupEvent::userLeft
WhatsAppGroupEvent::subjectChanged
WhatsAppGroupEvent::descriptionChanged

    Note: Companies integrating tyntec’s API for WhatsApp Business should define webhook URLs for incoming messages and delivery notifications.

    Due to security reasons, your setup with tyntec must be encrypted, and therefore we accept only HTTPS webhooks. Please be aware that a certificate from an official Certificate Authority (CA) is needed.

    ⭐ Check our Webhook self-service API to specify applications with webhooks.