AI Calls icon

AI Calls

Activates an agent for calling purpose.

AiCall → Start Call

AI-generated

Overview

This node initiates an AI-powered outbound call by activating an agent with specified call details. It is useful for automating outbound calling tasks such as customer outreach, appointment reminders, or lead follow-ups. Users provide the phone number to call, agent selection, and optional personal details and webhook URL for callback handling.

Use Case Examples

  1. Automatically start a call to a customer with their phone number and name, using a selected AI agent.
  2. Trigger an outbound call with additional custom data fields and receive call status updates via a webhook.

Properties

Name Meaning
Phone The phone number to which the AI call will be placed. This is a required field.
Name The full name of the person being called. This is optional and can be used to personalize the call.
Email The email address of the person being called. This is optional and can be used for additional identification or follow-up.
Agent Name or ID Selects the AI agent who will make the call. This is a required field and can be chosen from a list or specified by ID.
Webhook Url(optional) An optional URL to receive webhook callbacks related to the call status or events.
Additional Fields Allows adding multiple custom key-value pairs to send as dynamic data with the call request.

Output

JSON

  • id - Unique identifier of the initiated call returned by the API.
  • status - Current status of the call (e.g., initiated, in-progress, completed).
  • agent_id - ID of the agent assigned to the call.
  • phone - Phone number to which the call was placed.
  • full_name - Full name provided for the call recipient.
  • email - Email provided for the call recipient.
  • n8n_webhook - Webhook URL provided for call event callbacks.
  • dynamic_data - Additional custom fields sent with the call request.

Dependencies

  • Requires an API key credential for the AI Calls service to authenticate HTTP requests.

Troubleshooting

  • Error due to missing or invalid API key: Ensure the API key credential is correctly configured and valid.
  • Invalid or missing required parameters such as phone number or agent ID: Verify all required fields are provided.
  • HTTP request failures: Check network connectivity and API endpoint availability.
  • Webhook URL issues: Ensure the webhook URL is reachable and correctly configured to handle callbacks.

Links

Discussion