Voicenter icon

Voicenter

Consume Voicenter API (v.0.1.7)

Actions10

Overview

The node "Voicenter" integrates with the Voicenter API, providing various telephony-related functionalities. Specifically, for the CDR Notifications resource and the response operation, it allows users to send a response indicating the status of processing a Call Detail Record (CDR) notification. This is useful in scenarios where an external system receives CDR notifications from Voicenter and needs to acknowledge or report errors back to the service.

Practical examples include:

  • Confirming successful receipt and parsing of a CDR notification by responding with an "OK" status.
  • Reporting parsing errors or application-level errors when processing the notification fails, enabling better error handling and monitoring.

Properties

Name Meaning
Status The response status code indicating the result of processing the CDR notification. Options: "OK", "Parse Error", "Application Error".
Error Description A textual description of the error or status message to accompany the status code. Defaults to "OK".

Output

The node outputs JSON data representing the response sent back for the CDR notification. The structure typically includes the status code and the error description as provided in the input properties. There is no indication that binary data is output by this operation.

Example output JSON structure:

{
  "err": 0,
  "errdesc": "OK"
}

Where err corresponds to the selected status code and errdesc provides additional context.

Dependencies

  • Requires an API key credential for authenticating with the Voicenter API.
  • Uses the internal Voicenter client library to communicate with the API.
  • No other external services or environment variables are explicitly required beyond the configured API credentials.

Troubleshooting

  • Common issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Providing an invalid status code or malformed error description may lead to API rejection.
    • Network connectivity problems can prevent communication with the Voicenter API.

  • Error messages:

    • Authentication errors typically indicate invalid or missing API keys; verify credentials configuration.
    • Validation errors on the status or error description suggest checking the allowed options and string formatting.
    • Timeout or connection errors require checking network access and API endpoint availability.

Links and References

Discussion