N8N Tools - Tidio API

Complete Tidio integration - Live chat, AI chatbots, and customer engagement automation for SMB and e-commerce.

Features

• Live Chat: Real-time customer communication with instant responses
• AI Chatbots: Automated customer service with intelligent conversation flows
• Lead Generation: Capture and qualify leads through interactive chat widgets
• E-commerce Integration: Perfect for online stores and customer support
• Multi-Channel: Website chat, mobile apps, and social media integration
• Contact Management: CRM functionality with visitor tracking and properties
• Operator Management: Team collaboration with assignment and status controls
• Analytics: Conversation insights and performance metrics

Installation

npm install n8n-nodes-n8ntools-tidio-api

Requirements

• Tidio+ Plan: API access requires a paid Tidio+ subscription
• API Credentials: Generate from Tidio Panel → Developer → OpenAPI

Credentials

Configure Tidio API credentials in N8N:

1. N8N Tools API Key: Your N8N Tools API key for billing and usage tracking
   • Get it from: N8N Tools Dashboard - API Keys
   • Required for all operations (enables credit-based billing)
2. API URL: https://api.tidio.co (default)
3. Client ID: OpenAPI Client ID from Tidio Panel → Developer → OpenAPI
4. Client Secret: OpenAPI Client Secret from Tidio Panel → Developer → OpenAPI

Credit System

This node operates on N8N Tools' credit-based billing system:

• API Calls: 1 credit per basic API request
• Live Chat Operations: 2 credits per message/conversation
• Customer Management: 1-3 credits per contact operation
• Bulk Operations: Credits scale with data processed
• Real-time Tracking: Monitor usage in your N8N Tools dashboard

All requests are securely proxied through N8N Tools infrastructure for billing, monitoring, and enhanced reliability.

Operations

Conversation Management

• List Conversations: Get all conversations with pagination and filtering
• Get Conversation: Retrieve specific conversation details and history
• Create Conversation: Start new conversations with visitors
• Update Conversation: Modify conversation tags, priority, and department
• Close Conversation: End active conversations professionally
• Assign Conversation: Route conversations to specific operators
• Tag Management: Add and remove conversation tags for organization

Message Operations

• Send Message: Send text messages, files, and rich media
• Send Automated Message: Bot-generated responses and workflows
• Get Messages: Retrieve conversation message history
• Send Typing Indicator: Show active conversation engagement
• Send File: Share documents, images, and media files
• Send Quick Reply: Interactive buttons for user guidance

Visitor Management

• List Visitors: Get all website visitors and chat participants
• Get Visitor: Retrieve specific visitor information and activity
• Update Visitor: Modify visitor profiles and custom properties
• Track Visitor: Monitor visitor behavior and page interactions
• Set Custom Properties: Store custom visitor data and preferences

Contact Management

• List Contacts: Get all contacts with search and filtering
• Get Contact: Retrieve specific contact information
• Create Contact: Add new contacts to your database
• Update Contact: Modify contact details and properties
• Delete Contact: Remove contacts from your system
• Add to Mailing List: Subscribe contacts to email campaigns

Bot Operations

• Get Bot Flows: List available chatbot workflows
• Trigger Bot: Activate specific bot flows for visitors
• Update Bot Settings: Configure bot behavior and responses

Operator Management

• List Operators: Get all team members and agents
• Get Operator: Retrieve specific operator information
• Set Operator Status: Control online/offline/away status

Usage Examples

Start New Conversation

{
  "resource": "conversation",
  "operation": "createConversation",
  "visitorId": "visitor-123-abc",
  "additionalFields": {
    "tags": "support,priority",
    "department": "technical-support",
    "priority": "high"
  }
}

Send Welcome Message

{
  "resource": "message",
  "operation": "sendMessage",
  "conversationId": "conv-456-def",
  "messageType": "text",
  "messageText": "Hello! Welcome to our support chat. How can I help you today?"
}

Send Quick Reply Options

{
  "resource": "message",
  "operation": "sendQuickReply",
  "conversationId": "conv-456-def",
  "messageText": "What type of assistance do you need?",
  "quickReplyOptions": "Technical Support,Billing Question,General Inquiry"
}

Update Visitor Information

{
  "resource": "visitor",
  "operation": "updateVisitor",
  "visitorId": "visitor-789-ghi",
  "additionalFields": {
    "visitorName": "John Smith",
    "visitorEmail": "john@example.com",
    "visitorPhone": "+1234567890",
    "customProperties": {
      "company": "ACME Corp",
      "plan": "enterprise",
      "signup_date": "2024-01-15"
    }
  }
}

Assign to Operator

{
  "resource": "conversation",
  "operation": "assignConversation",
  "conversationId": "conv-456-def",
  "operatorId": "operator-123"
}

Create New Contact

{
  "resource": "contact",
  "operation": "createContact",
  "additionalFields": {
    "contactName": "Jane Doe",
    "contactEmail": "jane@example.com",
    "contactPhone": "+1987654321"
  }
}

Message Types

Text Messages

• Plain text with emoji support
• Markdown formatting for rich text
• URL detection and link previews

Quick Replies

• Interactive button options
• Streamlined user responses
• Conversation flow guidance

File Attachments

• Images, documents, and media files
• Drag-and-drop file sharing
• File type validation and size limits

Rich Media

• Image galleries and carousels
• Video and audio file support
• Custom file previews

SMB and E-commerce Features

Lead Qualification

• Automated lead scoring and routing
• Custom qualification questions
• Integration with sales pipelines

Customer Support

• Ticket creation and tracking
• Knowledge base integration
• Escalation and handoff procedures

E-commerce Integration

• Order status inquiries
• Product recommendations
• Cart abandonment recovery

Marketing Automation

• Proactive chat triggers
• Visitor behavior targeting
• Campaign performance tracking

Visitor Tracking

Page Tracking

Monitor visitor behavior across your website with detailed page view analytics and user journey mapping.

Custom Properties

Store custom visitor data including:

• Company information and industry
• Product interests and preferences
• Purchase history and customer value
• Support ticket history

Real-time Activity

Track active visitor sessions, current page views, and engagement metrics for proactive customer service.

Team Collaboration

Operator Management

• Online/offline status control
• Department and skill-based routing
• Performance metrics and reporting

Conversation Assignment

• Manual and automatic assignment rules
• Load balancing across team members
• Escalation and transfer procedures

Internal Notes

• Private operator notes and context
• Customer history and preferences
• Handoff instructions and priorities

Rate Limiting

Tidio API enforces rate limits per project to ensure service stability. Monitor API usage and implement appropriate retry logic.

Support

• Documentation: Tidio Developers
• Issues: GitHub Issues