WTS Chat

Overview

This node integrates with the WTS Chat API to manage sequences and contacts within those sequences. Specifically, the "Add Contact To Sequence" operation allows users to add a contact to a specified sequence either by providing the contact's ID or their phone number.

Common scenarios where this node is beneficial include automating marketing or communication workflows where contacts need to be enrolled into predefined message sequences or campaigns. For example, after capturing a lead's information, you can automatically add them to a welcome or onboarding sequence to send scheduled messages.

Practical example:

• You have a sequence for new customers that sends a series of follow-up messages.
• When a new contact is created or identified, this node adds that contact to the sequence using their contact ID or phone number, triggering the sequence workflow.

Properties

Note: At least one of Contact ID or Phone Number must be provided to identify the contact.

Output

The output is an array of JSON objects representing the response from the WTS Chat API after attempting to add the contact to the sequence. The exact structure depends on the API response but typically includes confirmation details such as success status, sequence ID, contact details, or error information if the operation failed.

No binary data output is produced by this operation.

Dependencies

• Requires an active connection to the WTS Chat API via an API key credential configured in n8n.
• The node uses the WTS Chat service endpoints to perform operations related to sequences and contacts.
• No additional external dependencies are required beyond the API access.

Troubleshooting

• Error: "Add a contact either by ID or phone number"
  This error occurs if neither Contact ID nor Phone Number is provided. Ensure at least one identifier is supplied.

• API Authentication Errors
  If the API key is missing, invalid, or expired, the node will throw authentication errors. Verify that the API key credential is correctly set up in n8n.

• Sequence ID Empty or Invalid
  If the Sequence ID parameter is empty or incorrect, the API may reject the request. Confirm the Sequence ID is valid and exists in your WTS Chat account.

• Contact Not Found
  If the provided Contact ID or Phone Number does not correspond to an existing contact, the API may return an error. Double-check the contact identifiers.

• Rate Limiting or Timeout
  If adding multiple contacts in quick succession, the API might throttle requests. The node includes a delay between executions to mitigate this, but consider batching or pacing requests accordingly.

Links and References

• WTS Chat API Documentation (generic placeholder, replace with actual URL)
• n8n Documentation on Creating Custom Nodes
• Best practices for managing sequences and contacts in messaging platforms

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.