3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node integrates with the 3CX telephony system, allowing users to perform various operations related to communication management. Specifically, the "Bulk Numbers Delete" operation under the "Black List Numbers" resource enables users to delete multiple phone numbers from the blacklist in a single request. This is useful for administrators who want to quickly remove several blocked numbers without deleting them one by one.

Practical examples include:

  • Cleaning up a blacklist by removing numbers that were mistakenly added.
  • Managing blacklists dynamically based on changing business rules or customer requests.
  • Automating bulk removal of numbers after a certain period or event.

Properties

Name Meaning
Ids A JSON array containing the IDs of the blacklisted numbers to be deleted in bulk. The input expects a JSON string which will be parsed and sent as the request body. Example: [123, 456, 789]

Output

The node outputs data in JSON format representing the result of the bulk deletion operation. Typically, this would include confirmation of which numbers were successfully deleted or any errors encountered per ID. The exact structure depends on the 3CX API response but generally includes status information about the bulk delete request.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • The node uses the base URL configured in the credentials, ensuring requests are sent to the correct 3CX server endpoint.
  • The node expects the 3CX server URL to be provided without a trailing slash; it handles trimming if necessary.

Troubleshooting

  • Invalid JSON in Ids property: If the JSON array provided in the "Ids" property is malformed, the node will fail to parse it, resulting in an error. Ensure the input is valid JSON.
  • Authentication errors: If the API key or OAuth2 token is missing or invalid, the node will not authenticate with the 3CX server. Verify credentials are correctly set up.
  • Network or server errors: Connection issues or incorrect server URLs can cause failures. Confirm the server URL is reachable and correct.
  • Empty or null Ids array: Sending an empty list or null values may result in no action or an error from the API. Provide a valid list of IDs to delete.

Links and References

Discussion