Skip to main content

Webhooks Integration

Send Deway events to any custom endpoint for maximum flexibility.

Overview​

The Webhooks integration lets you:

  • Send events to your own backend or data pipeline
  • Build custom workflows triggered by Deway activity
  • Integrate with any tool that accepts HTTP webhooks

Setup​

Prerequisites​

  • An active Deway account with the Web SDK installed
  • A publicly accessible HTTPS endpoint that accepts POST requests
  • Admin permissions in Deway

Step 1: Prepare Your Endpoint​

Your endpoint must:

  • Accept POST requests
  • Accept application/json content type
  • Return a 2xx status code to acknowledge receipt
  • Be accessible over HTTPS

Step 2: Configure in Deway​

  1. Log into your Deway dashboard
  2. Navigate to Settings > Integrations
  3. Find Webhooks in the integrations list
  4. Click Connect
  5. Enter your endpoint URL
  6. Click Save

Payload Format​

Deway sends a JSON payload for each event:

{
  "event": "chats",
  "timestamp": "2024-06-15T10:30:00Z",
  "properties": {
    "chat_id": "chat_abc123",
    "actor": "user",
    "chat_type": "ask-me-anything",
    "tenant_id": "tenant_456"
  },
  "user_id": "user-789"
}

Events Sent​

EventDescription
chatsChat session created or updated
walkthrough-progressUser completed a walkthrough step

See the Integrations Overview for full event property details.

Retry Policy​

If your endpoint returns a non-2xx status:

  • Deway retries up to 3 times with exponential backoff
  • After all retries fail, the event is dropped

Use Cases​

Custom Data Pipeline​

Forward events to your data warehouse (BigQuery, Snowflake, Redshift) for custom analytics.

Internal Alerting​

Send events to PagerDuty, OpsGenie, or your internal alerting system.

Third-Party Integrations​

Connect Deway to any tool with a webhook API — Zapier, Make, n8n, or your own microservices.

Troubleshooting​

Events Not Arriving​

  1. Verify the endpoint URL is correct and publicly accessible
  2. Check your server logs for incoming requests
  3. Ensure your endpoint returns a 2xx status code
  4. Test your endpoint with curl: 
    curl -X POST https://your-endpoint.com/webhook \
      -H "Content-Type: application/json" \
      -d '{"event": "test"}'

Duplicate Events​

If your endpoint is slow to respond (>5s), Deway may retry. Use the chat_id or event timestamp to deduplicate.

Next Steps​