Actions58
- Lead Management Actions
- User Agent Management Actions
- Campaign Management Actions
- Phone DID Management Actions
- List Management Actions
- Reporting Monitoring Actions
- System Info Actions
- Other Operations Actions
Overview
This node operation allows users to update or delete a phone alias in the Phone DID Management system via an API call. It is useful for managing phone number aliases dynamically, such as renaming an alias, associating it with different phone logins, or removing it entirely. Practical scenarios include updating contact center configurations, maintaining up-to-date phone routing information, or cleaning up obsolete aliases.
Properties
| Name | Meaning |
|---|---|
| Function | The API function to call; fixed to "Update Phone Alias" for this operation. |
| User | The API user credential used for authentication. |
| Pass | The API password credential used for authentication. |
| Source | A description string indicating what originated the API call (default: "n8n"). |
| Alias Id | The unique identifier of the alias to update or delete. |
| Alias Name | The new name to assign to the alias (optional if deleting). |
| Phone Logins | Comma-separated list of phone login identifiers associated with the alias. |
| Delete Alias | Option to delete the alias instead of updating it; values: "Y" (yes) or "N" (no). |
Output
The node outputs the JSON response from the API call in the json field of the output data. This typically contains confirmation of the update or deletion action, including status messages or error details returned by the Phone DID Management API.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential with username and password for authenticating requests.
- The node sends HTTP requests to the configured base URL of the VICIdial API endpoint.
- Proper configuration of the API host URL and credentials in n8n is necessary.
Troubleshooting
- Authentication errors: Ensure that the provided API user and password are correct and have sufficient permissions.
- Invalid Alias Id: If the alias ID does not exist, the API may return an error; verify the alias ID before updating or deleting.
- Missing required fields: Alias Id and authentication credentials are mandatory; missing these will cause request failures.
- Delete Alias option misuse: Setting "Delete Alias" to "Y" will remove the alias; ensure this is intended to avoid accidental deletions.
- API connectivity issues: Verify network access to the API host and correct base URL configuration.
Links and References
- VICIdial API Documentation (general reference for API functions)
- n8n documentation on HTTP Request Node for understanding API calls within workflows