Title97/100
Place a phone call
The title clearly communicates the tool’s action and subject. Keep it concise.
Description90/100
Start an outbound AI phone call. At least one of ``system_prompt``, ``llm`` or ``agent_id`` is required. US artificial-voice calls (47 CFR 64.1200(b)(1)) require the AI disclosure. Hail does not verify the lawful basis or the recipient's consent. ``message_type="marketing"`` also requires ``consent_source``. A different ``idempotency_key`` represents a new call. A 4xx response returns no key. Returns the call ID, status, phone numbers and ``idempotency_key``, or an error.
The description explains the capability, when to use it, and what to expect.
Inputs88/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
to
Recipient phone number in E.164 format, such as ``+14155551234``.
Clear enough to supply this argument.
recipient_consent
Attestation that the recipient lawfully consented to this contact. Only ``true`` is accepted.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
system_prompt
Task instructions, added to the call agent's instructions.
Clear enough to supply this argument.
llm
Own model endpoint compatible with OpenAI's chat completions API: ``{base_url, api_key, model}``. Omitted: Hail's bundled model.
Clear enough to supply this argument.
from_
Caller ID: an E.164 workspace number with voice, from ``list_numbers``. Omitted: an active workspace number, else one from the shared pool.
Clear enough to supply this argument.
first_message
Line spoken on pickup. Without it, the agent reacts to the answer or silence.
Clear enough to supply this argument.
language
Spoken language as a supported lowercase ISO 639-1 code, such as ``es``. Omitted: English. An unsupported code returns 422.
Clear enough to supply this argument.
ai_disclosure
Speak an AI notice at the start of the call. ``false`` skips it.
Clear enough to supply this argument.
recording_enabled
Recording for this call, overriding the agent and workspace settings.
Clear enough to supply this argument.
metadata
Free-form JSON object stored on the call record. Keys starting with ``recording_`` are reserved.
Clear enough to supply this argument.
tools
Names of the agent tools allowed on this call. An empty list disables them. Omitted: every tool the workspace's channels support.
Clear enough to supply this argument.
idempotency_key
Retry key. The ``idempotency_key`` from an earlier response refers to that original request instead of starting a new one. Omitted: a new key is generated and returned.
Clear enough to supply this argument.
consent_source
Where or how consent was obtained, such as ``signup form``. Required when ``message_type`` is ``marketing``.
Clear enough to supply this argument.
consent_obtained_at
When consent was obtained, as an ISO 8601 timestamp, if known.
Clear enough to supply this argument.
message_type
``informational`` for transactional or service messages, or ``marketing``.
Clear enough to supply this argument.
agent_id
Saved agent whose settings the call uses, from ``list_agents`` or ``create_agent``. Explicit arguments override its settings.
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"title": "Place a phone call",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Output schema9/100
Declare the result fields and their types in the output schema.
View output schema
{
"type": "object",
"title": "place_call_toolDictOutput",
"additionalProperties": true
}