3CX icon

3CX

Interact with 3CX telephony system

Actions462

Overview

This node integrates with the 3CX telephony system, specifically allowing users to update Secure SIP Settings. It is useful in scenarios where secure communication configurations need to be programmatically managed or updated within a 3CX environment. For example, an administrator can automate the process of updating certificates and private keys used for securing SIP communications, ensuring that the telephony system maintains up-to-date security credentials without manual intervention.

Properties

Name Meaning
Certificate JSON object representing the certificate data to be used for Secure SIP settings.
Private Key JSON object representing the private key associated with the certificate.

Both properties expect JSON input and are sent as part of the request body after parsing from string to JSON.

Output

The node outputs data in JSON format, reflecting the response from the 3CX API after attempting to update the Secure SIP Settings. This typically includes confirmation of the update or details about the applied configuration. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API authentication token credential for 3CX OAuth2.
  • Needs the base URL of the 3CX server configured in the credentials.
  • The node sends HTTP requests to the 3CX API endpoint /xapi/v1.
  • Input properties must be valid JSON strings that can be parsed into objects.

Troubleshooting

  • Invalid JSON Input: If the Certificate or Private Key inputs are not valid JSON strings, the node will fail to parse them, causing errors. Ensure these inputs are correctly formatted JSON.
  • Authentication Errors: Missing or incorrect API authentication tokens will result in authorization failures. Verify that the OAuth2 credentials are properly set up.
  • API Endpoint Issues: Incorrect server URL or network issues may cause connection failures. Confirm the server URL is correct and accessible.
  • API Response Errors: If the 3CX API rejects the update (e.g., due to invalid certificate data), the node will return error messages from the API. Review the API documentation for required formats and constraints.

Links and References

Discussion