3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

This node allows updating the Music On Hold settings in a 3CX telephony system. It is useful for administrators who want to customize or change the audio files or streams played to callers when they are placed on hold. For example, you can update the music or messages that callers hear during wait times, either by specifying different audio sources or enabling randomization of tracks.

Typical use cases include:

  • Changing the default hold music to reflect current promotions or announcements.
  • Setting multiple hold music tracks and enabling random playback to provide variety.
  • Customizing hold music per call or globally for the system.

Properties

Name Meaning
Id Numeric identifier of the Music On Hold setting to update.
Music On Hold Primary music or audio source for hold music (string).
Music On Hold 1 Additional music/audio source option 1 (string).
Music On Hold 2 Additional music/audio source option 2 (string).
Music On Hold 3 Additional music/audio source option 3 (string).
Music On Hold 4 Additional music/audio source option 4 (string).
Music On Hold 5 Additional music/audio source option 5 (string).
Music On Hold 6 Additional music/audio source option 6 (string).
Music On Hold 7 Additional music/audio source option 7 (string).
Music On Hold 8 Additional music/audio source option 8 (string).
Music On Hold 9 Additional music/audio source option 9 (string).
Music On Hold Randomize Boolean flag to enable or disable random playback of the hold music tracks.
Music On Hold Randomize Per Call Boolean flag to enable or disable randomization of hold music on a per-call basis.

Output

The node outputs JSON data representing the response from the 3CX API after updating the Music On Hold settings. This typically includes confirmation of the updated settings or any error messages returned by the API.

No binary data output is involved.

Dependencies

  • Requires an active connection to a 3CX telephony system via its API.
  • Needs an API authentication token or OAuth2 credential configured in n8n to authorize requests.
  • The base URL for the 3CX server must be provided in the credentials configuration.

Troubleshooting

  • Invalid Id: If the provided Id does not correspond to an existing Music On Hold setting, the API may return an error. Verify the Id before updating.
  • Authentication errors: Ensure the API key or OAuth2 token is valid and has sufficient permissions.
  • Empty or invalid music sources: Providing empty strings or invalid URLs/paths for music sources might cause the update to fail or result in no audio being played.
  • Network issues: Connectivity problems with the 3CX server will prevent updates; check network access and server status.

Links and References

Discussion