ChatWootInstall

Overview

This node integrates with the ChatWoot API to create a new inbox association for a contact. It is useful when you want to link a specific contact to an inbox within your ChatWoot account, enabling message routing and management for that contact through the specified inbox.

Practical examples include:

• Automatically assigning newly created or updated contacts to particular inboxes based on business rules.
• Organizing contacts by their communication channels or departments by associating them with different inboxes.
• Synchronizing external CRM contacts with ChatWoot inboxes for unified messaging.

Properties

Output

The node outputs JSON data representing the result of the inbox creation operation for the contact. This typically includes details about the newly created contact-inbox association such as IDs and status confirmation.

If the API supports it, the output may also contain metadata or error messages related to the operation.

No binary data output is expected from this node.

Dependencies

• Requires an API key credential for authenticating with the ChatWoot API.
• The node uses the base URL configured in the credentials to send requests.
• The ChatWoot API must be accessible and properly configured to allow contact inbox creation.

Troubleshooting

• Common issues:

  • Invalid or missing Account Id, Contact Id, or Inbox Id can cause request failures.
  • Network connectivity problems or incorrect API base URL configuration.
  • Insufficient permissions for the API key to create contact inbox associations.

• Error messages:

  • Authentication errors indicate invalid or expired API credentials; verify and update the API key.
  • Validation errors usually specify which required property is missing or invalid; ensure all required fields are correctly set.
  • API rate limits or server errors should be retried after some time or checked with ChatWoot service status.

Links and References

• ChatWoot API Documentation
• n8n Documentation on Creating Custom Nodes