Skip to main content
Les appels sortants vous permettent de fournir un numéro de destination et une configuration d’agent à ThunderPhone afin que l’IA passe l’appel en votre nom. Cas d’utilisation courants :
  • Confirmations de rendez-vous
  • Rappels pour des enquêtes
  • Relances de « deuxième tentative » après un appel manqué
  • Notifications de type répartition
Vous appelez toute une liste ? La fonctionnalité Campagnes du dashboard (/dashboard/campaigns) accepte un CSV de contacts et gère pour vous les plages d’appel tenant compte des fuseaux horaires, la concurrence et la stratégie de nouvelle tentative. Ce guide couvre les appels programmatiques individuels.

​
Prérequis

1

Fournir un numéro VoIP

Les appels sortants nécessitent que vous possédiez le from_number via une connexion VoIP. Les numéros de démonstration sont réservés aux appels entrants. Consultez Utiliser vos propres numéros.
2

Créer un agent

Un prompt orienté appels sortants commence généralement par l’agent qui s’identifie et explique son objectif — « Bonjour, Acme vous appelle pour confirmer votre rendez-vous de demain à 15 h… » Définissez outbound_speak_order sur agent_first (valeur par défaut).
3

Conserver un solde positif

Les appels sortants renvoient 402 Payment Required si le solde est ≤ $0.00. Rechargez votre solde via POST /v1/billing/top-up ou activez le rechargement automatique.

​
Passer un appel avec un agent enregistré

La méthode la plus simple — référencer un agent par son identifiant :
Réponse :
status: "initiated" signifie uniquement que la requête a été acceptée — l’appel n’est pas encore connecté. Interrogez GET /v1/calls/{call_id} pour obtenir le statut en direct (in_progress → completed / failed).

​
Passer un appel avec une configuration intégrée

Si vous souhaitez utiliser un prompt ponctuel qui ne mérite pas d’être enregistré comme agent, passez plutôt config. Sa structure correspond au schéma de réponse du webhook call.incoming :

​
Suivre l’appel

En parallèle, abonnez-vous au webhook telephony.complete — c’est le moyen le plus rapide de savoir qu’un appel est terminé. Si vous ne pouvez pas accepter les webhooks entrants, interrogez GET /v1/calls/{call_id} toutes les quelques secondes ; l’enregistrement inclut end_reason, duration_seconds et l’URL de l’enregistrement une fois l’appel terminé.

​
Modes d’échec à gérer

​
Contrôler le temps d’attente

Les appels sortants qui durent longtemps parce que la personne appelée répond lentement (arborescences IVR, files d’attente) peuvent être plafonnés avec max_hold_seconds :
L’agent raccroche si aucun audio humain n’a été reçu au cours des N dernières secondes. La valeur par défaut est de 900 (15 minutes).

​
Étapes suivantes

Référence des appels sortants

Chaque champ de requête et code d’erreur.

Recevoir call.complete

Transmettez les appels sortants terminés à votre système.

Facturation

Recharge automatique afin que les appels sortants n’échouent jamais en raison du solde.

Tester les agents sortants

Exécutez un test à blanc de votre agent sortant avant la production.