Actions39
- Panel Actions
- Message Actions
- Chatbot Actions
- Contact Actions
- Sequence Actions
- Session Actions
Overview
This node updates an existing contact in the WTS Chat system. It allows users to specify the contact by its ID and update various fields such as name, phone number, email, Instagram handle, annotation, tags, portfolios, sequences, status, picture URL, custom fields, metadata, and UTM parameters. This operation is useful for maintaining up-to-date contact information in CRM workflows, marketing automation, or customer support scenarios.
Use Case Examples
- Updating a contact's email and phone number after receiving new information from a customer.
- Adding tags and custom metadata to a contact for segmentation purposes.
- Changing the status of a contact to 'Active' or 'Blocked' based on their engagement.
Properties
| Name | Meaning |
|---|---|
| Contact ID | The unique identifier of the contact to update. |
| Fields | The list of contact fields to update, such as Name, Email, PhoneNumber, Tags, CustomFields, Metadata, etc. |
| Name | The new name of the contact, if updating the Name field. |
| Phonenumber | The new phone number of the contact, if updating the PhoneNumber field. |
| The new email address of the contact, if updating the Email field. | |
| The new Instagram handle of the contact, if updating the Instagram field. | |
| Annotation | The new annotation text for the contact, if updating the Annotation field. |
| Tag Names or IDs | Tags to associate with the contact, if updating the Tags field. Can be selected from a list or specified by IDs. |
| Portfolio Names or IDs | Portfolios to associate with the contact, if updating the Portfolio field. Can be selected from a list or specified by IDs. |
| Sequence Names or IDs | Sequences to associate with the contact, if updating the SequenceIds field. Can be selected from a list or specified by IDs. |
| Status | The new status of the contact, if updating the Status field. Options include Active, Archived, Blocked, or Empty (Not Sent). |
| Picture Url | The new picture URL of the contact, if updating the PictureUrl field. |
| Custom Fields | Custom key-value fields to update for the contact, if updating the CustomFields field. |
| Metadata | Metadata key-value pairs to update for the contact, if updating the Metadata field. |
| Source UTM | UTM source parameter for marketing tracking, if updating the Utm field. |
| Medium UTM | UTM medium parameter for marketing tracking, if updating the Utm field. |
| Campaign UTM | UTM campaign parameter for marketing tracking, if updating the Utm field. |
| Content UTM | UTM content parameter for marketing tracking, if updating the Utm field. |
| Headline UTM | UTM headline parameter for marketing tracking, if updating the Utm field. |
| Term UTM | UTM term parameter for marketing tracking, if updating the Utm field. |
| Referral Url UTM | UTM referral URL parameter for marketing tracking, if updating the Utm field. |
Output
JSON
json- The updated contact object returned from the WTS API.
Dependencies
- An API key credential for WTS API authentication.
Troubleshooting
- Ensure the Contact ID is provided and not empty; otherwise, the node will throw an error indicating the ContactID is empty.
- When updating email, the email format is validated; invalid emails will cause an error.
- If updating fields includes Metadata or CustomFields, ensure the key-value pairs are correctly formatted.
- If the API key credential is missing or invalid, the node will fail to authenticate with the WTS API.
- If any required field for the update is missing or invalid, the node will throw an error with a descriptive message.