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 Contacts resource with the Bulk Create operation, it allows users to create multiple contact entries in one request by sending a batch of phone numbers along with optional tags.

Common scenarios where this node is beneficial include:

  • Importing or syncing large lists of contacts into the Talknbox VE system efficiently.
  • Automating contact management workflows where multiple contacts need to be added at once.
  • Tagging contacts during bulk creation to categorize or segment them for campaigns or reporting.

Practical example:

  • A marketing team wants to upload a list of new leads with their phone numbers and associated tags (e.g., "prospect", "newsletter") to start an outbound campaign. Using this node's Bulk Create operation, they can send all contacts in one go instead of adding them individually.

Properties

Name Meaning
Contacts Payload A collection of contacts to create in bulk. Each contact includes:
- Phone The phone number of the contact.
- Tags Comma-separated tags to assign to the contact (e.g., "vip,customer"). These are split and trimmed before sending.

Output

The node outputs an array of JSON objects representing the response from the Talknbox VE API for the bulk create request. Each item corresponds to the API's response for the batch operation, typically including details about the created contacts or status confirmation.

No binary data output is produced by this operation.

Example output structure (simplified):

[
  {
    "json": {
      "ok": true,
      "createdContacts": [
        {
          "id": "contact_id_1",
          "phone": "+1234567890",
          "tags": ["vip", "customer"]
        },
        {
          "id": "contact_id_2",
          "phone": "+0987654321",
          "tags": []
        }
      ]
    }
  }
]

(Note: Actual response fields depend on the Talknbox VE API.)

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 and delay based on the x-ratelimit-reset header.

Troubleshooting

  • Rate Limiting Errors (HTTP 429): The node automatically retries after waiting for the specified reset time. If you still encounter errors, consider reducing request frequency or increasing pacing.
  • Invalid Phone Numbers: Ensure phone numbers are correctly formatted strings; invalid formats may cause API errors.
  • Empty or Malformed Tags: Tags should be comma-separated strings. Empty tags are filtered out. Providing malformed tag strings might lead to unexpected behavior.
  • API Authentication Failures: Verify that the API key credential is valid and has sufficient permissions.
  • Partial Failures: If some contacts fail to create, the API response may indicate which ones failed. Use the node’s error handling options to manage partial failures.

Links and References

Discussion