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 retrieve a website link by its key. It is useful in scenarios where you need to fetch detailed information about a specific web link stored or managed within the 3CX system. For example, you might use this node to dynamically obtain URLs for call routing, customer portals, or other telephony-related web resources during workflow execution.

Properties

Name Meaning
Link The key identifier of the website link to retrieve. Supports expressions (e.g., {{$json.Link}}).
Options Additional query options:
- Select: Specify which properties of the weblink to return (e.g., Id,Name).
- Expand: Expand related entities to include additional linked data (e.g., RelatedEntity1,RelatedEntity2).

Output

The node outputs JSON data representing the requested website link entity from the 3CX system. The structure depends on the selected properties and expanded related entities specified in the options. This typically includes fields such as the link's ID, name, URL, and any related metadata. There is no binary output.

Dependencies

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

Troubleshooting

  • Invalid Link Key: If the provided link key does not exist, the node may return an error or empty response. Verify the key value and ensure it matches an existing weblink.
  • Authentication Errors: Ensure that the API authentication token is valid and has sufficient permissions to access website links.
  • Network Issues: Confirm that the 3CX server URL is correct and reachable from the n8n instance.
  • Incorrect Query Options: Using invalid property names in the Select or Expand options can cause errors. Use valid property names as defined by the 3CX API documentation.

Links and References

Discussion