3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node integrates with the 3CX telephony system, specifically providing an operation to bulk delete fax messages. It is useful in scenarios where users need to manage and clean up multiple fax records efficiently, such as removing outdated or unwanted faxes in one action rather than deleting them individually.

A practical example would be a user who has received numerous faxes and wants to clear all or selected ones from the system to maintain organization or free up storage space.

Properties

Name Meaning
Ids A JSON array of fax message IDs to be deleted in bulk. The user must provide the list of IDs representing the faxes they want to remove.

Output

The node outputs the result of the bulk delete operation in the json field. This typically includes confirmation of which fax IDs were successfully deleted or any errors encountered during the process. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • Needs the base URL of the 3CX server configured in the credentials.
  • The node sends HTTP requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Invalid or missing fax IDs: If the provided IDs are incorrect or empty, the deletion will fail. Ensure the IDs are valid and correctly formatted as a JSON array.
  • Authentication errors: If the API key or OAuth2 token is invalid or expired, the node will not connect to the 3CX API. Verify the credentials and refresh tokens if necessary.
  • Server URL misconfiguration: The base URL must be correctly set without trailing slashes; otherwise, requests may fail.
  • API rate limits or permissions: Bulk operations might be restricted by the 3CX system settings or user permissions. Check the API documentation and user roles.

Links and References

Discussion