> For the complete documentation index, see [llms.txt](https://docs.ixhello.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ixhello.com/ixhc/whatsapp-enablement-for-assistants.md).

# WhatsApp Enablement for Assistants

### Objective

Enable WhatsApp messaging capability for AI Assistants in iX HC by configuring Twilio phone numbers for WhatsApp communication, ensuring secure, compliant, and reliable customer interactions across the WhatsApp channel in accordance with AppSec requirements.

### Pre-requisites <a href="#toc46444536" id="toc46444536"></a>

1. **An active Twilio number**&#x20;

   You should have an active WhatsApp Enabled Twilio Phone Number. To create a WhatsApp Twilio Number, use this [document](/ixhc/connections/twilio-whatsapp-enablement-guide.md)
2. **An iX Hello Account**

   For steps to create an account, follow the steps [here](/ixhc/general/ix-hello-create-account-original.md)

### **Setup connection to WhatsApp in iX Hello** <a href="#hlk56341408" id="hlk56341408"></a>

* Login to the iX Hello portal at <https://bots.ixhello.com>
* Click on the Studio Mode link at the top of the page:

<figure><img src="/files/ViYfaVWm6lKEEwRxDxTr" alt=""><figcaption></figcaption></figure>

* Navigate to **Custom Apps**.
* Select the bot application you want to configure.

<figure><img src="/files/3t8r7oobJBBmiy21KC7L" alt=""><figcaption></figcaption></figure>

* Open the **Publish** section.
* Click **Edit**.

<figure><img src="/files/O8VKMCZDyBq6cTEOwsmo" alt=""><figcaption></figcaption></figure>

* Locate the **WhatsApp Configure Numbers** toggle.
* Enable the toggle.

<figure><img src="/files/efF7j8aZh4SkmUvW1ClZ" alt=""><figcaption></figcaption></figure>

Once enabled:

* The system fetches all WhatsApp-enabled phone numbers associated with the connected Twilio account.
* Available phone numbers are displayed in the configuration screen.
* Select the desired phone number and save the configuration.

Now, you can start communication with the bot from your phone on WhatsApp or Login to the <https://web.whatsapp.com/>&#x20;

WhatsApp web is a browser-based computer extension of the mobile WhatsApp app. It lets you send and receive messages, share files, and view chats on a computer screen by mirroring your phone's account

<figure><img src="/files/JCPkh0qpks1Vseywxo6t" alt="" width="563"><figcaption></figcaption></figure>

When multiple phone numbers are available, a bot can claim only one phone number at a time. Once a phone number is assigned to a bot, it is no longer available for selection by other bots. The remaining unassigned phone numbers continue to be visible in the available pool and can be claimed by other bots as needed. For example, if there are 10 available phone numbers and one bot claims a number, the other 9 phone numbers remain available for assignment.

#### Connect the WhatsApp Number

After selecting a number, WhatsApp activation may require linking the number through a QR code verification process.

1. Open the WhatsApp setup screen.
2. Scan the displayed QR code using the required device.
3. No additional application installation is required during this step.
4. Complete the verification process to activate the connection.

{% hint style="info" %}
**Note:** For QR-code-based setup, simply scan the QR code when prompted. Downloading an additional application is not required unless specified by the setup instructions.
{% endhint %}

Add the Twilio number to the whatsapp contacts. Once added the type in the Join Code.

Once you provide the join code, you will see a welcome msg from the added number.

<figure><img src="/files/eanm2Plm6xWAmcoKFHVN" alt="" width="563"><figcaption></figcaption></figure>

Once you are verified you can start the conversation with the assistant using the provided FAQ's.

You can add more FAQ's or the content in the basic mode, under training tab.

The conversation done with the bot on WhatsApp is stored in iX Hello for any assistant, similar to conversation history on other channels.

<figure><img src="/files/N23DFErYJ4vU5QQL6uKp" alt="" width="563"><figcaption></figcaption></figure>

Using these FAQ's, you can query the bot, and you receive the responses.&#x20;

**WhatsApp Conversation:**

<figure><img src="/files/HCmVS61NSYe7ltJ3HnVT" alt="" width="563"><figcaption></figcaption></figure>

**Basic Mode Conversation.**

<figure><img src="/files/Ky7HLTHTY32xf0zu0stZ" alt="" width="563"><figcaption></figcaption></figure>

**Studio Mode Conversation:**

<figure><img src="/files/TlE6Fe6vA8pgLEn4HEUd" alt="" width="375"><figcaption></figcaption></figure>

#### Limitations of using a meta sandbox account

When using a sandbox account, the following limitations apply:

* **Joint Code Requirement**: Users must use the provided joint code to connect and enable messaging on the sandbox number. This additional setup step is required for testing and validation purposes.
* **Single Phone Number per Environment**: A sandbox environment supports only **one phone number**. Unlike production setups where multiple phone numbers can be managed, sandbox environments are limited to a single number for testing and development activities.

These limitations should be considered when planning and validating WhatsApp messaging workflows in a sandbox environment.

**What is Join Code**

The **join code** (sometimes called a *sandbox join code*) is a unique code provided by Twilio WhatsApp Sandbox that allows a user's WhatsApp number to connect to the sandbox environment before testing can begin.

**Purpose of the Join Code**

When using a **Twilio WhatsApp Sandbox**:

* Users cannot directly start messaging the sandbox number.
* They must first send a specific **join code** (secret keyword) to the sandbox WhatsApp number.
* This action registers or "joins" their WhatsApp number to the sandbox environment.
* Once joined, they can start conversations with the AI Assistant through the sandbox number.

{% hint style="info" %}
Note: This step is only required for sandbox testing and is not required in production environments.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.ixhello.com/ixhc/whatsapp-enablement-for-assistants.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.