WTS Chat icon

WTS Chat

Get data from Wts API

Actions39

Overview

The "Add Contacts To Sequence" operation in the "Sequence" resource of this custom n8n node allows you to add multiple contacts to a specific sequence in WTS Chat. This is useful for automating marketing, sales, or communication workflows where you want to enroll several users (by phone number and/or contact ID) into a predefined messaging or action sequence.

Common scenarios:

  • Enrolling a batch of new leads into an onboarding sequence.
  • Adding selected customers to a promotional campaign.
  • Automating follow-ups by adding contacts to a drip sequence.

Practical example:
Suppose you have a list of customer phone numbers and contact IDs from a previous workflow step. You can use this node operation to add all these contacts to a nurturing sequence in WTS Chat with a single action.

Properties

Below are the input properties relevant to the "Add Contacts To Sequence" operation:

Display Name Type Description
Sequence ID String The unique identifier of the sequence to which contacts will be added. Required.
Phonenumbers Collection A collection of phone numbers to add as contacts to the sequence. Each entry should be a string representing a phone number. Optional if "Contacts ID" is provided.
Contacts ID Collection A collection of contact IDs to add to the sequence. Each entry should be a string representing a contact's ID. Optional if "Phonenumbers" is provided.

Note: At least one of "Phonenumbers" or "Contacts ID" must be provided. If both are empty, the node will throw an error.

Output

The output of this operation is a JSON object containing the result of the API call to add the specified contacts to the sequence. The structure of the output depends on the response from the WTS Chat API, but typically includes information about the success or failure of the addition.

Example output:

[
  {
    "json": {
      // Response from WTS Chat API, e.g.,
      "success": true,
      "addedContactIds": ["123", "456"],
      "addedPhoneNumbers": ["+1234567890", "+0987654321"]
    }
  }
]
  • The json field contains the direct response from the API.
  • No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to the WTS Chat API.
  • API Key: The node requires valid WTS Chat API credentials (wtsApi) configured in n8n.
  • n8n Configuration: Ensure that the WTS Chat API credentials are set up in your n8n instance.

Troubleshooting

Common issues:

  • Missing Inputs:

    • Error: "Add a contacts either by ID or phone number"
      Cause: Both "Phonenumbers" and "Contacts ID" are empty.
      Solution: Provide at least one phone number or contact ID.

  • Invalid Sequence ID:

    • Error: May receive an error from the API if the "Sequence ID" is invalid or missing.
      Solution: Double-check the sequence ID value.

  • API Authentication Errors:

    • Error: Authentication/authorization errors from the WTS Chat API.
      Solution: Verify that your API key is correct and has sufficient permissions.

  • API Rate Limiting:

    • If processing many items, there may be delays due to built-in throttling (e.g., waiting between batches).
      Solution: This is handled internally, but be aware of possible delays for large batches.

Links and References

Discussion