> ## Documentation Index
> Fetch the complete documentation index at: https://agency-swarm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> Learn how to integrate your agents with WhatsApp using Twilio

## Feature Overview

Seamlessly connect your **agents** to **WhatsApp** using **Twilio**, a messaging service that significantly simplifies WhatsApp Sender Business profile setup.

<img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_13.24.37.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=ac6f3bcfc2cb9ceaa3573cd6de590adc" alt="Screenshot 2025-02-17 at 13.24.37.png" width="1098" height="1460" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_13.24.37.png" />

🔒 All chats, conversations and messages are not stored in our database to ensure your or your client’s privacy.

***

## Prerequisites

* A verified **Twilio Account** ([Sign up here](https://login.twilio.com/u/signup)) with a provisioned phone number.
* A verified **Facebook Business account** ([Learn more](https://www.facebook.com/business/help/1710077379203657)) and a verified **WhatsApp Business Portfolio** ([How to verify your WhatsApp Business Account](https://www.facebook.com/business/help/2087193751603668?id=2129163877102343)).

## Creating a WhatsApp Agent via Twilio

<Steps>
  <Step title="Create a WhatsApp Sender via Twilio">
    1. Go to [Twilio Console](https://console.twilio.com/us1/develop/sms/senders/whatsapp-senders) and click on the **'Create New Sender'** button to begin the setup.

           <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_13.40.04.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=d584975f7cea26734ca10b2b2a54aefa" alt="Screenshot 2025-02-17 at 13.40.04.png" width="3640" height="2342" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_13.40.04.png" />

    2. Follow all the necessary steps on **Twilio's** end to complete the integration.
       Twilio has already documented the entire process, so you can refer to their official guides via this link: [https://www.twilio.com/docs/whatsapp/self-sign-up](https://www.twilio.com/docs/whatsapp/self-sign-up)

           <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_13.48.59.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=b1822bcf53de49e302994b2c3c2e3086" alt="Screenshot 2025-02-17 at 13.48.59.png" width="3640" height="2342" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_13.48.59.png" />

    3. Once you have a **verified** WhatsApp Sender with the status set to **Online**, you can proceed to the next steps.
  </Step>

  <Step title="Create a New WhatsApp Integration">
    1. Go to [https://agencii.ai/whatsapp/](https://agencii.ai/whatsapp/) and click on the **'Connect WhatsApp'** button to begin the setup.

    2. Enter your Agent details

           <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_14.51.15.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=4989d85b7e2b8765ea4aaeed38b71e27" alt="Screenshot 2025-02-17 at 14.51.15.png" width="3640" height="2342" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_14.51.15.png" />
  </Step>

  <Step title="Select or Create your Twilio Account">
    1. **Select your Twilio account** from the dashboard.

           <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.27.03.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=3eb9b1186855829d8129a70f3397145c" alt="Screenshot 2025-02-17 at 15.27.03.png" width="3640" height="2342" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.27.03.png" />

    2. To add a new account, copy and paste your **Account SID** and **Auth Token** from the bottom of the Twilio dashboard.

           <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.27.55.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=967be6a608769550d55b8d1f8e5e6aee" alt="Screenshot 2025-02-17 at 15.27.55.png" width="3640" height="2342" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.27.55.png" />

    3. (Optional) If you have a Subaccount, paste the Subaccount SID as well.

    4. Click **Create**
  </Step>

  <Step title="Add your WhatsApp Sender SID">
    1. Find your WhatsApp Sender SID in the Twilio Console under **Messaging** → **Senders** → **WhatsApp Senders**, then copy it from the URL. Example: [https://console.twilio.com/us1/develop/sms/senders/whatsapp-senders/details/XEXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX](https://console.twilio.com/us1/develop/sms/senders/whatsapp-senders/details/XEXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX)

           <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.40.42.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=72594542239581cd0d072a0f6916cc6a" alt="Screenshot 2025-02-17 at 15.40.42.png" width="1934" height="188" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.40.42.png" />

    2. Add whatsapp sender on agencii

           <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.29.05.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=03782939448c61795f4eca94a084264d" alt="Screenshot 2025-02-17 at 15.29.05.png" width="3640" height="2342" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.29.05.png" />
  </Step>

  <Step title="Finalize Integration">
    Copy each webhook integration URL and paste it into the **Twilio WhatsApp Sender configuration profile**, ensuring each URL is placed in the corresponding textbox.

    <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.43.40.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=3c30333ad4eb94cc348408e41f945d1f" alt="Screenshot 2025-02-17 at 15.43.40.png" width="3640" height="2342" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.43.40.png" />

    <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.42.34.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=ea89e6d115bbca6dc9fb606e650e7adc" alt="Screenshot 2025-02-17 at 15.42.34.png" width="3640" height="2342" data-path="images/integrations/whatsapp-integration/Screenshot_2025-02-17_at_15.42.34.png" />
  </Step>
</Steps>

✅ **That's it!** Now you can chat with your Agent via WhatsApp.