Set Up WhatsApp Webhooks

Webhooks allow you to receive real-time notifications when someone sends a WhatsApp message to your number or when the delivery status of an outbound message changes.

How It Works

When an event occurs (e.g., an inbound message or a delivery status update), seven sends an HTTP POST request to the webhook URL you have configured. Your server processes the payload and responds with a 2xx status code to acknowledge receipt.

Configure Your Webhook URL

Log in to dashboard.seven.io.
Navigate to Settings > Webhooks.
Enter your Webhook URL - this must be a publicly accessible HTTPS endpoint on your server.
Select the event types you want to receive.
Save the configuration.

Make sure your endpoint is reachable and responds within a reasonable time (under 10 seconds). If your endpoint is unreachable or returns errors repeatedly, webhook delivery may be paused.

Event Types

Inbound Message (wa_mo)

Triggered when a user sends a WhatsApp message to your connected number. The payload includes the sender's phone number, message content, message type, and timestamp.

Delivery Reports

Triggered when the status of an outbound message changes. Statuses include:

sent - message was sent to WhatsApp servers
delivered - message was delivered to the recipient's device
read - recipient has read the message
failed - message could not be delivered

Payload Format

Webhook payloads are sent as JSON in the body of a POST request. A typical inbound message payload includes:

{
  "event": "wa_mo",
  "from": "491701234567",
  "to": "491709876543",
  "timestamp": "2026-01-15T10:30:00Z",
  "message": {
    "type": "text",
    "text": "Hello, I have a question about my order."
  }
}

The exact payload structure may vary depending on the message type and event. Refer to the API documentation for the complete schema.