Iniciar llamada
AI-generatedSummary
Initiates an outbound voice call using a specific active voice agent from Agents Studio.
Inputs
- agent (required) — The voice agent to execute the call. Can be selected from a list of active voice agents or specified by a 36-character UUID.
- to (required) — Recipient phone number in E.164 format (e.g., +525538808448).
- variables — Dynamic variables from the agent's blueprint ({{...}} placeholders) to personalize the call, auto-loaded based on the selected agent.
- options — Additional settings including an optional Campaign ID (listed per agent) and an optional Idempotency Key to prevent duplicate calls on retry.
Output shape
A single JSON object per item containing the API response from the tool execution.
If the workflow is configured to continue on error, failed calls return an item with an 'error' property instead of throwing an exception.
Examples
Example 1: Initiate a call with a specific agent ID and a dynamic phone number, using variables defined in the agent's prompt.
Agent: By ID (UUID); To: +5255...; Variables: Populated from blueprint.
Example 2: Start a call associated with a specific campaign, using a generated idempotency key to ensure idempotency.
Agent: From list; To: +1...; Options: Campaign ID selected; Idempotency Key: auto-generated or custom.