> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruby.ad/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Business

> Message customers and manage your WhatsApp Business account with Ruby agents.

![WhatsApp Business](https://mintcdn.com/ruby-ai/g1q-iqu1Jq2F3AFP/branding/integrations/whatsapp.svg?fit=max\&auto=format\&n=g1q-iqu1Jq2F3AFP\&q=85\&s=edbc96325c19f61888f9dca3e92a8a6b)

> [!NOTE]
>
> Meta integrations are in preview. Ruby enables them per workspace while Meta reviews Ruby's app. If a tool or trigger source is missing, use your Ruby support channel to request access.

Let agents message your customers on WhatsApp and manage your WhatsApp Business account.

## Connect

Click **Connect**, then choose:

* **Connect a WhatsApp Business account** for a new number or a number already on the WhatsApp
  Business Platform.
* **Connect a WhatsApp Business app number** to keep using the WhatsApp Business app on your phone
  with the same number.

Follow Meta's steps to pick your business, WhatsApp account and phone number. New numbers must be
registered once: ask an agent to register the number with a six-digit PIN.

## The 24-hour rule

WhatsApp only lets businesses send free-form messages, buttons and lists within 24 hours of the
customer's last message. After that, agents must send an approved message template.
Meta charges for eligible delivered template messages based on their category and the recipient's market; service replies within the customer service window are free. See [WhatsApp Business Platform pricing](https://whatsappbusiness.com/products/platform-pricing/) for current rates and exemptions.

## Tools

| Tool | Description | Asks before running |
| - | - | - |
| List WhatsApp Business accounts | Connected accounts with currency and review status | Runs automatically |
| List WhatsApp phone numbers | Numbers, quality rating, messaging limit, status | Runs automatically |
| List message templates | Templates and their review status | Runs automatically |
| Create message template | Submit a template to Meta for review | Asks once |
| Delete message template | Delete a template in all languages | Asks every time |
| Send text message | Message a customer within 24 hours | Asks per recipient |
| Send media message | Image, video, audio or document from a URL | Asks per recipient |
| Send interactive message | Up to 3 reply buttons, or a list menu of up to 10 options | Asks per recipient |
| Send template message | Approved template, also after 24 hours | Asks every time |
| Mark message as read | Show blue ticks to the customer | Asks once |
| Get business profile | About, description, address, email, websites | Runs automatically |
| Update business profile | Change about, description, address, email, websites | Asks per phone number |
| Register phone number | Register a verified number with a PIN | Asks every time |

When a customer taps a button or picks a list option, a WhatsApp trigger receives their choice as
a new message.

## Asks before running

Every tool listed above is available. This column describes whether the agent asks you before using it.

| Value | Meaning |
| - | - |
| Runs automatically | Reads data. The agent uses it without asking. |
| Asks once | The agent asks the first time. You can approve it for good. |
| Asks per recipient / Page / account | The agent asks for each new recipient, Page or account. You can approve it for good for that one. |
| Asks every time | Publishes, deletes, spends money or messages people outside a conversation. The agent asks each time. |

See [Meta overview](https://docs.ruby.ad/docs/user-documentation/agents/tools/meta) for setup, asset access, and approvals. To automate messages or comments, see [Meta triggers](https://docs.ruby.ad/docs/user-documentation/agents/triggers/meta-triggers.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.