Set up Webhook or SSE event delivery for your WSAPI Cloud instances
After pairing your instance, configure how you want to receive event notifications (messages, chats, group updates, etc.) at wsapi.chat/app/settings.In the Instance Setting Defaults section, you can select the Event Delivery mode (Webhook or Pull Mode with SSE).
Your public HTTPS endpoint that will receive events
Yes
Event Signature Secret
Secret used to sign webhook events for verification
Recommended
Always configure signature verification for webhook events to validate the legitimacy of incoming webhook calls. Without it, anyone who discovers your webhook URL could send fake events.
Secret used to sign webhook events for verification
Recommended
In SSE mode, signing events is still recommended to ensure the integrity of the event stream. Always verify signatures on incoming events to protect against tampering or spoofing.
Your app opens a persistent SSE connection to WSAPI
Events are streamed to your app in real time as they occur
If the connection drops, your app reconnects and resumes
We recommend using this mode with one of our official SDKs, which include a proper SSE client implementation. If your language isn’t supported, refer to the SDK’s implementation as a reference.
The event delivery mode you select in the dashboard applies as a default for all instances. However, you can override this on a per-instance basis under the Instance Settings section in the instance details page. This allows you to have different instances using different delivery modes if needed. When overriding settings for an instance, event filtering will also be applied based on the instance’s specific configuration.
