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

# WhatsApp Voice

WhatsApp Voice adds voice calls to the WhatsApp channel. Calls work in two directions:

* **Outbound calls**: an operator who has taken over a conversation calls the customer from the Conversations page.
* **Inbound calls**: the customer calls the bot's WhatsApp number and the bot answers with a synthesized voice, running its normal flow.

## Requirements

WhatsApp Voice is available only when:

* the account has the **WhatsApp Voice** license;
* the bot is published on the WhatsApp channel and the **WhatsApp Voice** flag is enabled in the channel's **Advanced** settings (**Publish > WhatsApp**). The flag is off by default.

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2F08ky3D4DAT0UNS2gHczd%2Fimage.png?alt=media&amp;token=a5bd8033-93d0-429a-9f52-68926f57371d" alt=""><figcaption></figcaption></figure>

Without the license, the call settings and the call button are hidden. Calls made in the past stay visible in the conversation history.

## Calling a customer

The **Call the customer on WhatsApp** button appears next to **Upload document** when the requirements above are met and an operator has taken over the conversation.

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2FbH7GjNpu89ifobXQrlpY%2Fimage.png?alt=media&amp;token=54788104-9d43-43d9-85a8-d46b8f2c5c85" alt=""><figcaption></figcaption></figure>

### Asking for permission

WhatsApp lets a business call a customer only after the customer has agreed to receive calls from its number. The first time you click the button, the customer receives a call permission request. While the request is pending, the button is disabled. As soon as the customer approves, the button becomes active again and you can start the call.

### During the call

When the customer answers, a timer shows the call duration. You can mute your microphone or hang up at any time.

{% hint style="info" %}
You can talk using your device's microphone or a headset.
{% endhint %}

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2FXL4qjUNLmt15tz2z9Ixe%2Fimage.png?alt=media&amp;token=70418bb3-6a83-4b94-8fcc-691a24f579fd" alt=""><figcaption></figcaption></figure>

A call started by an operator ends only when the operator or the customer hangs up.

### Call messages

Every call attempt adds a message to the conversation with its outcome, for example **Customer busy**, or **Answered** with the call duration.

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2FT4c0JZLBc94FW6mRaQnP%2Fimage.png?alt=media&amp;token=d6b8e9fd-667f-440f-ad07-cbf0dad7e220" alt=""><figcaption></figcaption></figure>

## Setting up an inbound call

When a customer calls a WhatsApp number with voice enabled, the bot starts as if the customer sent a text message.\
The conversation bubbles look different to show the operator that the conversation came from a spoken call.

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2Fw70gtgw4r4Jlj9xnzGjv%2Fimage.png?alt=media&amp;token=37b86c73-ee93-4a91-8c90-72cc09dcd112" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2FJ5SwvYx928g9rVAfgMjA%2Fimage.png?alt=media&amp;token=826e5ad5-2c16-4fae-a89b-4848c5386b98" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2FHMgXSpxON7TtyOoJbA0Z%2Fimage.png?alt=media&amp;token=ebca5664-3e18-4d2d-b6e0-672761be74a2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2Fg7JMUIxmDnITB9pRJ6ls%2Fimage.png?alt=media&amp;token=7bbe528c-75bf-4fb2-8299-e088a5b83874" alt=""><figcaption></figcaption></figure>
