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 link a partner (reseller) to a group within 3CX. This operation is useful in scenarios where organizations manage multiple reseller relationships and need to associate these resellers with specific groups for billing, management, or configuration purposes.

Practical examples include:

  • Automatically linking a reseller to a newly created group as part of an onboarding workflow.
  • Managing reseller-group associations dynamically based on external CRM or ERP data.

Properties

Name Meaning
Group Id The unique identifier of the group within 3CX to which a reseller will be linked.
Reseller Id The unique identifier of the reseller (partner) to link to the specified group.

Output

The node outputs JSON data representing the response from the 3CX API after attempting to link the reseller to the group. This typically includes confirmation of the link or details about the updated group-partner relationship.

No binary data output is indicated.

Dependencies

  • Requires an API authentication token credential configured for 3CX OAuth2.
  • Needs the base URL of the 3CX server to be set in the credentials.
  • The node sends requests to the 3CX API endpoint under /xapi/v1.

Troubleshooting

  • Invalid Group Id or Reseller Id: If either ID is incorrect or does not exist, the API will likely return an error. Verify IDs before running the node.
  • Authentication Errors: Ensure that the OAuth2 credentials are valid and have sufficient permissions to perform linking operations.
  • Network Issues: Confirm that the 3CX server URL is reachable and correctly configured without trailing slashes.
  • API Response Errors: Check the returned JSON for error messages indicating issues such as permission denied or invalid request format.

Links and References

  • 3CX API Documentation (general reference for 3CX API endpoints)
  • OAuth2 Authentication setup guides for 3CX integration (refer to your 3CX admin documentation)

Discussion