ChatWoot

Overview

This node interacts with the ChatWoot API to retrieve a list of inboxes that are contactable for a specific contact within a given account. It is useful in scenarios where you need to determine through which inboxes a particular contact can be reached, such as routing messages, managing communication channels, or automating workflows based on available contact points.

Practical examples:

• Fetching all inboxes where a customer (contact) can be messaged.
• Automating assignment of conversations to available inboxes for a contact.
• Integrating with CRM systems to display or use available contact channels.

Properties

Both properties are required and must be provided to fetch the contactable inboxes for the specified contact.

Output

The output will be a JSON object containing information about the inboxes that are contactable for the specified contact. The structure typically includes an array of inbox objects, each representing an inbox with its relevant details (such as id, name, type, etc.).

Example output:

{
  "inboxes": [
    {
      "id": 123,
      "name": "Support",
      "channel_type": "Email",
      // ...other inbox fields
    },
    {
      "id": 456,
      "name": "Sales",
      "channel_type": "Chat",
      // ...other inbox fields
    }
  ]
}

Note: The exact fields depend on the ChatWoot API response.

Dependencies

• External Service: Requires access to the ChatWoot API.
• API Credentials: You must configure chatwootApi credentials in n8n, including the base URL and authentication token.
• n8n Configuration: Ensure the node is properly authenticated and has network access to the ChatWoot instance.

Troubleshooting

Common issues:

• Invalid Account Id or Contact Id: If either ID is incorrect or does not exist, the API may return a 404 error or an empty result.
• Authentication Errors: Missing or invalid API credentials will result in authentication errors (e.g., 401 Unauthorized).
• Network Issues: If n8n cannot reach the ChatWoot server, you may encounter connection errors.

Error messages and resolutions:

• "401 Unauthorized": Check your API credentials and ensure they are correctly configured in n8n.
• "404 Not Found": Verify that both the Account Id and Contact Id are correct and exist in your ChatWoot instance.
• "Connection refused" or timeout errors: Ensure the ChatWoot API URL is reachable from your n8n environment.

Links and References

• ChatWoot API Documentation
• n8n Documentation: Credentials
• n8n Community Forum