Actions39
- Chatbot Actions
- Contact Actions
- Message Actions
- Panel Actions
- Sequence Actions
- Session Actions
Overview
The "Add Contact To Sequence" operation in the WTS Chat n8n node allows you to add a contact to a specific sequence, either by providing the contact's ID or their phone number. This is useful for automating marketing, onboarding, or notification workflows where contacts need to be enrolled into predefined communication sequences.
Common scenarios:
- Automatically enrolling new leads into a drip campaign.
- Adding users to a follow-up sequence after a specific event.
- Managing customer journeys by programmatically assigning contacts to sequences based on triggers.
Example:
When a new user signs up on your platform, you can use this node to add them to a welcome message sequence using their phone number or contact ID.
Properties
| Display Name | Type | Description |
|---|---|---|
| Sequence ID | String | The unique identifier of the sequence to which the contact will be added. |
| Contact ID | String | The unique identifier of the contact to add. Optional if Phone Number used. |
| Phone Number | String | The phone number of the contact to add. Optional if Contact ID used. |
Usage Notes:
- You must provide at least one of "Contact ID" or "Phone Number". If both are empty, the node will throw an error.
- "Sequence ID" is always required.
Output
The output is a JSON object containing the result of the add-to-sequence operation as returned by the WTS API. The structure depends on the API response but typically includes status and details about the addition.
Example output:
[
{
"json": {
// ...fields as returned by the WTS API, e.g.,
"success": true,
"message": "Contact added to sequence",
"sequenceId": "12345",
"contactId": "67890"
}
}
]
Dependencies
- External Service: Requires access to the WTS Chat API.
- API Key: You must configure valid WTS API credentials (
wtsApi) in n8n. - n8n Configuration: No special environment variables beyond standard credential setup.
Troubleshooting
Common Issues:
Missing Required Fields: If neither "Contact ID" nor "Phone Number" is provided, the node will throw an error:
"Add a contact either by ID or phone number"- Resolution: Ensure at least one of these fields is filled.
Invalid Sequence ID: If "Sequence ID" is missing or invalid, the API may return an error.
- Resolution: Double-check that the correct sequence ID is provided.
API Authentication Errors: Invalid or missing API key will cause authentication failures.
- Resolution: Verify your WTS API credentials in n8n.
Error Messages Explained:
- "Add a contact either by ID or phone number"
→ Both "Contact ID" and "Phone Number" are empty. Provide at least one. - Other errors will reflect issues from the WTS API (e.g., invalid IDs, network problems).
Links and References
- WTS Chat Documentation (for API details)
- n8n Credentials Documentation
- n8n Node Development Guide