Actions20
- Calls Actions
- Campaigns Actions
- Contacts Actions
- Agents Actions
- Queues Actions
- Reports Actions
- Webhooks Actions
Overview
This node integrates with the Talknbox VE API, enabling automation workflows to interact with various Talknbox VE resources such as campaigns, calls, contacts, agents, queues, reports, webhooks, and system information. Specifically, the Campaigns - List operation retrieves a paginated list of campaigns from the Talknbox VE platform.
Typical use cases include:
- Fetching campaign data for reporting or monitoring purposes.
- Automating campaign management by retrieving current campaigns before performing updates or actions.
- Integrating campaign data into other systems or dashboards.
For example, you might use this node to get all active campaigns page by page, then process or analyze them in subsequent workflow steps.
Properties
| Name | Meaning |
|---|---|
| Page | The page number of the campaigns list to retrieve (default: 1). Useful for pagination. |
| Page Size | Number of campaigns to return per page (default: 50). Controls the size of each page of results. |
These properties allow control over pagination when listing campaigns.
Output
The node outputs an array of JSON objects representing the campaigns retrieved from the Talknbox VE API. Each item corresponds to one campaign's data as returned by the API endpoint /v1/campaigns.
The exact structure depends on the API response but typically includes fields like campaign ID, name, pacing, status, and other campaign metadata.
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 built-in HTTP request helpers with automatic retry logic for rate limiting (HTTP 429).
Troubleshooting
- Rate Limiting (HTTP 429): If too many requests are made in a short time, the node automatically retries after waiting for the reset time indicated by the API. If errors persist, consider increasing delays between requests or reducing page size.
- Authentication Errors: Ensure that the API key credential is valid and has sufficient permissions.
- Invalid Pagination Parameters: Providing invalid page numbers or sizes may result in empty responses or errors. Use positive integers within allowed ranges.
- Network Issues: Connectivity problems will cause request failures; verify network access to the Talknbox VE API endpoint.
Links and References
- Talknbox VE API Documentation (Assumed URL, replace with actual if known)
- n8n HTTP Request Node documentation for understanding request options and error handling: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/