Actions13
- Chatwoot Integration Actions
- Instance Actions
- Message Actions
- Parser Actions
- Webhook Actions
Overview
The "Sync Contact" operation of the Chatwoot Integration resource in this node is designed to create or update a contact in Chatwoot based on provided phone number and contact name information. This operation is useful for keeping your Chatwoot contact list synchronized with external data sources, such as WhatsApp contacts managed via MegaAPI.
Typical use cases include:
- Automatically adding new WhatsApp contacts into Chatwoot when they first interact.
- Updating existing Chatwoot contacts with new phone numbers or names from an external system.
- Ensuring that Chatwoot has up-to-date contact information for better customer engagement and messaging.
For example, if you receive a new WhatsApp contact through MegaAPI, you can use this node operation to sync that contact into Chatwoot so that agents can easily manage conversations with that contact.
Properties
| Name | Meaning |
|---|---|
| Chatwoot Account ID | Your Chatwoot account identifier where the contact will be created or updated. |
| Chatwoot Inbox ID | The specific Chatwoot inbox ID used for WhatsApp messages related to this contact. |
| Phone Number | The phone number of the contact to create or update in Chatwoot. |
| Contact Name | The display name of the contact in Chatwoot (optional). |
Output
The output JSON object contains the result of the contact synchronization operation. Typically, it includes details about the created or updated contact in Chatwoot, such as contact ID, phone number, and name. This allows subsequent nodes in the workflow to reference the contact for further actions like creating conversations or sending messages.
No binary data output is produced by this operation.
Dependencies
- Requires access to a Chatwoot account with appropriate permissions to create or update contacts.
- Needs valid API credentials or authentication tokens configured in n8n to communicate securely with Chatwoot.
- The Chatwoot Inbox ID must correspond to an existing inbox configured for WhatsApp messages.
Troubleshooting
- Missing or invalid Chatwoot Account ID or Inbox ID: Ensure these IDs are correctly entered and correspond to your Chatwoot setup.
- Invalid phone number format: Phone numbers should be in a format accepted by Chatwoot and WhatsApp (usually including country code).
- API authentication errors: Verify that the API key or authentication token used for Chatwoot is valid and has sufficient permissions.
- Contact not syncing: Check network connectivity and Chatwoot service status; enable detailed logs if available to trace issues.
- Error messages indicating unknown operations or resources: Confirm that the node's Resource is set to "Chatwoot Integration" and Operation to "Sync Contact".