Docs/Webhooks

Webhooks

Receive real-time notifications when events occur in your WeTalk account.

How Webhooks Work

When an event occurs (like a message being delivered), WeTalk sends an HTTP POST request to your configured endpoint with event data.

W
WeTalk
Your Server

Setting Up Webhooks

  1. 1Go to Dashboard > Webhooks
  2. 2Click "Add Webhook" and enter your endpoint URL
  3. 3Select the events you want to receive
  4. 4Save and test your webhook

Webhook Payload

Example Payload
{
  "event": "message.delivered",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "message_id": "msg_abc123",
    "to": "+1234567890",
    "status": "delivered",
    "delivered_at": "2024-01-15T10:30:00Z"
  }
}

Available Events

EventDescription
message.sentA message was successfully sent
message.deliveredA message was delivered to the recipient
message.failedA message failed to deliver
message.receivedAn inbound message was received
call.initiatedA voice call was initiated
call.answeredA voice call was answered
call.completedA voice call ended