Talknbox VE

Integracja z Talknbox VE API
Join our community

Actions20

Overview

This node integrates with the Talknbox VE API, providing various operations across multiple resources such as calls, campaigns, contacts, agents, queues, reports, webhooks, and system information. Specifically for the Agents resource with the Set Status operation, it allows updating the status of a specified agent in the Talknbox system.

Use cases include managing agent availability dynamically during call center operations, e.g., marking an agent as "Ready" to receive calls, "Busy" when occupied, or "Not Ready" when unavailable. This is useful for automating workforce management and improving call routing efficiency.

Example: Automatically setting an agent's status to "Busy" when they start handling a call, and back to "Ready" once the call ends.

Properties

Name Meaning
Agent ID The unique identifier of the agent whose status you want to update.
Status The new status to assign to the agent. Options are: "Ready", "Not Ready", or "Busy".

Output

The node outputs a JSON object representing the response from the Talknbox VE API after attempting to set the agent's status. Typically, this will contain confirmation data about the updated status or any relevant metadata returned by the API.

If the API call fails and the node is configured to continue on failure, the output will include an error message describing the issue.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Talknbox VE API.
  • The base URL for the API is configurable via credentials.
  • The node uses HTTP requests with automatic retry logic for rate limiting (HTTP 429) with up to 3 attempts.

Troubleshooting

  • Rate Limiting Errors (HTTP 429): The node automatically retries after waiting for the time specified in the x-ratelimit-reset header. If errors persist, consider reducing request frequency.
  • Invalid Agent ID: If the provided Agent ID does not exist or is malformed, the API will return an error. Verify the Agent ID before running the node.
  • Authentication Failures: Ensure that the API key credential is valid and has sufficient permissions.
  • Network Issues: Connectivity problems may cause request failures; check network access to the Talknbox VE API endpoint.
  • Unexpected API Responses: If the API changes or returns unexpected data, the node might throw errors. Check the API documentation and update the node configuration accordingly.

Links and References

Discussion