Overview
This node integrates with the Callin.io service to start an outbound call by activating a specified agent. It is useful in scenarios where you want to programmatically initiate calls through Callin.io, such as automating customer support callbacks, telemarketing campaigns, or any workflow requiring outbound phone calls managed by agents.
For example, you can use this node to trigger a call to a customer's phone number, assign it to a specific agent, and optionally provide additional data or a webhook URL for callback notifications.
Properties
| Name | Meaning |
|---|---|
| Phone | The phone number to call. |
| Name | The full name of the person being called (optional). |
| The email address of the person being called (optional). | |
| Agent Name or ID | Select an outbound agent from a list or specify an agent ID to handle the call. |
| Webhook Url(optional) | Optional webhook URL to receive call status or event notifications. |
| Additional Fields | Add custom key-value pairs as extra data to send along with the call request. |
Output
The node outputs a JSON object representing the response from the Callin.io API after attempting to start the call. This typically includes details about the initiated call, such as its status, identifiers, or error messages if any.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Callin.io API.
- The environment variable
BASE_URLmust be set to the base URL of the Callin.io API endpoint. - The node makes HTTP requests to Callin.io endpoints
/userAgents(to load agents) and/webhook(to start the call).
Troubleshooting
- Common issues:
- Missing or invalid API key will cause authentication failures.
- Incorrect or missing
BASE_URLenvironment variable will result in request errors. - Providing an invalid agent ID or phone number may cause the API to reject the call initiation.
- Error messages:
- Authorization errors indicate problems with the API key; verify the key and permissions.
- Network or timeout errors suggest connectivity issues or incorrect API URLs.
- Validation errors from the API usually mean required fields are missing or malformed; ensure all required properties are correctly set.
Links and References
- Callin.io API Documentation (hypothetical link for reference)
- n8n Expressions Documentation – for using expressions in property values like Agent ID