Skip to main content

Webhooks

Webhooks allow you to receive real-time notifications when events happen in your Sydx AI workspace. This is useful for integrating with external systems, triggering custom workflows, or building advanced automations.

How Webhooks Work​

  1. You configure a webhook URL in your Sydx AI settings
  2. When an event occurs (new message, status change, etc.), Sydx AI sends an HTTP POST request to your URL
  3. Your server processes the event and responds with a 200 OK status
  4. If your server doesn't respond, the system will retry the delivery

Supported Events​

EventDescription
New MessageA new incoming message is received from a contact
Message StatusA sent message's delivery or read status changes
Interactive ReplyA contact responds to an interactive button or list message
Contact UpdatedA contact's details or lead status changes
Flow TriggeredA chatbot flow is triggered for a contact

Setting Up Webhooks​

From the Dashboard​

  1. Go to Settings → Integrations
  2. Find the Webhooks section
  3. Enter your Webhook URL (must be HTTPS)
  4. Select which events you want to receive
  5. Click Save

Requirements​

  • Your endpoint must accept POST requests
  • Must respond with a 200 status code within 5 seconds
  • Must be accessible via HTTPS (SSL required)

Security​

All webhook deliveries include security measures:

  • Signature verification — Each request includes a cryptographic signature for verification
  • HTTPS only — Webhooks are only sent to secure endpoints
  • Retry logic — Failed deliveries are retried automatically
Best Practice

Always verify the webhook signature on your server before processing the event. This ensures the request genuinely came from Sydx AI and was not forged.

Using Webhooks with Third-Party Tools​

Sydx AI webhooks work seamlessly with popular integration platforms:

PlatformHow to Connect
ZapierUse the "Webhooks by Zapier" trigger
Make.comUse the "Webhooks" module as trigger
n8nUse the "Webhook" trigger node
Custom ServerPoint directly to your API endpoint

Troubleshooting​

Webhook Not Receiving Events​

  • Verify the URL is correct and accessible
  • Ensure HTTPS is enabled on your endpoint
  • Check your server logs for incoming requests
  • Make sure the events you want are selected in settings

Duplicate Events​

  • Implement idempotency on your server — check for duplicate event IDs before processing
  • This is a standard practice for webhook receivers