Skip to main content
Vous créez votre premier agent à la main ? Le dashboard vous guide dans ce flux précis — créer l’agent, ajouter un numéro, simuler, vérifier — grâce à un assistant guidé. Commencez par le guide de démarrage rapide du dashboard.
Le flux canonique pour « répondre au téléphone avec une IA », depuis votre terminal. Vous allez :
  1. Créer un agent avec un prompt et une voix.
  2. Provisionner (ou apporter) un numéro de téléphone et attribuer l’agent comme gestionnaire des appels entrants.
  3. Appeler le numéro. Observez le journal d’appels, la transcription et l’enregistrement.
Nombre total d’appels API : quatre. Temps total : moins de cinq minutes.

​
1. Créer un agent

Un agent regroupe le prompt, la voix et le niveau de produit qui piloteront l’appel. Consultez Agents pour tous les champs de configuration ; le minimum requis est :
Enregistrez l’id renvoyé : vous en aurez besoin à l’étape 2.
Choisissez spark pour des questions-réponses simples au coût le plus bas, et bolt lorsque la rapidité est primordiale. Passez à storm-base-with-ack lorsque votre prompt nécessite un raisonnement plus approfondi et peut tolérer un acquiescement verbal d’une demi-seconde pendant que le modèle réfléchit. Consultez les niveaux de produit.

​
2. Obtenir un numéro de téléphone

Si vous avez simplement besoin d’un numéro à appeler, provisionnez un numéro de démonstration depuis le pool de ThunderPhone :
La réponse inclut un id et un number au format E.164. Les numéros de démonstration commencent avec le status="provisioning" et deviennent active en quelques secondes : interrogez GET /v1/phone-numbers/{id} pour suivre la transition si nécessaire.
Pour la production, ignorez les numéros de démonstration et apportez vos propres numéros via VoIP. Les numéros de démonstration sont réservés aux appels entrants et leur volume est limité.

​
3. Attribuer l’agent

Associez l’agent de l’étape 1 à la direction entrante du numéro :
C’est tout : le numéro est actif. Vous pouvez également définir outbound_agent_id dans le même PATCH afin que le numéro soit aussi prêt à émettre des appels.

​
4. Prendre un appel

Appelez le numéro depuis votre téléphone. L’agent décroche, se présente conformément à votre prompt, puis la conversation commence. Pendant l’appel, il apparaît dans GET /v1/calls avec status="in_progress". Lorsqu’il se termine, l’enregistrement est mis à jour avec end_reason, duration_seconds, billable_minutes et, à terme, une URL d’enregistrement et une évaluation par IA.

​
5. Examiner les résultats

Récupérez la liste des appels récents :
Récupérez la transcription :
Et l’URL d’enregistrement (signée et de courte durée) :
Si vous vous êtes abonné au webhook telephony.complete, vous recevrez les mêmes données sous forme de POST vers votre serveur ; consultez call.complete.

​
Étapes suivantes

Configuration dynamique par appel

Sélectionnez un agent différent pour chaque appelant selon le numéro de téléphone ou une logique personnalisée dans un webhook.

Ajouter des intégrations d’outils

Permettez à l’agent d’appeler vos API au cours de la conversation.

Recevoir des webhooks call.complete

Transmettez chaque appel terminé à votre pipeline CRM / analytique.

Évaluation par IA et rapports de problèmes

Évaluez automatiquement chaque appel et acheminez ceux signalés pour révision.