3CX icon

3CX

Interact with 3CX telephony system

Actions462

Overview

This node interacts with the 3CX telephony system, specifically allowing users to retrieve multiple "Edit Greetings" for users in bulk. It is useful in scenarios where an administrator or user wants to fetch customized greeting messages associated with several users at once, such as retrieving voicemail greetings or call handling messages for a group of users.

Practical examples include:

  • Bulk fetching voicemail greetings for a list of user IDs.
  • Retrieving custom call greeting messages for multiple users to audit or update them.

Properties

Name Meaning
Ids A JSON array containing the user IDs for which the multi-edit greetings should be retrieved. The input expects a JSON string that will be parsed into an array of IDs.

Output

The output contains a json field with the data returned from the 3CX API corresponding to the requested greetings for the specified user IDs. This typically includes greeting details such as message content, type, and associated user information.

If the node supports binary data (not explicitly shown here), it would represent audio files or other media related to the greetings.

Dependencies

  • Requires an API key credential for authenticating with the 3CX telephony system.
  • Needs the 3CX server URL configured in the credentials.
  • The node uses the 3CX REST API endpoint /xapi/v1 to perform requests.
  • The request headers specify Accept: application/json.

Troubleshooting

  • Invalid or missing user IDs: Ensure the Ids property contains a valid JSON array of user IDs. Malformed JSON or null values may cause errors.
  • Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Server URL issues: Confirm the 3CX server URL is correct and reachable; trailing slashes are handled but incorrect URLs will cause connection failures.
  • API response errors: If the API returns errors, check the user IDs exist and the account has access rights to those users' greetings.

Links and References

Discussion