N8N Tools - Tidio API icon

N8N Tools - Tidio API

Complete Tidio integration - Live chat, AI chatbots, and customer engagement

Actions31

Message → Send Quick Reply

AI-generated

Overview

This node integrates with the Tidio API to manage live chat conversations and send various types of messages within those conversations. Specifically, the Send Quick Reply operation under the Message resource allows users to send a message containing quick reply buttons in an ongoing conversation. This is useful for engaging customers interactively by providing predefined response options that they can click on, streamlining communication and improving user experience.

Practical scenarios include:

  • Customer support agents sending quick reply options like "Yes", "No", or "More Info" to guide the conversation.
  • Automated chatbot flows offering users choices to navigate through different topics.
  • Marketing campaigns prompting users to select from multiple offers or actions directly within the chat.

Properties

Name Meaning
Conversation ID The unique identifier of the conversation where the quick reply message will be sent.
Message Text The text content of the message that accompanies the quick reply buttons.
Quick Reply Options Comma-separated list of quick reply button labels; each label becomes a clickable option.
Additional Fields Optional extra data including visitor/contact info, tags, custom properties, bot flow triggers, and message sending options such as sending as bot.

Details of Additional Fields (subset relevant to this operation)

  • Visitor Name, Email, Phone: Information about the visitor.
  • Tags: Comma-separated tags related to the conversation.
  • Custom Properties: JSON object for any custom metadata.
  • Send As Bot: Boolean flag to send the message as a bot instead of an operator.

Output

The node outputs a JSON object representing the response from the Tidio API after sending the quick reply message. This typically includes details about the sent message such as its ID, content, type, timestamps, and status.

If the operation fails, the output JSON contains an error field with the error message.

The node does not output binary data for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Tidio API.
  • Needs configuration of the Tidio API base URL and client credentials (Client ID and Client Secret).
  • Uses an external proxy service (https://n8ntools.io/api/v1/proxy/tidio) to forward requests to the Tidio API.
  • Requires network access to the proxy endpoint and Tidio API.

Troubleshooting

  • Common Issues:

    • Invalid or missing Conversation ID will cause the API call to fail.
    • Improperly formatted quick reply options (e.g., empty string or missing commas) may result in no buttons being sent.
    • Authentication errors if API keys or client credentials are incorrect or expired.
    • Network issues preventing access to the proxy or Tidio API.

  • Error Messages:

    • "Unknown message operation: sendQuickReply": Indicates a misconfiguration or unsupported operation name.
    • API authentication errors usually mention invalid credentials or unauthorized access.
    • JSON parsing errors if quickReplyOptions or other JSON fields are malformed.

  • Resolutions:

    • Verify all required parameters are provided and correctly formatted.
    • Check and update API credentials in n8n credentials settings.
    • Ensure the proxy service is reachable and operational.
    • Use the node's "Continue On Fail" option to handle errors gracefully during workflows.

Links and References

Discussion