CallAlternative
Aller au guide
← Appels avec IACallAlternative / Guide des agents
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 Connectez02 Demandez03 Obtenez la réponse
Préparez-vous à la bêta. Les connexions aux agents ne sont disponibles que là où elles sont activées. Créer un compte, connecter un agent ou passer à Max n’active pas les appels de la bêta.
Commencez par la connexion

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…

  1. Ajoutez l’adresse du serveur MCP disponible à votre application d’agent compatible.
  2. Choisissez l’option de connexion ou d’autorisation. Connectez-vous à CallAlternative lorsque cela vous est demandé.
  3. 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’agent
Vé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.

Vérifier l’accès au compte
{
  "name": "account_get_status",
  "arguments": {}
}
Vérifier une destination
{
  "name": "calling_preflight",
  "arguments": {
    "to": "+12025550100"
  }
}
Lister les appels récents
{
  "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. »
  1. Confirmez le destinataire. Votre agent vérifie le numéro et si votre compte peut l’appeler.
  2. Confirmez la demande. Autorisez votre agent à passer cet appel précis.
  3. 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.
Appel d’outil MCP · poser une question
{
  "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.

Avancement de l’appelcall_get
Réponse et résultatcall_get_result

Terminé 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
Vérifier l’avancement de l’appel
{
  "name": "call_get",
  "arguments": {
    "callId": "<returned-call-id>"
  }
}
Lire le résultat de l’appel
{
  "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.

Terminer l’appel confirmé
{
  "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.

Utilisez le type d’action correspondant et l’objectif exact en anglais
Type d’actionObjectif (en anglais)
confirm_reservationConfirm the reservation.
reschedule_reservationReschedule the reservation.
cancel_appointmentCancel 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é.

Appel d’outil MCP · déplacer une réservation
{
  "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.

Référence des outils MCP
OutilFonction
account_get_statusLectureVérifier votre compte, votre offre et votre éligibilité aux appels.
calling_preflightLectureVérifier une destination avant d’appeler. Ne passe aucun appel.
calls_listLectureRetrouver les appels récents et leurs identifiants.
call_getLectureVérifier l’avancement d’un appel.
call_get_resultLectureLire les réponses, transcriptions et résultats d’actions disponibles.
call_create_with_goalPasse un appelPasser un appel pour une question ou une action prise en charge lorsque les appels de la bêta sont activés.
call_hangupTermine un appelTerminer un appel dont l’arrêt a été confirmé.
calling_request_country_accessEnvoie une demandeEnvoyer 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.

30 secondes de connexion10 minutes d’appel
61 secondes de connexion20 minutes d’appel

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édit

Un 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.

Guide des agents IA | CallAlternative