Outbound webhooks: push messages to your CRM

Outbound webhooks send event data to your URL when something happens on WhatsApp, so you can push it into any CRM or automation tool.

Create one

Go to Settings, then Integrations, then Webhooks. In the Outbound section, click Add URL and enter:

• A name
• Your POST URL
• The triggers (see below)
• Payload format: JSON or form-encoded
• An optional signing secret

Triggers

• New contact starts a chat: fires only the first time a new person messages you. Use this to create a lead without duplicates.
• Every incoming message: fires on each inbound message. Use this to log full conversations.

You can pick either or both.

Payload

For JSON, you receive an object with event, contact, and message details, including the message content in message.body. For form format, the same data arrives as flat fields like contact_name, contact_phone, and message_body.

Security

If you set a signing secret, each request includes an X-YVWA-Signature header, an HMAC SHA256 of the body, so your receiver can verify the request is genuine. Every request also sends an X-YVWA-Event header.

Test it

Use the test button on each webhook to send a sample payload and confirm your endpoint receives it.

Related

• Inbound webhooks
• Zoho CRM integration