Webhook

This document describes webhooks and how they are used by the NusaSMS Platform.

Webhooks are HTTP requests containing JSON payloads that are sent from NusaSMS’s servers to a server of your designation. The NusaSMS uses webhooks to inform you of incoming messages, the status of outgoing messages, and other important information.

Setup a webhook endpoint

To receive webhooks, you must create your own endpoint, then register the endpoint by subscribing to the WhatsApp Business Webhook from the NusaSMS Platform.

Payload size

Webhook payloads can be up to 3 MB.

Webhook delivery failure

If a webhook request to your endpoint receives an HTTP status code other than 200, or if the webhook cannot be delivered for another reason, the NusaSMS system will not deliver it again.

Webhook handling

Webhook endpoints must acknowledge receipt by returning a successful response immediately. Process the payload asynchronously afterward. Do not hold the request open during data processing, as poor handling may degrade system performance.

For developers, you can see technical information about webhook on the WhatsApp Business Webhook.