3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node integrates with the 3CX telephony system, specifically providing an operation to reprovision a user's phone based on their MAC address. The reprovisioning process typically involves sending a command to the 3CX server to refresh or reset the configuration of a physical phone device identified by its MAC address. This is useful in scenarios where a phone needs to be updated with new settings, firmware, or after troubleshooting connectivity issues.

Practical examples include:

  • Automatically reprovisioning phones when user settings change.
  • Triggering reprovisioning as part of onboarding workflows for new employees.
  • Resetting phones remotely after network changes or errors.

Properties

Name Meaning
Mac The MAC address of the phone device to reprovision. This uniquely identifies the physical phone on the network and is required to target the reprovisioning command.

Output

The node outputs JSON data representing the response from the 3CX API after attempting to reprovision the phone. This typically includes status information about the success or failure of the reprovisioning request. The output does not indicate binary data handling.

Dependencies

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

Troubleshooting

  • Invalid MAC Address: If the MAC address format is incorrect or the device is not recognized by the 3CX system, the reprovisioning will fail. Ensure the MAC address is accurate and corresponds to a registered phone.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key or OAuth2 token is correctly set up.
  • Network Issues: Connectivity problems between n8n and the 3CX server can prevent successful reprovisioning. Check network access and firewall rules.
  • API Endpoint Errors: If the 3CX server URL is misconfigured or the API version changes, requests may fail. Confirm the base URL and API path are correct.

Links and References

Discussion