Developer documentation

Webhooks

Receive real-time webhook events when visitors chat, tickets change, or conversations update in Wiretalk.

Full API reference: See REST API docs → Webhooks for payload schemas, signature verification, and all event types.

Set up a webhook

Dashboard → Integrations → Webhooks

Add your HTTPS endpoint URL (must be publicly reachable)

Select events (visitor message, agent reply, ticket created, etc.)

Click Send test and verify your server returns 2xx

Popular events

Event	When it fires
`conversation.started`	Visitor opens a new chat
`message.received`	Visitor sends a message
`message.sent`	Agent replies (text, attachment, canned)
`conversation.closed`	Chat is closed by agent or visitor
`ticket.created`	New support ticket (Pro plan)

Delivery timing

Webhooks are delivered asynchronously — usually within a few seconds after the event. Use Send test in the dashboard to confirm your endpoint responds with HTTP 2xx. If deliveries fail, see Troubleshooting → Webhooks.

Verify signatures

Each delivery includes X-Wiretalk-Signature. Verify HMAC-SHA256 with your webhook secret before processing. Full example in the API docs.

Alternative: REST API polling

If you cannot receive webhooks, poll GET /api/v1/conversations with an API key. See the REST API reference.