3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node interacts with the 3CX telephony system, specifically allowing users to delete a group entity within 3CX. It is useful in scenarios where you need to programmatically manage groups, such as removing obsolete or unused groups from your telephony setup. For example, an administrator might automate cleanup of groups that are no longer needed after organizational changes.

Properties

Name Meaning
Id The unique identifier of the group to delete. Can be set dynamically using expressions.
If Match An optional ETag value used for concurrency control to ensure the group has not changed since last retrieval.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will confirm whether the deletion was successful or provide error details if it failed. 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.
  • The base URL for the 3CX API must be configured in the credentials.
  • The node sends HTTP requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent group ID will cause the deletion to fail.
    • Missing or incorrect API authentication will result in authorization errors.
    • Using an outdated or incorrect ETag in the "If Match" header may cause the request to be rejected due to concurrency conflicts.

  • Error messages and resolutions:

    • 404 Not Found: The specified group ID does not exist. Verify the ID before attempting deletion.
    • 401 Unauthorized: Authentication failed. Check that the API key credential is correctly configured.
    • 412 Precondition Failed: The ETag provided in "If Match" does not match the current version of the group. Retrieve the latest ETag and retry.

Links and References

Discussion