# WhatsApp

{% embed url="<https://youtu.be/5WPce2Gp-Bw>" %}

To integrate WhatsApp with your Voiceflow project, you will need to follow the same steps as shown in the [quick start](/documentation/getting-started/quickstart.md) section. In short, in the admin panel, you will need to:

1. Create a Client Company
2. Create a Voiceflow Project and associate the Voiceflow project to the Client Company
3. Create a Client Integration and associate the Client Company & Voiceflow Project to the integration.

## WhatsApp Specific Steps

Once you're on the `Create Client Integration` page, and have selected WhatsApp as the social channel, you will have some options to choose from. First of, you will need to choose a provider. There are 2 provider types:

### FlowBridge (Meta API) - :white\_check\_mark: **RECOMMENDED**

This option is the quickest and easiest way to connect. Once selected, you will see a button `Login with Facebook` which will open a popup allowing you to connect your Facebook/Meta account. From here you can choose to create a new or use an existing business asset and WhatsApp business account.&#x20;

You will be prompted to put in a phone number and receive a one-time pin code through SMS or Phone. Once you've validated your number, you can continue on in the embedded login flow until it closes. Once closed, FlowBridge will try to make a connection to WhatsApp. You will need to select which number/whatsapp business asset you want to connect and click on `create` .&#x20;

Once the creation is complete, you're ready to go! Go ahead and open WhatsApp and try to send a message to the number. Your voiceflow flow will now respond as per your configuration.&#x20;

#### Manual method (As part of FlowBridge) - :x: NOT RECOMMENDED

Optionally, you can create your own app on <https://developers.facebook.com> and connect your own API token here. This allows you to have more control over the connection though we do not provide support for this method and is only advised for expert users who require that extra level of control.

If you do end up using this method, you will need to create the integration, and on the view integration page, you will see a button on the top right which allows you to get the Webhook URL and Verification code.

### 360Dialog - :x: NOT RECOMMENDED

For those who already use 360Dialog as their WhatsApp provider, you can simply put in the WhatsApp acces token provided to you by 360Dialog and your Phone Number ID. This then make all queries to 360Dialog rather than the Meta API directly.&#x20;

This method is not recommended nor do we provide support on it. You should should contact 360Dialog support for any issues

## Extra Considerations

* Meta only allows a phone number to be connected to the Business Asset/API **OR** WhatsApp for business app. It can not be connected to both at a time
* Cards must have at least 1 button, and no more then 3
* Buttons (on cards or otherwise) only allow for a total of 20 characters for WhatsApp


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.flowbridge.app/documentation/social-integrations/whatsapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
