Make a phone call
make_callPlace a real outbound phone call with an AI voice agent and get a call_id. The agent introduces itself as an AI assistant of the business you name, pursues the goal you describe, collects the requested data and hangs up. Destinations: Spain (+34), Mexico (+52), United States and Canada (+1), Colombia (+57), Peru (+51) and United Kingdom (+44). With a prepaid key, at their own price per minute (see get_pricing): Argentina, Belize, Bolivia, Brazil, Chile, Costa Rica, Dominican Republic, Ecuador, El Salvador, Guatemala, Honduras, Nicaragua, Panama, Paraguay, Puerto Rico, Uruguay, Austria, Belgium, France, Germany, Ireland, Italy, Netherlands and Portugal. Calls are short (max 4 minutes). United States and Canada: informational calls only, every day 08:00-21:00 local time of the recipient, with prior_express_consent=true and call_type. Colombia, Peru and United Kingdom: service calls only, Monday to Saturday 09:00-21:00. Set call_purpose: service calls (appointments, reminders, surveys of your own customers, calls the person asked for) run Monday to Saturday 09:00-21:00 local time; commercial calls, only to Spain and Mexico, run Monday to Friday (Spain 09:00-21:00 and only from a 400 number; Mexico 09:00-19:00). In Spain and Mexico, no calls on Sundays or national holidays. You must confirm the recipient asked for or agreed to be contacted. The result is returned by get_call using the call_id. Pass website_url (the business website) and/or business_info so the agent can answer questions about prices, hours or services during the call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Destination phone number in E.164 format, e.g. +34600111222 or +525512345678 | |
| goal | Yes | What the call must achieve, in plain language | |
| collect | No | Data points to collect, e.g. ['preferred date', 'email'] | |
| language | Yes | Language the agent speaks (ISO 639-1) | |
| call_type | No | Required for +1 destinations: informational calls only, never cold prospecting | |
| website_url | No | Website of the business you call for. It is read before the call (up to 10 pages) so the agent can answer questions about prices, hours, services or address | |
| call_purpose | Yes | service: appointments, reminders, surveys of your own customers, or a call the person asked for. commercial: selling or offering something to someone who did not ask for it. It sets the allowed calling hours; commercial calls to Spain require a 400 number | |
| business_info | No | Extra facts about the business the agent may need (prices, hours, services, policies). The agent answers only with this and the website, never invents | |
| business_name | Yes | Name of the business on whose behalf the agent calls | |
| consent_confirmed | Yes | Must be true: the recipient requested or agreed to be contacted | |
| consent_statement | Yes | How and when the recipient requested or agreed to be contacted | |
| prior_express_consent | No | Required true for +1 destinations: the recipient gave prior consent to be called (TCPA) |