Skip to main content
WhatsApp Relay lets a Ringg AI agent answer customers on a WhatsApp Business number that stays in your own Meta account. Ringg never holds your WhatsApp access token and never calls Meta for you. Instead, your WhatsApp service sits in the middle:
  • Customer messages: you forward each one to Ringg.
  • Replies: Ringg answers with a ready-to-send WhatsApp message on your webhook.
  • Sending: your service posts that reply to Meta, then tells Ringg whether it went out.
Your human agents can work the same chats. When one of them steps away, you hand the conversation to the AI agent with the history so far, and it carries on from there.
If Ringg can hold your WhatsApp Business account instead, the standard WhatsApp setup is simpler: connect the account in the dashboard and Ringg talks to Meta directly. Relay is for businesses that need the account, the token and the Meta traffic to stay with them.

​
How it works

  1. Forward: a customer messages your number. Meta notifies your service, and your service forwards the message to Ringg’s /inbound endpoint, signed with your keys.
  2. Reply: Ringg’s agent reads the whole conversation and writes a reply. Ringg posts it to your webhook as a message.outbound event, in a format you can send to Meta unchanged.
  3. Send and acknowledge: your service sends the reply to Meta, then reports the result to Ringg’s /ack endpoint. Ringg uses this to keep its record of the conversation true to what the customer actually saw.
Ringg can also open a conversation with an approved template, and close one with a final message. See Integration guide.

​
In this section

What's supported

Message types, conversation features and limits, and what is not supported yet.

What we need from you

The details to share for setup, and what your WhatsApp service has to do.

What Ringg provides

Credentials, the AI agent, delivery guarantees, and dashboard visibility.

Integration guide

Authentication, every endpoint, the events Ringg sends you, and error codes.

Hand over from a human agent

Pass a conversation from your agent to the AI agent, and take it back.

Troubleshooting

Symptoms, causes and fixes, and what to send us when you need help.

FAQ

Short answers to the questions integrators ask most.

​
Key terms