3CX icon

3CX

Interact with 3CX telephony system
Join our community

Actions462

Overview

The "Update Hotel Services" operation in the Hotel Services resource allows users to modify configuration settings related to hotel telephony services integrated with a 3CX system. This node is useful for managing telephony integration parameters such as enabling/disabling services, setting IP addresses and ports, defining integration types, configuring no-answer call handling, and specifying hotel group associations.

Typical use cases include:

  • Enabling or disabling telephony services for specific hotels.
  • Updating network connection details like IP address and port for the telephony system.
  • Changing the integration type between supported systems (e.g., Tcxpms or Fidelio).
  • Configuring how calls are handled when not answered, including timeout durations and destinations.
  • Managing hotel group assignments for telephony service routing.

This operation is beneficial for hotel IT administrators or automation engineers who want to programmatically maintain telephony configurations across multiple properties or groups.

Properties

Name Meaning
Enabled Boolean flag to enable (true) or disable (false) the hotel telephony service.
Hotel Groups JSON array specifying hotel group identifiers or details associated with the service.
Integration Type Select integration system type; options are: Tcxpms or Fidelio.
Ip Address String representing the IP address of the telephony system endpoint.
No Answer Destination JSON object defining tags or routing information for calls that are not answered.
No Answer Timeout Number indicating the timeout duration (in seconds) before a call is considered unanswered.
Port Number specifying the network port used by the telephony system.

Output

The node outputs JSON data reflecting the result of the update operation on the hotel services configuration. The exact structure depends on the API response from the 3CX system but typically includes confirmation of updated fields or error messages if the update failed.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to a 3CX telephony system API.
  • Needs an API authentication token or OAuth2 credential configured within n8n to authorize requests.
  • The base URL for the 3CX API must be set correctly in the credentials.
  • The node sends HTTP requests with JSON payloads to the 3CX API endpoint /xapi/v1.

Troubleshooting

  • Invalid Credentials: If authentication fails, verify that the API key or OAuth2 token is valid and has sufficient permissions.
  • Network Errors: Ensure the IP address and port are reachable from the n8n instance and that firewall rules allow communication.
  • Malformed JSON Inputs: For properties accepting JSON (Hotel Groups, No Answer Destination), ensure the input is valid JSON to avoid parsing errors.
  • Unsupported Integration Type: Only "Tcxpms" and "Fidelio" are accepted; selecting other values will cause errors.
  • Timeout Misconfiguration: Setting No Answer Timeout to zero or negative values might lead to unexpected behavior; use sensible positive integers.

Links and References

Discussion