3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node operation updates an existing website link's configuration in the 3CX telephony system. It allows users to modify various aspects of a weblink such as enabling or disabling calls, chat, meetings, and reCAPTCHA, as well as updating styling, translations, group association, and other advanced settings.

Common scenarios for this node include:

  • Adjusting the behavior or appearance of a website link used for customer communication.
  • Enabling or disabling specific features like chat or call capabilities on a particular weblink.
  • Updating metadata or tags associated with a weblink to reflect changes in organizational structure or marketing campaigns.

Practical example:

  • A user wants to disable chat on a specific website link while keeping calls enabled and update its styling to match a new branding guideline. This node can be configured to send those updates seamlessly.

Properties

Name Meaning
Link The unique key identifying the website link to update. Supports expressions (e.g., {{$json.Link}}).
Advanced JSON object containing advanced configuration options for the weblink.
Calls Enabled Boolean flag to enable or disable call functionality on the weblink.
Chat Box JSON object defining chat box settings and behavior.
Chat Enabled Boolean flag to enable or disable chat functionality on the weblink.
Default Record Boolean indicating if this weblink is the default record.
DN JSON object including membership and tagging information related to the weblink.
Enable Re Captcha Boolean to enable or disable Google reCAPTCHA verification on the weblink.
General JSON object for general settings related to the weblink.
Group String specifying the group to which the weblink belongs.
Hidden Boolean indicating whether the weblink is hidden from public view.
Id Numeric identifier of the weblink record to update.
Meeting Enabled Boolean flag to enable or disable meeting functionality on the weblink.
Name The display name of the weblink.
Styling JSON object defining CSS or style-related configurations for the weblink.
Translations JSON object containing translation strings for multi-language support.
Website JSON array representing associated websites or domains for the weblink.

Output

The node outputs JSON data reflecting the result of the update operation on the website link. This typically includes confirmation of the updated fields and any response data returned by the 3CX API. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API authentication token credential to connect securely to the 3CX telephony system.
  • Needs the base URL of the 3CX server configured in credentials.
  • The node sends HTTP requests to the 3CX API endpoint /xapi/v1 to perform the update.

Troubleshooting

  • Invalid Link Key: If the provided Link key does not exist, the API may return an error indicating the resource was not found. Verify the Link value is correct and exists in the 3CX system.
  • Malformed JSON Properties: Properties like Advanced, ChatBox, DN, General, Styling, Translations, and Website expect valid JSON strings. Invalid JSON will cause parsing errors. Ensure these inputs are correctly formatted.
  • Authentication Errors: Missing or invalid API credentials will prevent successful connection. Confirm that the API key/token and server URL are correctly set up.
  • Permission Issues: Insufficient permissions on the API token may lead to authorization errors when attempting to update links. Check user roles and API scopes.
  • Network Connectivity: Failure to reach the 3CX server due to network issues will cause request failures. Verify network access and server availability.

Links and References

Discussion