3CX icon

3CX

Interact with 3CX telephony system

Actions462

Overview

This node integrates with the 3CX telephony system, specifically allowing users to update call cost settings. It is useful in scenarios where businesses want to programmatically manage or adjust the costs associated with calls within their 3CX system, such as updating pricing plans or applying new cost structures dynamically.

A practical example would be a telecom administrator automating the update of call cost rates based on changing tariffs or promotional offers without manually accessing the 3CX management console.

Properties

Name Meaning
Costs A JSON array representing the call cost settings to update. The value should be a valid JSON string that defines the cost parameters to apply.

Output

The node outputs data in JSON format reflecting the result of the update operation on the call cost settings. This typically includes confirmation of the updated costs or any relevant response from the 3CX API indicating success or failure.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with the 3CX system.
  • Needs the base URL of the 3CX server configured in the credentials.
  • The node sends requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Invalid JSON in Costs property: If the JSON provided in the Costs input is malformed, the node will fail to parse it. Ensure the JSON syntax is correct.
  • Authentication errors: If the API key or OAuth2 token is missing or invalid, the node will not connect to the 3CX API. Verify credentials are correctly set up.
  • Incorrect server URL: The base URL must be accurate and reachable. Trailing slashes are handled, but the URL must point to a valid 3CX instance.
  • API errors: If the 3CX API returns errors (e.g., due to invalid cost parameters), check the API response message for details and adjust the input accordingly.

Links and References

Discussion