ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions100

Overview

This node allows you to add a new canned response to a specific account in ChatWoot. Canned responses are pre-defined messages that can be quickly inserted into conversations, improving efficiency and consistency for support teams. This operation is useful when you want to programmatically manage or update your team's quick-reply templates within ChatWoot from n8n workflows.

Example scenarios:

  • Automatically create standard replies for new accounts during onboarding.
  • Bulk import frequently used responses from another system.
  • Update or maintain canned responses as part of workflow automation.

Properties

Display Name Type Description
Account Id Number The numeric ID of the account where the canned response will be added. (Required)
Content String Message content for the canned response.
Short Code String Short code for quick access to the canned response.

Output

The output will contain the JSON response from the ChatWoot API after creating the canned response. Typically, this includes details such as the ID, content, short code, and metadata about the newly created canned response.

Example output structure:

{
  "id": 123,
  "content": "Thank you for reaching out!",
  "short_code": "thanks",
  "account_id": 456,
  "created_at": "2024-06-01T12:34:56Z",
  "updated_at": "2024-06-01T12:34:56Z"
}

Note: The actual fields may vary depending on the ChatWoot API version.

Dependencies

  • External Service: Requires access to a ChatWoot instance with API enabled.
  • API Credentials: You must configure the chatwootApi credential in n8n, including the base URL and authentication token.
  • n8n Configuration: Ensure the node has network access to your ChatWoot server.

Troubleshooting

  • Missing or Invalid Credentials:
    Error message: "401 Unauthorized" or "Invalid credentials"
    Resolution: Check that your chatwootApi credentials are correctly set up in n8n.

  • Account Not Found:
    Error message: "404 Not Found"
    Resolution: Verify that the provided Account Id exists in your ChatWoot instance.

  • Validation Errors:
    Error message: "400 Bad Request"
    Resolution: Ensure all required fields (Account Id, Content, Short Code) are provided and valid.

  • Network Issues:
    Error message: "ENOTFOUND" or "ECONNREFUSED"
    Resolution: Make sure n8n can reach your ChatWoot server and the base URL is correct.

Links and References

Discussion