Webhooks

``bash curl -X POST https://flowsdesigner.com/api/v1/webhooks \ -H "Authorization: Bearer $FD_KEY" \ -d '{"url":"https://your-app.com/wh","events":["message.received","conversation.resolved"]}' ``

Available events

• message.received — customer sent a message
• message.sent — your agent or bot sent a message
• conversation.created, conversation.assigned, conversation.resolved
• contact.created, contact.updated
• broadcast.sent, broadcast.completed
• flow.executed

Verification

Set a secret on the subscription. Payloads ship with an X-FlowsDesigner-Signature header (HMAC-SHA256). Verify before processing.

Reliability

• At-least-once delivery (yours code should be idempotent)
• Auto-retry on 5xx with exponential backoff
• Dead-letter after 24h of failures