3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node integrates with the 3CX telephony system, specifically allowing users to manage active calls. The "Drop Call" operation under the "Active Calls" resource enables terminating an ongoing call by specifying its unique identifier. This is useful in scenarios such as automating call management workflows, handling call queues, or implementing custom call control logic within a communication process.

For example, you might use this node to automatically drop calls that have been on hold for too long or to disconnect calls based on certain business rules triggered elsewhere in your workflow.

Properties

Name Meaning
Id The unique identifier of the active call to be dropped. This is a required numeric value and can be dynamically set using expressions like {{$json.Id}}.

Output

The node outputs JSON data representing the result of the drop call operation. Typically, this will include confirmation of the call being dropped or error information if the operation failed. The exact structure depends on the 3CX API response but generally includes status and possibly details about the dropped call.

No binary data output is indicated.

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 call Id: Ensure the "Id" property is correctly provided and corresponds to an active call. Using an incorrect or non-existent Id will cause the operation to fail.
  • Authentication errors: Verify that the API key credential is valid and has sufficient permissions to manage calls.
  • Network or server issues: Confirm that the 3CX server URL is correct and accessible from the n8n environment.
  • API response errors: If the 3CX API returns an error, check the message for details. Common issues include trying to drop a call that has already ended or insufficient privileges.

Links and References

Discussion