WhatsApp

Receive WhatsApp messages

View as MarkdownOpen in Claude

Inbound messages sent to your WhatsApp business number are automatically received and logged by SignalWire. You can view them in your Dashboard or retrieve them through the Messaging API, alongside the delivery status of the messages you send.

WhatsApp on SignalWire is in early-access alpha. Inbound messages from customers are automatically received and logged by SignalWire.

Message logs

Inbound messages and the delivery status of the messages you send are available through the message logs endpoint, GET /api/messaging/logs, which returns history for both inbound and outbound messages. WhatsApp messages are identified by kind: whatsapp. See the Message Logs reference for the full response schema.

Delivery status

The status field updates as an outbound message progresses:

StatusMeaning
sentSignalWire has dispatched the message to Meta.
deliveredThe recipient’s device has received the message.
readThe recipient has opened the message.

You can also view message history graphically in your SignalWire Dashboard under Logs → Messaging.

To be notified of each status change as it happens, set status_callback when sending a message. SignalWire then POSTs the following payload to your URL at each state change:

Replying to inbound messages

When a customer messages you first, you can reply with any message type for 24 hours from their last inbound message. Outside that window, you must use an approved template. See Messaging rules for details.

Next steps