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 Ring Group entity. Deleting a Ring Group is useful when you want to remove a group of extensions or phones that ring simultaneously or in sequence, for example, when reorganizing call routing or decommissioning a team.

A practical scenario: If a team is disbanded or merged, you might want to delete its associated Ring Group to prevent calls from being routed there anymore.

Properties

Name Meaning
Id The unique identifier of the Ring Group to delete. Can be set dynamically using expressions like {{$json.Id}}. Must be provided.
If Match Optional ETag header value used for concurrency control. Ensures the Ring Group is deleted only if it matches the specified version.

Output

The node outputs JSON data representing the result of the delete operation. Typically, this would include confirmation of deletion or any error messages returned by the 3CX API.

No binary data output is expected from this operation.

Dependencies

  • Requires an active connection to a 3CX telephony system.
  • Needs an API authentication token (OAuth2) configured in n8n credentials to authorize requests.
  • The base URL for the 3CX API must be set in the credentials and is used as the request endpoint.

Troubleshooting

  • Missing or invalid Id: The node requires a valid Ring Group ID to delete. Ensure the ID is correctly passed and exists in the 3CX system.
  • ETag mismatch: If using the "If Match" property, an incorrect or outdated ETag will cause the delete operation to fail due to concurrency conflicts. Refresh the ETag before retrying.
  • Authentication errors: Verify that the OAuth2 credential is properly configured and has sufficient permissions.
  • Network or API errors: Check connectivity to the 3CX server and ensure the base URL is correct.

Links and References

Discussion