3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node interacts with the 3CX telephony system, specifically allowing users to manage "Prompt Sets." The "Set Active" operation enables activating a particular prompt set by its ID. This is useful in scenarios where you want to switch the active voice prompts or messages used by the telephony system dynamically, for example, changing greetings or announcements based on time of day or campaign.

Properties

Name Meaning
Id The unique identifier of the prompt set to activate. You can provide this as a static number or use an expression to dynamically reference it from previous node data (e.g., {{$json.Id}}).

Output

The node outputs JSON data representing the response from the 3CX API after attempting to set the active prompt set. This typically includes confirmation of success or details about the activated prompt set. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • The node expects a base URL for the 3CX server, configured via credentials.
  • The node sends requests to the 3CX API endpoint /xapi/v1.
  • Proper OAuth2 authentication setup is necessary to authorize API calls.

Troubleshooting

  • Invalid or missing Id: If the provided prompt set ID does not exist or is invalid, the API will likely return an error. Ensure the ID is correct and accessible.
  • Authentication errors: If the API key or OAuth2 token is incorrect or expired, the node will fail to authenticate. Verify credentials and refresh tokens if needed.
  • Server URL misconfiguration: The base URL must be correctly set without trailing slashes; otherwise, API calls may fail.
  • API connectivity issues: Network problems or firewall restrictions might prevent communication with the 3CX server.

Links and References

Discussion