n8n-nodes-livechat-cloudbot

This package provides n8n community nodes for LiveChat CloudBot integration, allowing you to:

• 🤖 Send messages to CloudBot AI
• 💬 Handle chat webhooks and triggers
• 🎨 Generate embeddable chat widgets
• 📊 Manage chat sessions and history
• 👥 Support human agent handoff

Installation

Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install a Community Node
3. Enter: n8n-nodes-livechat-cloudbot
4. Click Install

Manual Installation

# In your n8n installation directory
npm install n8n-nodes-livechat-cloudbot

Setup

1. Configure Credentials

1. Go to Credentials in n8n
2. Click Add Credential
3. Select LiveChat CloudBot API
4. Fill in your CloudBot details:
   • API Key: Your CloudBot API key
   • Endpoint: CloudBot API URL (e.g., https://api.cloudbot.com)
   • Bot ID: Your bot identifier
   • Environment: production/staging/development

2. Create Workflow

Add these nodes to your workflow:

LiveChat Trigger Node

• Handles incoming chat messages
• Supports multiple event types
• Configurable response modes

LiveChat CloudBot Node

• Send messages to AI bot
• Generate widget code
• Manage chat sessions

Usage Examples

Basic Chat Bot

LiveChat Trigger → Set Variables → LiveChat CloudBot → Response

1. LiveChat Trigger: Listen for sendMessage events
2. Set: Extract user message and session ID
3. LiveChat CloudBot: Send to AI bot with operation Send Message
4. Response: Return bot response to user

Widget Generation

Manual Trigger → LiveChat CloudBot → Email/Slack

1. Manual Trigger: Start workflow manually
2. LiveChat CloudBot: Use Generate Widget Code operation
3. Email/Slack: Send generated HTML code to developers

Advanced Chat with Agent Handoff

LiveChat Trigger → Switch → [Bot Path / Agent Path] → Response

1. LiveChat Trigger: Listen for multiple events
2. Switch: Route based on event type or keywords
3. Bot Path: Handle with AI bot
4. Agent Path: Notify human agents
5. Response: Send appropriate response

Node Reference

LiveChat Trigger

Events:

• sendMessage - User sends message
• startSession - New chat session
• endSession - Session ends
• requestAgent - Agent requested
• loadPreviousSession - Load chat history

Response Modes:

• text - Simple text response
• json - Structured JSON response
• noResponse - No webhook response

LiveChat CloudBot

Operations:

• sendMessage - Send message to bot
• getHistory - Get session history
• endSession - End chat session
• generateWidget - Generate HTML widget code

Parameters:

• Message: Text to send to bot
• Session ID: Chat session identifier
• Context: Additional JSON context
• Widget Mode: window/fullscreen/inline
• Language: UI language (en, vi, fr, de, etc.)
• Theme Color: Primary color for widget

Widget Integration

The generated widget code can be embedded in any website:

<!-- Generated by LiveChat CloudBot Node -->
<link href="https://unpkg.com/n8n-livechat-cloudbot/dist/style.css" rel="stylesheet" />
<script type="module">
    import { createLiveChat } from 'https://unpkg.com/n8n-livechat-cloudbot/dist/livechat.es.js';
    
    createLiveChat({
        webhookUrl: 'https://your-n8n.com/webhook/livechat-webhook',
        cloudbotEndpoint: 'https://api.cloudbot.com',
        cloudbotApiKey: 'your-api-key',
        mode: 'window',
        defaultLanguage: 'en',
        enableLiveAgent: true
    });
</script>
<div id="n8n-livechat"></div>

Workflow Templates

Customer Support Bot

• Auto-respond to common questions
• Escalate complex issues to agents
• Track conversation analytics

Lead Generation Chat

• Qualify leads with AI
• Collect contact information
• Integration with CRM systems

Multi-language Support

• Detect user language
• Route to appropriate bot/agent
• Provide localized responses

Troubleshooting

Common Issues

Authentication Failed

• Verify API key and endpoint
• Check bot ID is correct
• Ensure credentials are saved

Webhook Not Triggered

• Check webhook URL is accessible
• Verify CORS settings in n8n
• Test with manual webhook call

Widget Not Loading

• Ensure CDN links are correct
• Check browser console for errors
• Verify webhook URL in widget config

Debug Mode

Enable debug logging in n8n:

export N8N_LOG_LEVEL=debug

Support

• 📧 Email: [email protected]
• 💬 Discord: CloudBot Community
• 📖 Docs: https://docs.cloudbot.com
• 🐛 Issues: GitHub Issues

License

MIT - see LICENSE.md

Contributing

Contributions welcome! See CONTRIBUTING.md

Made with ❤️ for the n8n community