Talknbox VE

Integracja z Talknbox VE API
Join our community

Actions20

Overview

This node integrates with the Talknbox VE API to manage and control campaigns, calls, contacts, agents, queues, reports, webhooks, and system information. Specifically, the Campaigns - Start operation triggers the start of a campaign by sending a POST request to the Talknbox VE API endpoint that initiates the campaign's execution.

This node is beneficial in scenarios where automated call campaigns need to be programmatically controlled within an n8n workflow. For example, a user can start a pre-configured campaign to begin outbound calls to a list of contacts, enabling automation of marketing or notification calls.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign to start. This is a required string input.

Output

The node outputs a JSON object representing the response from the Talknbox VE API after attempting to start the campaign. The structure typically includes a success confirmation or details about the started campaign. If the API call fails, the output will contain an error message.

Example output JSON structure (simplified):

{
  "ok": true
}

If an error occurs and the node is set to continue on failure, the output will include:

{
  "error": "Error message describing what went wrong"
}

The node does not output binary data.

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 (HTTP 429): The node automatically retries requests up to 3 times with a delay based on the x-ratelimit-reset header. If you still encounter rate limit errors, consider reducing request frequency or increasing API limits.
  • Invalid Campaign ID: If the provided Campaign ID does not exist or is malformed, the API will return an error. Verify the Campaign ID before starting.
  • Authentication Errors: Ensure that the API key credential is correctly configured and has sufficient permissions.
  • Network Issues: Connectivity problems can cause request failures. Check network access to the Talknbox VE API endpoint.
  • Continue on Fail: If enabled, errors will be returned in the output JSON instead of stopping execution, allowing workflows to handle failures gracefully.

Links and References

Discussion