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

# WhatsApp Business

> Send WhatsApp template messages from agents and workflows in telli

WhatsApp Business lets you send approved WhatsApp template messages from agents and workflows. Use it when a contact expects updates on WhatsApp, when delivery and read status matter, or when a template-based follow-up is better than an SMS.

<Note>
  WhatsApp Business is currently in beta. The integration, agent tool, and workflow action are only visible when WhatsApp is enabled for your account.
</Note>

## Before you start

You need:

* Admin access to the Meta business that owns the WhatsApp Business Account.
* A WhatsApp Business Account and phone number that can be used for the official WhatsApp Business Platform.
* Permission to grant `whatsapp_business_management` and `whatsapp_business_messaging` during Meta setup.
* At least one approved WhatsApp template in Meta before you configure WhatsApp messages in telli.
* A contact with a valid phone number.
* Consent to message the recipient on WhatsApp.

## Connect WhatsApp Business

Connect WhatsApp Business before using WhatsApp messages from agents and workflows. telli uses Meta Embedded Signup to connect your WhatsApp Business Account, register the selected phone number, and load approved templates from Meta.

<Steps>
  <Step title="Open WhatsApp settings">
    In telli, go to **Settings** > **Integrations** > **WhatsApp Business**.
  </Step>

  <Step title="Continue with Facebook">
    Click **Continue with Facebook** and sign in with a Meta account that can administer the WhatsApp Business Account.
  </Step>

  <Step title="Select the business and phone number">
    In the Meta setup dialog, select the Meta business, WhatsApp Business Account, and phone number you want telli to use.
  </Step>

  <Step title="Return to telli">
    Keep the telli tab open while setup finishes. telli saves the connection and registers the selected phone number.
  </Step>

  <Step title="Confirm the phone number is active">
    The WhatsApp Business integration page shows connected phone numbers and their status. The phone number must be **Active** before agents or workflows can send WhatsApp messages.
  </Step>
</Steps>

## Handle two-step verification

If Meta reports that two-step verification is enabled for the selected phone number, telli shows a warning with a link to WhatsApp Manager.

<Steps>
  <Step title="Open WhatsApp Manager">
    Click **Open Manager** from the warning in telli.
  </Step>

  <Step title="Disable two-step verification">
    In WhatsApp Manager, disable two-step verification for the selected phone number.
  </Step>

  <Step title="Retry registration">
    Return to telli and click **Retry registration**. Use the same setup flow instead of starting a new connection.
  </Step>
</Steps>

## Add another phone number

After the first phone number is connected, click **Add phone number** on the WhatsApp Business integration page and repeat Embedded Signup. telli lists all connected WhatsApp phone numbers in the integration detail page.

## Manage templates

WhatsApp templates are managed in Meta. In telli, WhatsApp tool and workflow dialogs include a **Manage templates** link when the connected Meta account is available.

After a template is approved in Meta, select it in an agent tool or workflow action, choose the language, preview the message, and map any template fields to telli data.

## Send WhatsApp from an agent

Use an agent WhatsApp tool when the agent should send a configured template during a live call, such as an appointment reminder, confirmation, or follow-up link.

<Steps>
  <Step title="Open the agent">
    Open the agent you want to edit, then go to the agent tools section in the builder sidebar.
  </Step>

  <Step title="Add a WhatsApp tool">
    Under **WhatsApp**, click **Add WhatsApp tool**.
  </Step>

  <Step title="Add a label">
    Give the message a label, such as `appointment_reminder` or `booking_link`. Labels must start with a letter or underscore and can contain letters, numbers, and underscores.
  </Step>

  <Step title="Choose the sender">
    Select the active WhatsApp Business phone number that should send the message.
  </Step>

  <Step title="Choose a template">
    Select an approved Meta template and language. If the template has fields, preview the message and map each field to a contact value or constant value.
  </Step>

  <Step title="Reference the tool in the prompt">
    Add the WhatsApp tool reference to the prompt, for example `@sendWhatsApp:appointment_reminder`, and explain when the agent should send it.
  </Step>
</Steps>

The agent can only send the WhatsApp templates you configure. This keeps outbound messages predictable and aligned with Meta template approval.

## Send WhatsApp from a workflow

Use the **Send WhatsApp** workflow action when telli should message a contact automatically.

<Steps>
  <Step title="Create or open a workflow">
    Go to **Workflows**, then create a workflow or open an existing draft.
  </Step>

  <Step title="Choose a trigger">
    Select the event that should start the workflow. WhatsApp works especially well after **Call ended** and contact-based triggers.
  </Step>

  <Step title="Add Send WhatsApp">
    Add a **Send WhatsApp** action block after the trigger or after a condition.
  </Step>

  <Step title="Choose the sender">
    Select the active WhatsApp Business phone number that should send the message.
  </Step>

  <Step title="Choose and map a template">
    Select an approved template and language, preview the message, then map any template fields to workflow data or constant values.
  </Step>

  <Step title="Publish and test">
    Publish the workflow, then run it manually against a recent call or contact before relying on automatic sends.
  </Step>
</Steps>

See [Workflows](../platform/workflows) for the full workflow publishing and run-monitoring flow.

## Review WhatsApp activity

WhatsApp conversations appear in **Conversations** alongside calls and SMS when WhatsApp is enabled for your account. Open a conversation to see the message history and delivery state.

WhatsApp activity also appears on the contact timeline, so you can review follow-ups next to the contact's calls and scheduled activity.

Common delivery states are:

| Status      | Meaning                                                     |
| :---------- | :---------------------------------------------------------- |
| `queued`    | telli sent the message to Meta and it is waiting to be sent |
| `sent`      | Meta accepted and sent the message                          |
| `delivered` | WhatsApp reported delivery to the recipient                 |
| `read`      | The recipient read the message                              |
| `failed`    | The send failed before delivery                             |

Inbound replies from known phone numbers are added to the matching WhatsApp conversation. Replies from unknown numbers create a new contact from the sender number.

## Limitations

* Business-initiated WhatsApp messages use approved Meta templates.
* Free-form outbound messages are not available from workflows or agent tools.
* WhatsApp sends require an active WhatsApp Business phone number connected in telli.
* Templates must be managed and approved in Meta before they can be selected in telli.
* WhatsApp Calling templates and dynamic WhatsApp Flow templates are not supported.
* Additional WhatsApp usage charges may apply.

## Remove WhatsApp

You can remove individual WhatsApp phone numbers from the integration page. If you remove the last active phone number, WhatsApp sending becomes unavailable until another phone number is connected.