Téléphone · voice_call
Appel téléphonique IA
L'agent appelle et mène la conversation (5 crédits par minute).
- Prix
- 5 crédits / minute
- ≈ 0,39 € · 0,425 $US · débité par l'outil, au résultat
- Prérequis
- Aucun connecteur
- fonctionne sur les clés plateforme
- Validation humaine
- Oui, par défaut
- écriture vers l'extérieur : un humain valide
Entrée
| Champ | Type | Description |
|---|---|---|
| calls | array | Batch: the FULL list of calls to place in one call (preferred whenever there is more than one). Each item takes the same fields as a single call. When provided, the top-level single-call fields are ignored. |
| to | string | Phone number in E.164 format (e.g. +33612345678); for channel=web, the person's name or email. |
| channel | phone | web | "phone" rings the number; "web" returns a call link to send (no phone, no operator). Default: phone when telephony is configured and `to` is a number, else web. |
| message | string | mode=message: the full TTS message. mode=conversation: the OPENING line the AI speaks when the call is answered (introduce yourself + company + reason, 1-2 sentences). |
| mode | message | conversation | "message" = one-way TTS then hang up (default). "conversation" = interactive AI conversation (cold call, qualification, booking). |
| objective | string | REQUIRED for mode=conversation. What the call must achieve (e.g. "Qualifier l'intérêt pour Ezyagents et obtenir un rendez-vous de démo de 30 min cette semaine ou la suivante"). |
| context | string | mode=conversation: everything the AI should know — prospect name, role, company, pain points, prior emails/LinkedIn touches, pricing basics, objection answers. |
| maxTurns | integer | mode=conversation: max AI replies before politely ending the call. Default 15. |
| voice | female_fr_pro | male_fr_warm | female_en_pro | male_en_pro | Polly.Lea | Polly.Mathieu | Polly.Joanna | Polly.Matthew | alice | woman | man | Voice profile: female_fr_pro (default for French), male_fr_warm, female_en_pro, male_en_pro. |
| language | string | BCP-47 language code, e.g. fr-FR, en-US. Default: fr-FR |
| record | boolean | Whether to record the call. Default: false |
Appeler cet outil
Via l'API HTTP, ou depuis le serveur MCP avec le méta-outil run.
curl https://api.ezyagents.fr/gateway/v1/run \
-H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
-d '{"tool":"voice_call","input":{"calls":[],"to":"…","channel":"phone","message":"…"}}'$
run({ "tool": "voice_call", "input": {"calls":[],"to":"…","channel":"phone","message":"…"} })