Actions39
- Chatbot Actions
- Contact Actions
- Message Actions
- Panel Actions
- Sequence Actions
- Session Actions
Overview
The "Add Contacts To Sequence" operation in the Sequence resource allows users to add multiple contacts to a specific sequence by specifying either their phone numbers or contact IDs. This node is useful for automating workflows where you want to enroll several contacts into a predefined communication or marketing sequence simultaneously.
Common scenarios:
- Adding a batch of new leads or customers to an automated messaging campaign.
- Enrolling multiple contacts into a follow-up sequence after an event or promotion.
- Managing contact lists dynamically by adding them to sequences based on external triggers.
Practical example:
You have a list of phone numbers collected from a webinar registration and want to add all these contacts to a nurturing sequence that sends scheduled messages over time. Using this node, you can input the sequence ID and the list of phone numbers to enroll them all at once.
Properties
| Name | Meaning |
|---|---|
| Sequence ID | The unique identifier of the sequence to which contacts will be added. |
| Phonenumbers | A collection of one or more phone numbers representing contacts to add to the sequence. |
| Contacts ID | A collection of one or more contact IDs representing contacts to add to the sequence. |
- For Phonenumbers, you can specify multiple phone numbers.
- For Contacts ID, you can specify multiple contact IDs.
Output
The node outputs JSON data containing the response from the API call that adds the contacts to the sequence. The structure typically includes confirmation details such as success status, number of contacts added, or any relevant metadata returned by the service.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the WTS Chat API via an API key credential.
- The node uses the WTS Chat service's API endpoint to perform the addition of contacts to sequences.
- Proper configuration of the API key credential in n8n is necessary for authentication.
Troubleshooting
Error: "Add a contacts either by ID or phone number"
This error occurs if neither phone numbers nor contact IDs are provided. Ensure you supply at least one of these properties with valid values.API errors related to invalid sequence ID
If the sequence ID is missing or incorrect, the API will reject the request. Verify that the sequence ID is correct and not empty.Rate limiting or timeout issues
When adding large batches, the node waits 3 seconds between executions if processing multiple items. If you encounter delays or timeouts, consider reducing batch sizes or checking API rate limits.Invalid phone number format
Phone numbers should be in the expected format accepted by the API. Invalid formats may cause the API to reject the request.
Links and References
- WTS Chat API Documentation (general reference for API endpoints and usage)
- n8n documentation on Creating Custom Nodes
- Best practices for managing sequences and contacts in marketing automation platforms
If you need further details about other operations or resources, feel free to ask!