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

# Voix WhatsApp

> Comment fonctionne l'appel vocal WhatsApp sur la plateforme — configuration et UX produit

<Warning>
  Les appels WhatsApp sortants sont une capacité Beta soumise à activation par
  espace de travail, disponible uniquement dans les régions prises en charge, et
  nécessitent l'autorisation explicite du destinataire. Les campagnes
  multicanales demandent cette autorisation automatiquement, affichent le lead
  comme **Awaiting permission**, et n'appellent qu'une fois l'autorisation
  accordée. Un refus ou une expiration met fin à cette tentative de remise.
</Warning>

Le même assistant qui répond aux appels téléphoniques peut aussi répondre aux appels WhatsApp. Les appels de campagne reçoivent les informations du lead et les variables mappées configurées dans la campagne.

Configuration produit (identifiants, webhook, options, modèles) : **Settings → Channels → WhatsApp** — voir [WhatsApp (Texte + Voix)](/fr/channels/whatsapp).

Le texte et la voix utilisent la même connexion WhatsApp. Pour une configuration manuelle, abonnez l'URL de webhook affichée aux **messages** et aux **calls**.

## Ce que voit l'utilisateur final

1. Le client appuie sur **appeler** sur votre numéro WhatsApp Business (ou décroche un appel sortant).
2. Interface d'appel WhatsApp standard (sonnerie → connecté).
3. Votre assistant parle comme lors d'un appel téléphonique.
4. Après le raccrochage, l'appel apparaît dans l'Historique avec son analyse et son utilisation.

Le client ne dispose d'aucun numéroteur WhatsApp intégré à l'application : il reste dans WhatsApp.

## Ce que voient les administrateurs de l'espace de travail (produit)

**Settings → Channels → WhatsApp** :

1. Connectez les identifiants Meta (ID du numéro de téléphone + jeton System User permanent + secret d'application + jeton de vérification + ID WABA), ou utilisez **Connect with Meta**.
2. Attribuez un assistant.
3. Copiez l'URL affichée pour les messages, les appels et les mises à jour d'état des modèles.
4. Activez les options d'appel entrant / sortant (le sortant dépend de la région et de l'autorisation utilisateur Meta).
5. Facultatif : passez un appel WhatsApp de test depuis le même panneau.

API publique : `POST /api/v1/calls/whatsapp-outbound`.

## Applications et comptes nécessaires

1. Compte [Meta Developer](https://developers.facebook.com/).
2. Compte WhatsApp Business (WABA) avec un numéro de téléphone professionnel.
3. **Voice calling** activé sur ce numéro (Cloud API v23/v24).
4. Application Meta avec le produit WhatsApp + jeton d'accès **System User** permanent (ou Embedded Signup).

## Configuration Meta (étape par étape)

1. Créez / ouvrez une application Meta → ajoutez **WhatsApp**.
2. Sous WhatsApp → API Setup, notez :
   * **Phone number ID**
   * **Access token** (utilisez un jeton System User longue durée en production)
3. WhatsApp → Configuration → Webhooks :
   * URL de rappel : copiez l'URL propre au connecteur depuis Paramètres
   * Jeton de vérification : utilisez la valeur affichée pour le connecteur
   * Abonnez-vous au moins à **`calls`** (et à **`messages`** pour le texte)
   * Utilisez la version d'API **v23.0** ou **v24.0** de façon cohérente
4. Activez les autorisations d'appel :
   * Entrant : configurez les horaires d'appel disponibles (appels lancés par l'utilisateur)
   * Sortant : uniquement dans les régions prises en charge, avec autorisation explicite de l'utilisateur

## Passer un appel sortant

Lancez un appel WhatsApp sortant depuis le panneau de l'expéditeur, via `POST /api/v1/calls/whatsapp-outbound` ou avec l'outil MCP `start_whatsapp_outbound_call`. Les appels initiés par une entreprise ne sont disponibles que dans les régions éligibles et après l'autorisation explicite du destinataire.

## Voir aussi

* [WhatsApp (Texte + Voix)](/fr/channels/whatsapp)
* [Canaux de messagerie](/fr/channels/messaging)
* [Numéros de téléphone](/fr/telephony/phone-numbers)
* [Campagnes](/fr/campaigns/overview)