im_livechat.channel: fields, relations and API
The im_livechat.channel model ("Livechat Channel") is a persistent model declared by the Live Chat module, then extended by 1 other module. It exposes 33 fields, 22 of them declared directly on the model; 7 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.
Model identity
- Technical name
im_livechat.channel- Label
- Livechat Channel
- Type
- Persistent (models.Model)
- SQL table
im_livechat_channel- Origin module
- Live Chat (
im_livechat) - Extended by
- website_livechat
- Inherits from (mixins)
- rating.parent.mixin
Model fields
22 own fields, 5 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.
33 of 33 fields shown
| Technical name | Label | Type | Details |
|---|---|---|---|
| are_you_inside | Are you inside the matrix? | boolean | read-onlycomputed |
| available_operator_ids | Available Operator | many2many | computed |
| block_assignment_during_call | No Chats During Call While on a call, agents will not receive new conversations. | boolean | |
| button_background_color | Button Background Color Default background color of the Livechat button | char | |
| button_text | Text of the Button | char | translatable |
| button_text_color | Button Text Color Default text color of the Livechat button | char | |
| channel_ids | Sessions | one2many | inverse: |
| chatbot_script_count | Number of Chatbot | integer | computed |
| default_message | Welcome Message This is an automated 'welcome' message that your visitor will see when they initiate a new conversation. | char | translatable |
| header_background_color | Header Background Color Default background color of the channel header once open | char | |
| max_sessions | Maximum Sessions Maximum number of concurrent sessions per operator. | integer | |
| max_sessions_mode | Sessions per Operator If limited, operators will only handle the selected number of sessions at a time. | selection | Values: |
| name | Channel Name | char | required |
| nbr_channel | Number of conversation | integer | read-onlycomputed |
| ongoing_session_count | Number of Ongoing Sessions | integer | computed |
| remaining_session_capacity | Remaining Session Capacity | integer | computed |
| review_link | Review Link Visitors who leave a positive review will be redirected to this optional link. | char | |
| rule_ids | Rules | one2many | inverse: |
| script_external | Script (external) | html | read-onlycomputed |
| title_color | Title Color Default title color of the channel once open | char | |
| user_ids | Agents | many2many | |
| web_page | Web Page URL to a static page where you client can discuss with the operator of the channel. | char | read-onlycomputed |
| rating_avg | Average Rating | float | computed inherited from rating.parent.mixin |
| rating_avg_percentage | Average Rating (%) | float | computed inherited from rating.parent.mixin |
| rating_count | # Ratings | integer | computed inherited from rating.parent.mixin |
| rating_ids | Ratings | one2many | inverse: inherited from rating.parent.mixin |
| rating_percentage_satisfaction | Rating Satisfaction Percentage of happy ratings | integer | computed inherited from rating.parent.mixin |
| create_date | Created on | datetime | read-onlyautomatic |
| create_uid | Created by | many2one | read-onlyautomatic |
| display_name | Display Name | char | read-onlycomputedautomatic |
| id | ID | integer | read-onlyautomatic |
| write_date | Last Updated on | datetime | read-onlyautomatic |
| write_uid | Last Updated by | many2one | read-onlyautomatic |
Relations
Models linked from this model
- discuss.channel: channel_ids
- im_livechat.channel.rule: rule_ids
- res.users: available_operator_ids, user_ids
Fields of other models pointing here
- discuss.channel: livechat_channel_id
- im_livechat.channel.member.history: session_livechat_channel_id
- im_livechat.channel.rule: channel_id
- im_livechat.report.channel: livechat_channel_id
- res.config.settings: channel_id
- res.users: livechat_channel_ids
- website: channel_id
Reading this model through the API
Odoo 19 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.
curl -X POST "https://your-instance.odoo.com/json/2/im_livechat.channel/search_read" \
-H "Authorization: bearer $ODOO_API_KEY" \
-H "X-Odoo-Database: your-db" \
-H "Content-Type: application/json" \
-d '{"domain":[],"fields":["name","block_assignment_during_call","button_background_color","button_text","button_text_color"],"limit":5}'import requests
BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}
res = requests.post(
f"{BASE_URL}/im_livechat.channel/search_read",
headers=headers,
json={"domain": [], "fields": ["name","block_assignment_during_call","button_background_color","button_text","button_text_color"], "limit": 5},
)
res.raise_for_status()
print(res.json())- External API access requires Odoo's Custom plan.
- XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
- The access rights and record rules of the key's user apply.
Cite this tool
Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.
<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/im_livechat-channel">im_livechat.channel (Odoo 19.0)</a>Sources
Data verified on September 23, 2026 · Odoo 19.0 Community
Have an Odoo project, or want to put your ERP to work with AI? Let's talk
Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.