Actions21
Overview
This node integrates with the RetellAI API to perform various operations related to communication and AI services. Specifically, for the Call resource with the Create Phone Call operation, it allows users to initiate a phone call between two specified phone numbers. This is useful in scenarios such as automated outbound calling, customer support callbacks, or any workflow requiring programmatic phone call initiation.
Practical examples include:
- Automatically calling a customer after they submit a form.
- Initiating calls to team members based on certain triggers.
- Integrating voice-based notifications into business processes.
Properties
| Name | Meaning |
|---|---|
| From Number | The phone number you own, formatted in E.164 international format (e.g., +14157774444). |
| To Number | The destination phone number you want to call, also in E.164 format (e.g., +14157774445). |
Output
The node outputs JSON data representing the result of the phone call creation request to the RetellAI API. This typically includes details about the initiated call such as call ID, status, timestamps, or error messages if the call could not be created.
If the node supports binary data output (not explicitly shown here), it would likely relate to audio recordings or call metadata, but this is not indicated in the provided code snippet.
Dependencies
- Requires an active connection to the RetellAI API endpoint (
https://api.retellai.com). - Needs a valid API authentication token configured in n8n credentials (referred generically as "an API key credential").
- The node uses helper functions from bundled dependencies to handle different resources and operations, including validation of credentials.
Troubleshooting
Common issues:
- Invalid phone number format: Ensure both "From Number" and "To Number" are in correct E.164 format.
- Authentication errors: Verify that the API key credential is correctly set up and has necessary permissions.
- Network or API downtime: Check connectivity to
api.retellai.com.
Error messages:
- Errors returned by the API will be included in the output JSON under an error field.
- If the node is set to continue on failure, errors for individual items will be captured without stopping the entire workflow.
- Common resolution steps include verifying input parameters, checking API credentials, and reviewing API usage limits.
Links and References
- E.164 Phone Number Format
- RetellAI official API documentation (refer to your RetellAI account or developer portal for exact URLs)