Webhook integration syncing mechanism

Using Cooby Webhook integration to sync your WhatsApp messages to your endpoints, there are a few things regarding our syncing mechanism that you might want to know.

Each request contains only one message

Once you receive or send a new message, we will send a webhook request to your endpoint. No bulk requests, only a single message for a single user.

The request order

Once we receive numerous message requests from different chats, we will follow the same chat ID and then timestamp to send these requests. For example, if there are two different conversations, Cooby will receive these chats by chat ID and then by timestamp to sync messages.

Once we receive these messages, they will sync to your endpoint. However, kindly note that the messages may sync in a random order depending on the message size and your network stability.

Sync failed

If any error occurs, Cooby currently won’t retry to sync again. Additionally, there is no fallback system in place.

We hope this document helps you better understand how Cooby works. For any concerns or questions regarding your Webhook integration, kindly email us at support@cooby.co 💜

Updated on: 29/05/2025