Call a business without a Direct card
call_businessPlace an outbound phone call to a business to ask for information on a named person’s behalf. Use it when find_business_agent returned not_found for a US or Canadian number; when a Direct card exists use send_to_business. It dials a real number and a call cannot be recalled once placed. Requires direct:tasks, human opt-in at https://odilelabs.com/developers#voice and the person’s permission for this call (on_behalf_consent true). Informational calls only: no sales, payments or account access. Calls run Monday to Friday, 9:00 to 17:00 in the business’s local time; outside that window the request is refused and the error includes next_window. A number is not called twice within 24 hours, and each account has a daily call cap. number and callback_number must be callable US or Canadian E.164 numbers, callback_number being the person’s own, never the business’s. message_id is required: reuse it unchanged on every retry so only one call is placed. Returns {task_id, state (queued, completed or failed), status}; read get_call_result for progress and answers. Voice credit costs: get_m2m_network. Example: number='+15615550123', business_name='Harbor Plumbing', caller_name='Ana Diaz', callback_number='+15615550199', need='Do you replace water heaters?', on_behalf_consent=true, message_id='call-8f2'.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"number": "<number>",
"business_name": "<business_name>",
"caller_name": "<caller_name>",
"callback_number": "<callback_number>",
"need": "<need>",
"on_behalf_consent": "<on_behalf_consent>",
"message_id": "<message_id>"
},
"name": "call_business"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| need | Yes | The information the person wants from the business. | |
| number | Yes | The business’s E.164 phone number, e.g. +15615550123. | |
| questions | No | Up to five questions to ask the business. | |
| message_id | Yes | A stable request id; reuse it unchanged on every retry. | |
| caller_name | Yes | The named person who requested this call. | |
| max_seconds | No | Maximum call duration, from 60 to 600 seconds, subject to available credits. | |
| business_name | Yes | The business to call. | |
| callback_number | Yes | That person’s own callback number in E.164, never the business’s. | |
| on_behalf_consent | Yes | True only after that person asked for this call. |