Voicenter icon

Voicenter

Consume Voicenter API (v.0.1.7)
Join our community

Actions10

Overview

This node integrates with the Voicenter API to send caller details via a pop-up screen. It is designed to facilitate communication workflows where caller information needs to be displayed or processed dynamically, such as in call centers or CRM systems.

A typical use case is when an incoming call arrives, and the system needs to show the caller's details on a pop-up screen for the agent. This node sends those details, including client name, company, status, and other relevant data, to the Voicenter platform to trigger the pop-up display.

Properties

Name Meaning
Status The status of the operation; options are "OK" or "Error".
Use Credential Crm Url Boolean flag indicating whether to use the CRM URL from stored credentials (true) or a custom URL (false).
Url The custom URL to use if "Use Credential Crm Url" is set to false.
Account Id The account identifier used when "Use Credential Crm Url" is set to true.
Client Name The name of the client associated with the caller details.
Total A numeric value representing a total count or amount related to the caller (context-specific).
Company The company name associated with the caller.
Merge JSON parameters Boolean flag to enable merging additional JSON parameters into the request using lodash's merge function.
JSON A JSON object containing additional parameters to merge into the request when "Merge JSON parameters" is enabled.

Output

The node outputs JSON data that reflects the result of sending the caller details to the Voicenter API. This typically includes confirmation of success or error messages depending on the "Status" property and the API response.

If binary data were involved, it would represent any files or media returned by the API, but this node focuses on JSON responses related to caller detail transmission.

Dependencies

  • Requires an API key credential for authenticating with the Voicenter API.
  • Uses the Voicenter API endpoint, which can be specified either via stored credentials or a custom URL.
  • Relies on lodash's merge function to combine JSON parameters if enabled.
  • Requires n8n environment configured with the appropriate Voicenter API credentials.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Providing an invalid URL or disabling the use of credential URL without specifying a valid custom URL may lead to connection errors.
    • Malformed JSON in the "JSON" property when "Merge JSON parameters" is enabled can cause parsing errors.

  • Error Messages:

    • Authentication errors usually indicate invalid or expired API keys; verify and update credentials.
    • Network or connection errors suggest checking the URL configuration and network accessibility.
    • JSON parsing errors require validating the JSON syntax in the input field.

Links and References

Discussion