3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node interacts with the 3CX telephony system, specifically providing an operation to regenerate web credentials for a device identified by its MAC address. It is useful in scenarios where a device’s web access credentials need to be refreshed or reset, such as when security policies require periodic credential rotation or when troubleshooting access issues.

A practical example would be an administrator automating the process of regenerating web credentials for multiple devices in bulk by feeding their MAC addresses into this node, ensuring all devices have updated and secure access tokens without manual intervention.

Properties

Name Meaning
Mac Address The MAC address key of the device for which to regenerate web credentials. Supports expressions, e.g., {{$json.MacAddress}}.

Output

The node outputs JSON data containing the result of the regenerate web credentials operation. This typically includes information about the new credentials or confirmation that the regeneration was successful. The exact structure depends on the 3CX API response but generally will include fields related to the updated web credentials for the specified MAC address.

No binary data output is indicated.

Dependencies

  • Requires an API authentication token configured via OAuth2 credentials to connect securely to the 3CX server.
  • The node expects the base URL of the 3CX server to be provided in the credentials configuration.
  • The node sends requests to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Common Issues:

    • Invalid or missing MAC address input can cause the operation to fail.
    • Incorrect or expired API authentication token will prevent successful communication with the 3CX server.
    • Network connectivity issues or incorrect server URL configuration may lead to request failures.

  • Error Messages:

    • Authentication errors usually indicate problems with the API token; re-authenticate or update credentials.
    • Validation errors may occur if the MAC address format is invalid; ensure it matches expected patterns.
    • Server errors might suggest temporary issues with the 3CX system; retry after some time.

Links and References

Discussion