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 update the status of MCU (Multipoint Control Unit) requests within conference settings. It is useful in scenarios where managing or controlling conference call states programmatically is required, such as automatically approving, rejecting, or modifying MCU requests based on external triggers or workflows.

For example, a user might automate the approval process for conference MCU requests by updating their status through this node when certain conditions are met, improving operational efficiency and reducing manual intervention.

Properties

Name Meaning
Request A JSON object representing the MCU request data to be updated. This property accepts a JSON string that will be parsed and sent as the body of the API request.

Output

The node outputs JSON data reflecting the response from the 3CX API after attempting to update the MCU request status. The structure typically includes confirmation of the update operation, any relevant status messages, or error details if the update failed.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • The node expects a base URL for the 3CX server, configured in the credentials.
  • The node sends HTTP requests to the 3CX API endpoint /xapi/v1.
  • Proper OAuth2 authentication setup is necessary to authorize API calls.

Troubleshooting

  • Invalid JSON in Request Property: If the JSON provided in the "Request" property is malformed, the node will fail to parse it, causing errors. Ensure the JSON is valid before running the node.
  • Authentication Errors: Failure to authenticate with the 3CX API may result in authorization errors. Verify that the API key or OAuth2 token is correctly configured and has sufficient permissions.
  • Incorrect Base URL: An incorrect or unreachable 3CX server URL will cause connection failures. Confirm the server URL is correct and accessible.
  • API Response Errors: If the MCU request ID or parameters are invalid, the API may return errors. Check the request payload and ensure all required fields are included and valid.

Links and References

Discussion