Aller au contenu
Guides

Un numéro de téléphone pour les appels vocaux OpenClaw

Twilio, Telnyx ou Plivo, le numéro d’origine, le webhook public, et la vérification de configuration

5 min de lecture

La question derrière la recherche du meilleur numéro vocal pour OpenClaw a une réponse simple dans la documentation : le numéro vient de l’un des trois opérateurs que l’extension d’appels vocaux prend en charge, Twilio, Telnyx ou Plivo, et la documentation ne les classe pas. L’extension passe des appels sortants et accepte les entrants, fait tourner la voix en temps réel en duplex intégral et la transcription en continu, et applique des politiques de liste d’autorisation aux appelants. Voici ce qu’elle exige au minimum, pourquoi le webhook doit être public, les deux commandes qui vérifient la configuration, et les règles de session.

Ce qu’exige l’extension

  • Installez l’extension sur la machine qui fait tourner la passerelle, parce qu’elle tourne dans le processus de la passerelle ; une passerelle distante signifie l’installer là-bas.
  • Au minimum dans sa configuration : le fournisseur, ses identifiants, le numéro d’origine, et une URL de webhook joignable publiquement ; avec plusieurs agents, l’agent qui possède les appels.
  • Pour un numéro Twilio entrant, réglez son webhook vocal sur l’URL publique de l’extension avec la méthode POST, et le rappel d’état au niveau du numéro sur la même URL avec un type d’état pour que les états finaux d’appel atteignent l’extension.
Pour Twilio, Telnyx et Plivo, la configuration doit se résoudre en une URL de webhook publique.

Pourquoi public

Les opérateurs livrent les événements d’appel en appelant votre webhook, si bien que si l’URL publique, une URL de tunnel, l’URL Tailscale ou le repli Serve se résout en boucle locale ou en espace d’adresses privé, la configuration échoue plutôt que de démarrer un fournisseur incapable de recevoir les webhooks de l’opérateur. C’est le seul endroit d’OpenClaw où un point d’accès public n’est pas facultatif, et la page de configuration de l’extension a une section sur l’exposition des fournisseurs et les notes de sécurité qui vont avec.

La vérifier

  • La commande de configuration vérifie l’activation de l’extension, les identifiants du fournisseur, l’exposition du webhook, la propriété de l’agent, et qu’un seul mode audio, continu ou temps réel, est actif ; une option JSON imprime la même chose pour les scripts.
  • La commande de test est un essai à blanc par défaut, avec ou sans numéro de destination ; une option de confirmation passe réellement un court appel de notification sortant.
  • Les fournisseurs dans la documentation : une simulation pour le développement sans réseau, Plivo avec son API vocale et sa saisie vocale, le contrôle d’appel de Telnyx, et la voix programmable de Twilio avec les flux de médias.

Les appels vocaux OpenClaw explique ce qu’un appel peut faire une fois connecté, et La synthèse vocale dans OpenClaw la synthèse qui devient la voix sur la ligne.

Des sessions par appelant

La portée de session décide si un appelant est mémorisé : par téléphone garde la mémoire de conversation pour le même appelant, par appel repart de zéro à chaque appel de l’opérateur, ce que la documentation suggère pour les flux d’accueil, de réservation et de serveur vocal où le même numéro peut représenter des personnes différentes, et principal route chaque appel dans la session principale de l’agent, à n’utiliser que quand ce contexte partagé est voulu. OpenClaw et Tailscale est la façon habituelle de donner à la passerelle une adresse HTTPS publique pour le webhook sans ouvrir le reste.

Sur Diali

Sur Diali, le canal vocal fait partie de la liste des canaux à connecter : le compte chez l’opérateur et le numéro sont à vous, l’extension, l’exposition du webhook et la passerelle sont à nous. La voix sur Diali est la page du canal et OpenClaw hébergé sur Diali l’assistant.

  • Twilio, Telnyx ou Plivo ; la documentation n’en choisit pas un.
  • Le webhook doit être public, sinon la configuration refuse de démarrer.
  • Par téléphone mémorise un appelant ; par appel oublie exprès.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.