Actions21
Overview
The node integrates with the RetellAI API to manage phone numbers, specifically allowing updates to existing phone number records. It is useful in scenarios where you need to programmatically modify attributes of a phone number such as assigning or changing agents responsible for inbound or outbound calls, or updating the phone number's nickname.
Practical examples include:
- Reassigning an inbound call agent when team responsibilities change.
- Disabling inbound or outbound call handling by setting the respective agent to null.
- Updating the nickname of a phone number to better reflect its purpose or owner.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The phone number to update, specified in E.164 format (e.g., +14157774444). |
| Update Fields | Collection of fields to update on the phone number: |
| Inbound Agent | New agent ID to handle inbound calls, or null to disable inbound calls. |
| Outbound Agent | New agent ID to handle outbound calls, or null to disable outbound calls without override. |
| Nickname | New nickname for the phone number. |
Output
The node outputs JSON data representing the updated phone number object returned from the RetellAI API. This typically includes the phone number details reflecting the changes made, such as updated agent assignments and nickname.
No binary data output is indicated.
Dependencies
- Requires an active connection to the RetellAI API.
- Needs an API authentication token configured in the node credentials to authorize requests.
- The base URL for API requests is
https://api.retellai.com. - The node expects the API to accept and return JSON-formatted data.
Troubleshooting
- Invalid Phone Number Format: Ensure the phone number is provided in correct E.164 format (e.g., +14157774444). Incorrect formatting may cause API errors.
- Unauthorized Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Agent ID Issues: When specifying inbound or outbound agent IDs, ensure they exist and are valid within the RetellAI system. Using invalid or non-existent agent IDs may result in errors.
- Null Values: To disable inbound or outbound call handling, explicitly set the corresponding agent field to null. Omitting these fields will leave them unchanged.
- API Rate Limits or Downtime: If requests fail unexpectedly, check for API rate limits or service availability issues.
Links and References
- RetellAI API Documentation (hypothetical link for reference)
- E.164 Phone Number Formatting