Overview
This node interacts with the Synthflow AI API to perform various operations related to AI voice agents and calls. Specifically, the 'Make a Call' operation initiates an outbound phone call using a specified Synthflow AI agent. It allows users to specify the agent model ID, recipient phone number, recipient name, and additional optional fields such as custom variables, webhook URLs, greetings, lead email, timezone, and a custom prompt. This node is beneficial for automating outbound calls with AI agents, useful in customer service, sales, or appointment booking scenarios.
Use Case Examples
- Initiate an outbound call to a customer using a Synthflow AI agent with a custom greeting and prompt.
- Send custom variables dynamically to personalize the AI agent's conversation during the call.
- Use a webhook URL to receive call status, transcript, and metadata after the call completes.
Properties
| Name | Meaning |
|---|---|
| Model ID | The ID of the Synthflow AI agent to use for the call. |
| Phone Number | The recipient's phone number in E.164 format. |
| Recipient Name | The name of the call recipient. |
| Additional Fields | Optional fields to customize the call, including custom variables, external webhook URL, greeting message, lead email, lead timezone, and a custom prompt for the AI agent. |
Output
JSON
model_id- The ID of the Synthflow AI agent used for the call.phone- The recipient's phone number.name- The name of the call recipient.custom_variables- Custom key-value variables injected into the call prompt.external_webhook_url- Webhook URL to receive call data post-call.greeting- Custom greeting used by the AI agent.lead_email- Customer's email for appointment booking.lead_timezone- Customer's time zone in IANA format.prompt- Custom prompt used by the AI agent during the call.call_status- Status of the call (e.g., completed, failed).transcript- Transcript of the call conversation.metadata- Additional metadata related to the call.
Dependencies
- Synthflow AI API
- An API key credential for authentication
Troubleshooting
- Ensure the Model ID corresponds to an existing Synthflow AI agent; otherwise, the call initiation will fail.
- Phone number must be in valid E.164 format; invalid format will cause errors.
- Custom JSON fields (like custom variables) must be correctly formatted; invalid JSON will cause errors.
- If the external webhook URL is provided, ensure it is reachable and correctly configured to receive POST requests.
- Common error messages include invalid JSON in custom variables or missing required parameters; verify inputs before execution.
Links
- Synthflow API Documentation - Official API documentation for Synthflow AI, useful for understanding available endpoints and parameters.