Phone · voice_call
AI phone call
The agent places the call and holds the conversation (5 credits per minute).
- Price
- 5 credits / minute
- ≈ €0.39 · $0.425 · debited by the tool, per result
- Requirements
- No connector
- runs on platform keys
- Human approval
- Yes, by default
- outside-facing write: a human validates
Input
| Field | 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 |
Call this tool
Through the HTTP API, or from the MCP server with the run meta-tool.
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":"…"} })