Talknbox VEInstall

Overview

This node integrates with the Talknbox VE API to manage contacts, campaigns, calls, agents, queues, reports, webhooks, and system information. Specifically, the Contacts - List operation retrieves a paginated list of contacts from the Talknbox VE system.

This operation is useful when you want to fetch and process contact data in bulk, for example:

• Synchronizing contacts from Talknbox VE into another system.
• Displaying or analyzing contact lists within an automation workflow.
• Filtering or segmenting contacts based on external criteria.

Properties

Output

The node outputs an array of JSON objects representing contacts retrieved from the Talknbox VE API. Each item in the output corresponds to a contact record as returned by the API endpoint /v1/contacts.

The exact structure of each contact object depends on the API response but typically includes fields such as phone number, tags, and other contact metadata.

The node does not output binary data for this operation.

Dependencies

• Requires an API key credential for authenticating with the Talknbox VE API.
• The base URL for the API is configurable via the credential.
• The node uses built-in HTTP request helpers with automatic retry on rate limiting (HTTP 429).

Troubleshooting

• Rate Limiting Errors (HTTP 429): The node automatically retries up to 3 times with delay based on the x-ratelimit-reset header. If you still encounter rate limit errors, consider reducing the page size or request frequency.
• Authentication Errors: Ensure that the API key credential is valid and has sufficient permissions to access contacts.
• Invalid Pagination Parameters: Providing non-positive integers for Page or Page Size may cause API errors. Use positive integers only.
• Network Issues: Check connectivity to the Talknbox VE API base URL.

Links and References

• Talknbox VE API Documentation (Assumed URL; replace with actual if known)
• n8n Documentation: Creating Custom Nodes