Sur cette page
GUIDE DES AGENTS IA Bêta publique à venir
Connectez votre
agent IA.
Vous posez la question. Votre agent prépare la demande. CallAlternative passe l’appel et vous rapporte la réponse.
01 / CONFIGURATION
Connectez votre agent
CallAlternative utilise MCP : un moyen commun permettant à une application d’IA de découvrir des outils et de leur demander une tâche. Votre application doit prendre en charge MCP via Streamable HTTP avec autorisation OAuth.
GPT, Claude et Gemini illustrent les parcours avec des agents compatibles. La configuration dépend de votre application ; cette version n’inclut pas de connecteurs natifs pour les applications de chat.
Avant de commencer
- Un abonnement Max actif et un compte dont l’adresse e-mail est vérifiée.
- Du crédit d’appel et une destination que votre compte peut appeler.
- Une application d’agent compatible dont la connexion est configurée.
Basic et Basic Plus n’incluent pas l’accès aux agents IA ni à MCP.
Vérification de la disponibilité de la connexion…
- Ajoutez l’adresse du serveur MCP disponible à votre application d’agent compatible.
- Choisissez l’option de connexion ou d’autorisation. Connectez-vous à CallAlternative lorsque cela vous est demandé.
- Vérifiez l’application, l’adresse de retour et les autorisations. Sélectionnez Connecter pour revenir automatiquement à votre agent.
Vous n’avez jamais besoin de copier des jetons d’accès. Votre agent gère ses propres identifiants de connexion après votre autorisation. Gérez ou déconnectez les applications dans Agents connectés.
Ne collez jamais d’identifiants dans des instructions ou des URL et n’extrayez pas de jetons de votre navigateur. N’autorisez que les applications et adresses de retour que vous reconnaissez.
Choisir et modifier les autorisations
Les connexions sont en lecture seule par défaut. Si votre agent demande l’accès aux appels, vous pouvez sélectionner Autoriser les appels avant de vous connecter. Dans Agents connectés, désactivez les appels immédiatement tout en conservant la lecture. Pour les autoriser à nouveau, reconnectez-vous depuis votre agent, demandez calls:write et approuvez l’accès. Les appels en cours continuent après le retrait de cette autorisation.
Gérer les autorisations de l’agentVérifiez la connexion sans passer d’appel
Demandez d’abord à votre application de découvrir les outils disponibles sur le serveur (tools/list dans MCP). Vérifiez ensuite votre compte et la destination. Ces exemples sont des appels d’outils MCP, pas des paramètres de connexion.
{
"name": "account_get_status",
"arguments": {}
}{
"name": "calling_preflight",
"arguments": {
"to": "+12025550100"
}
}{
"name": "calls_list",
"arguments": {
"limit": 10
}
}Le numéro d’exemple est fictif. Remplacez-le par le destinataire prévu et autorisé. Une vérification de connexion réussie n’active pas les appels de la bêta.
02 / DEMANDE
Commencez par une question
Commencez par une demande simple. Par exemple :
« Appelle le restaurant et demande s’il est ouvert aujourd’hui. »
- Confirmez le destinataire. Votre agent vérifie le numéro et si votre compte peut l’appeler.
- Confirmez la demande. Autorisez votre agent à passer cet appel précis.
- Conservez l’identifiant de l’appel. Lorsque les appels sont activés, votre agent envoie la demande et utilise l’identifiant reçu pour en suivre l’avancement.
{
"name": "call_create_with_goal",
"arguments": {
"destination": "+12025550100",
"goal": "Are you open today?",
"maxDurationSeconds": 30,
"idempotencyKey": "<unique-operation-UUID>"
}
}Ceci est un exemple ; rien ne s’exécute sur cette page. Remplacez le numéro fictif et la clé d’exemple avant de l’utiliser dans votre agent configuré.
Limites des questions et nouvelles tentatives sûres
Utilisez une seule question en anglais, de 220 caractères ASCII maximum. L’agent d’appel actuel parle anglais (en-US). La durée est un plafond demandé, pas un arrêt strict à un instant exact ; votre solde ou votre éligibilité peuvent la réduire.
Générez un UUID unique pour chaque nouvelle opération. Si une demande expire sans résultat connu, réessayez avec la même clé d’idempotence et des arguments identiques. Ne créez pas de nouvelle clé et ne rappelez pas automatiquement.
Une réponse en attente ne prouve pas que le téléphone a sonné. Consultez l’identifiant reçu pour suivre l’avancement et les résultats.
03 / OBTENEZ LA RÉPONSE
Découvrez ce qui s’est passé
Ouvrez Appels pour consulter les réponses capturées et les transcriptions disponibles. Votre agent peut les récupérer via MCP avec le même identifiant d’appel.
call_getcall_get_resultTerminé signifie que l’appel a pris fin. Consultez la réponse capturée et le résultat de l’action pour savoir si quelqu’un a répondu et si votre demande a abouti.
Consulter les résultats dans votre agent
{
"name": "call_get",
"arguments": {
"callId": "<returned-call-id>"
}
}{
"name": "call_get_result",
"arguments": {
"callId": "<returned-call-id>"
}
}answerCapture.status peut être pending, captured, no_answer ou unavailable. Si le résultat est en attente, consultez le même identifiant plus tard ou rechargez Appels.
Pour les actions, consultez result.outcome.status: confirmed, not_completed, needs_user_input ou unknown. Les résultats signalés par le fournisseur utilisent source: provider_report et independentlyVerified: false. Une citation capturée peut coexister avec un résultat inconnu.
Si le résultat n’est pas clair, demandez à l’utilisateur quoi faire ensuite. Ne rappelez pas automatiquement.
Terminer un appel à la demande de l’utilisateur
Confirmez quel appel doit être arrêté, puis utilisez son identifiant et une clé d’opération distincte.
{
"name": "call_hangup",
"arguments": {
"callId": "<returned-call-id>",
"idempotencyKey": "<separate-operation-UUID>"
}
}Une action simple, aussi
Demandez à votre agent de confirmer ou déplacer une réservation, ou d’annuler un rendez-vous. Il doit recueillir les informations manquantes et obtenir votre accord avant d’appeler.
« Appelle le salon et annule le rendez-vous d’Alex Rivera. »
Actions prises en charge et informations requises
Les demandes en langage naturel peuvent être brèves. L’action envoyée exige actuellement à la fois la référence et le nom du client. Votre agent doit les demander s’ils manquent ; un nom seul ne suffit pas pour l’action structurée.
| Type d’action | Objectif (en anglais) |
|---|---|
confirm_reservation | Confirm the reservation. |
reschedule_reservation | Reschedule the reservation. |
cancel_appointment | Cancel the appointment. |
Seules les demandes sans frais et conformes aux détails approuvés sont prises en charge. N’autorisez ni frais, ni paiements, ni solutions de remplacement non approuvées, ni conditions supplémentaires. Un changement de réservation exige une date future, une heure et un fuseau horaire sans ambiguïté.
{
"name": "call_create_with_goal",
"arguments": {
"destination": "+12025550100",
"goal": "Reschedule the reservation.",
"maxDurationSeconds": 120,
"idempotencyKey": "<unique-operation-UUID>",
"action": {
"type": "reschedule_reservation",
"userAuthorized": true,
"target": {
"reference": "<reservation-reference>",
"customerName": "Alex Rivera"
},
"requestedSlot": {
"localDate": "2027-04-20",
"localTime": "19:00",
"timeZone": "America/New_York"
}
}
}
}Remplacez les valeurs d’exemple et vérifiez que la date indiquée est toujours à venir. Définissez userAuthorized uniquement après l’accord de l’utilisateur pour cette action précise. Le champ facultatif callerName modifie la présentation orale (par défaut, le prénom du compte est utilisé) ; il ne remplace pas le nom du client de l’action.
Les outils de votre agent
Découvrez les outils disponibles dans votre connexion avant de les utiliser. Leur disponibilité dépend de votre compte et des fonctions de la bêta activées.
| Outil | Fonction |
|---|---|
account_get_statusLecture | Vérifier votre compte, votre offre et votre éligibilité aux appels. |
calling_preflightLecture | Vérifier une destination avant d’appeler. Ne passe aucun appel. |
calls_listLecture | Retrouver les appels récents et leurs identifiants. |
call_getLecture | Vérifier l’avancement d’un appel. |
call_get_resultLecture | Lire les réponses, transcriptions et résultats d’actions disponibles. |
call_create_with_goalPasse un appel | Passer un appel pour une question ou une action prise en charge lorsque les appels de la bêta sont activés. |
call_hangupTermine un appel | Terminer un appel dont l’arrêt a été confirmé. |
calling_request_country_accessEnvoie une demande | Envoyer une demande d’accès à un pays. N’accorde aucun accès et ne passe aucun appel. |
Un même solde. Un tarif différent.
Les appels avec IA utilisent votre solde partagé de minutes d’appel. Nous arrondissons la durée connectée à la minute supérieure, puis déduisons 10 minutes d’appel par minute. Les appels depuis le navigateur conservent leur tarif habituel.
Un appel sans réponse et sans connexion ne consomme aucune minute. Une connexion à la messagerie vocale compte comme durée connectée. L’accès aux agents IA nécessite Max.
Consultez votre offre et votre créditUn peu d’aide en cas de difficulté
Mon offre n’est pas éligible ou mon crédit est épuisé
L’accès aux agents IA nécessite Max, une adresse e-mail vérifiée et du crédit d’appel. Consultez votre compte dans Facturation. Changer d’offre n’active pas la bêta à venir.
La connexion indique un accès non autorisé ou expiré
Relancez la connexion depuis votre application d’agent et connectez-vous pour autoriser l’accès. Vous pouvez déconnecter les anciennes applications dans Agents connectés. Ne partagez jamais d’identifiants dans le chat.
Je ne trouve pas un outil
Actualisez la découverte des outils dans votre application configurée. Vérifiez qu’elle prend en charge MCP via Streamable HTTP avec autorisation OAuth. L’outil peut ne pas être activé pour votre compte ou la bêta actuelle.
Un autre appel est actif ou une demande a expiré
Consultez l’appel existant et attendez sa fin. Ne réessayez une opération incertaine qu’avec sa clé d’origine et des arguments identiques. Une nouvelle clé peut créer un autre appel.
L’appel est terminé, mais la réponse est encore en attente
Consultez le même identifiant d’appel avec call_get_result, ou rechargez Appels. Certaines réponses ou transcriptions peuvent être indisponibles. Ne passez pas automatiquement un autre appel.