Skip to main content
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). 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.
  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