> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/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

Les **appels vocaux** WhatsApp utilisent le connecteur voix WhatsApp de la plateforme. Le même agent vocal qui répond aux appels téléphoniques répond aussi aux appels WhatsApp.

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

Le chat texte utilise le chemin Cloud API sur le même connecteur (champ webhook `messages`). La voix utilise la même URL de webhook, avec le champ `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 sur une ligne téléphonique (STT/LLM/TTS pendant la session d'appel).
4. Après raccroché : le même parcours Historique / analyse / crédits que pour les autres appels vocaux.

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)

**Paramètres → Canaux → 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 du webhook pour Meta (`messages` + `calls` + statut 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.

Route du webhook : `https://app.famulor.io/api/webhooks/messaging/whatsapp/{connectorId}`.

API sortante : `POST /api/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. **Appels vocaux** activés 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).
5. Infrastructure voix de la plateforme avec les appels WhatsApp activés (configurée par l'opérateur).

## Configuration Meta (étape par étape)

1. Créez / ouvrez une application Meta → ajoutez **WhatsApp**.
2. Sous WhatsApp → API Setup, notez :
   * **Phone number ID**
   * **Jeton d'accès** (utilisez un jeton System User longue durée en production)
3. WhatsApp → Configuration → Webhooks :
   * URL de rappel : `https://app.famulor.io/api/webhooks/messaging/whatsapp/{connectorId}` (ou le webhook WhatsApp de la plateforme)
   * Jeton de vérification : le jeton de vérification du connecteur (ou le jeton de vérification de la plateforme pour le callback au niveau de l'application)
   * 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

## Flux d'appel (produit)

### Entrant

1. L'utilisateur appelle votre numéro WhatsApp Business.
2. Meta envoie un webhook **call connect** avec offre SDP + ID d'appel.
3. La plateforme accepte l'appel, déploie l'agent vocal et relie l'audio à la session d'appel.
4. L'assistant fonctionne comme lors d'un appel téléphonique classique.

### Sortant

1. L'espace de travail (interface, API ou MCP) démarre un appel WhatsApp sortant vers le numéro de l'utilisateur.
2. Meta appelle l'utilisateur et envoie un webhook **call connect** avec réponse SDP.
3. La plateforme connecte immédiatement le média (un délai peut provoquer un silence ou une coupure).
4. Au raccroché : Meta envoie **call terminate** → la plateforme met fin à la session.

## Voir aussi

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