Live Chat Integration in Odoo 19:
Convert Visitors into Leads in Real Time

import xmlrpc.client

url = 'https://erp.yourcompany.com'
db = 'production'
uid = 2  # admin user ID
password = 'your_api_key'

models = xmlrpc.client.ServerProxy(f'{{url}}/xmlrpc/2/object')

# Create a Sales live chat channel
channel_id = models.execute_kw(db, uid, password,
    'im_livechat.channel', 'create', [{
        'name': 'Sales - Website',
        'button_text': 'Chat with Sales',
        'default_message': 'Hi! How can we help you today?',
        'input_placeholder': 'Type your question...',
        'header_background_color': '#1B5E3B',
        'title_color': '#FFFFFF',
        'button_background_color': '#1B5E3B',
        'button_text_color': '#FFFFFF',
    }])

print(f'Created channel ID: {{channel_id}}')

<!-- Odoo 19 Live Chat Widget -->
<script type="text/javascript">
  (function () {
    var script = document.createElement('script');
    script.type = 'text/javascript';
    script.async = true;
    script.src = 'https://erp.yourcompany.com/im_livechat/loader/1';
    // The number at the end is your channel ID
    var s = document.getElementsByTagName('script')[0];
    s.parentNode.insertBefore(script, s);
  })();
</script>

<!-- CORS: Ensure your Odoo server allows the external domain -->
<!-- In odoo.conf, add: -->
<!-- http_allowed_origins = https://www.yourwebsite.com -->

# Get user IDs for your sales team
sales_user_ids = models.execute_kw(db, uid, password,
    'res.users', 'search', [[
        ('groups_id', 'in', [
            models.execute_kw(db, uid, password,
                'ir.model.data', 'check_object_reference',
                ['sales_team', 'group_sale_salesman'])[1]
        ])
    ]])

# Add all salespeople as operators on the Sales channel
models.execute_kw(db, uid, password,
    'im_livechat.channel', 'write', [[channel_id], {
        'user_ids': [(4, uid) for uid in sales_user_ids],
    }])

# Get visitors currently on the website (last 5 minutes)
from datetime import datetime, timedelta

five_min_ago = (datetime.utcnow() - timedelta(minutes=5)).strftime(
    '%Y-%m-%d %H:%M:%S'
)

active_visitors = models.execute_kw(db, uid, password,
    'website.visitor', 'search_read', [[
        ('last_connection_datetime', '>=', five_min_ago),
    ]], {
        'fields': [
            'display_name', 'email', 'country_id',
            'visit_count', 'page_count', 'visitor_page_count',
            'last_visited_page_id', 'livechat_operator_id',
        ],
        'limit': 50,
    })

for v in active_visitors:
    status = 'In chat' if v['livechat_operator_id'] else 'Browsing'
    print(f"[{{status}}] {{v['display_name']}} — "
          f"{{v['page_count']}} pages, "
          f"{{v['visit_count']}} visits — "
          f"Country: {{v['country_id']}}")

# Auto-popup on the pricing page after 15 seconds
models.execute_kw(db, uid, password,
    'im_livechat.channel.rule', 'create', [{
        'channel_id': channel_id,
        'action': 'auto_popup',
        'auto_popup_timer': 15,
        'regex_url': '/pricing',
    }])

# Show button (no popup) on product pages
models.execute_kw(db, uid, password,
    'im_livechat.channel.rule', 'create', [{
        'channel_id': channel_id,
        'action': 'display_button',
        'regex_url': '/shop/.*',
    }])

# Hide chat entirely on blog content pages
models.execute_kw(db, uid, password,
    'im_livechat.channel.rule', 'create', [{
        'channel_id': channel_id,
        'action': 'hide_button',
        'regex_url': '/blog/.*',
    }])

# Find and update the helpdesk team
helpdesk_team_ids = models.execute_kw(db, uid, password,
    'helpdesk.team', 'search', [[
        ('name', '=', 'Customer Support'),
    ]])

if helpdesk_team_ids:
    models.execute_kw(db, uid, password,
        'helpdesk.team', 'write', [helpdesk_team_ids, {
            'use_website_helpdesk_livechat': True,
        }])

# Tickets created from live chat include:
# - Full conversation transcript in the ticket description
# - Link to the original chat session
# - Visitor/customer contact information
# - Pages visited before starting the chat