Actions38
- 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 specified sequence by providing either their phone numbers or contact IDs. This node is useful for automating marketing, sales, or communication workflows where you want to enroll multiple contacts into a predefined sequence of messages or actions.
Typical use cases include:
- Adding a batch of new leads or customers to an automated follow-up sequence.
- Enrolling contacts from different sources (phone numbers or internal contact IDs) into a campaign sequence.
- Managing contact lists dynamically by programmatically adding them to sequences based on external triggers.
Example: You have a list of phone numbers collected from a web form and want to add all these contacts to a welcome message sequence automatically.
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. |
Notes:
- At least one of "Phonenumbers" or "Contacts ID" must be provided.
- Both fields accept multiple values.
Output
The node outputs a JSON object containing the response from the API call that adds the contacts to the sequence. The structure typically includes confirmation details about the added contacts and the sequence status.
No binary data output is involved in this operation.
Dependencies
- Requires an active API key credential for authentication with the WTS Chat API.
- The node depends on the external WTS Chat service API endpoint to perform the addition of contacts to sequences.
- Proper configuration of the API base URL (
https://api.wts.chat) and valid credentials are necessary.
Troubleshooting
- Missing Sequence ID: If the sequence ID is empty or invalid, the node will throw an error indicating the sequence ID must be provided.
- No Contacts Provided: If neither phone numbers nor contact IDs are supplied, the node throws an error instructing to add contacts either by ID or phone number.
- Invalid Phone Numbers or Contact IDs: Ensure that the phone numbers and contact IDs are correctly formatted and exist in the system; otherwise, the API may reject the request.
- API Authentication Errors: If the API key is missing or invalid, the node will fail with an authentication error.
- Network or API Errors: General network issues or API downtime can cause errors; retry or check API status if such errors occur.
Links and References
- WTS Chat API Documentation (generic placeholder link)
- n8n documentation on Creating Custom Nodes
- Best practices for managing sequences and contacts in marketing automation systems