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 outbound rules. The "Move Up Down" operation lets users reorder outbound rules by moving a specified rule either up or down in the list. This is useful for prioritizing call routing rules dynamically without manually adjusting them in the 3CX management interface.

Practical examples include:

  • Automatically promoting an important outbound rule to a higher priority based on business logic.
  • Demoting less critical outbound rules during certain hours or conditions.

Properties

Name Meaning
Id The numeric identifier of the outbound rule to move.
Up Boolean flag indicating the direction to move the rule: true to move up (higher priority), false to move down (lower priority).

Output

The node outputs JSON data representing the result of the move operation. Typically, this will include confirmation of the updated order or details of the moved outbound rule. The exact structure depends on the 3CX API response but generally confirms success or failure of the reorder action.

No binary data output is involved.

Dependencies

  • Requires an active connection to a 3CX telephony system.
  • Needs an API authentication token configured via OAuth2 credentials.
  • The base URL for the 3CX API must be provided in the node credentials.
  • The node sends requests to the 3CX REST API endpoint /xapi/v1.

Troubleshooting

  • Invalid Id: If the provided outbound rule ID does not exist, the API may return an error. Verify the ID corresponds to an existing outbound rule.
  • Permission Issues: Insufficient permissions or invalid API credentials can cause authorization errors. Ensure the OAuth2 token has appropriate scopes.
  • API Endpoint Errors: Incorrect server URL or network issues can lead to connection failures. Confirm the server URL is correct and accessible.
  • Direction Flag Misuse: Passing non-boolean values for the "Up" property might cause unexpected behavior. Use strictly true or false.

Links and References

Discussion