3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node interacts with the 3CX telephony system, specifically providing functionality to retrieve details about a blocklist address by its unique identifier. It is useful in scenarios where users need to query and manage telephony blocklists, for example, to check if a particular phone number or entity is blocked or to fetch detailed information about a blocklisted entry.

A practical example would be an automated workflow that checks incoming call numbers against the blocklist to decide whether to allow or reject calls based on the retrieved blocklist data.

Properties

Name Meaning
Id The unique identifier of the blocklist entity to retrieve. Can be set dynamically via expressions like {{$json.Id}}. Must be a number.
Options Additional query options:
- Select: Specify which properties of the blocklist entity 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 blocklist entity corresponding to the provided Id. The structure of this JSON depends on the selected properties and any expanded related entities specified in the options.

If binary data were involved, it would typically represent files or media associated with the blocklist entry, but in this case, the output is purely JSON data describing the blocklist address.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • The node expects the base URL of the 3CX server to be configured in the credentials.
  • No other external dependencies are indicated.

Troubleshooting

  • Invalid or missing Id: Ensure the Id property is provided and is a valid number. Using expressions must resolve correctly at runtime.
  • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
  • Network issues: Confirm that the 3CX server URL is reachable from the n8n instance.
  • Incorrect $select or $expand values: If the returned data is incomplete or errors occur, check that the property names used in these options match those supported by the 3CX API.

Links and References

Discussion