Getting Started with O'Chat
Learn the basics of O'Chat and how it enables secure communication between Odoo instances.
What is O'Chat?
O'Chat is a peer-to-peer communication module that connects multiple Odoo instances together. It allows Odoo partners to communicate directly with their clients' Odoo instances — no email, no WhatsApp, no lost context.
Direct Communication
Messages flow directly between Odoo instances. Your client stays in their Odoo, you stay in yours.
End-to-End Encryption
All messages are encrypted with RSA-4096 + AES-256. Nobody can read your conversations.
Team Collaboration
Add colleagues to conversations. Full history preserved. Perfect for handovers.
Helpdesk Integration
Turn any message into a helpdesk ticket with /ticket. Context flows automatically.
How it works
O'Chat uses a central server to route messages between Odoo instances:
- Registration — Each Odoo instance registers with the central server and receives a unique ID and encryption keys.
- Connection — You send a connection request to another instance using their ID. They accept, and a secure channel is created.
- Messaging — Messages are encrypted on your side, routed through the server, and decrypted on the recipient's side. The server never sees plaintext.
- Tracking — Real-time delivery status: sent, delivered, read.
Prerequisites
Before you begin, ensure you have:
- Odoo 17, 18, or 19 (Community or Enterprise)
- System Administrator access to install modules
- Network access to the O'Chat central server
- Python dependency:
pycryptodome(installed automatically)
Quick start
Here's a 5-minute overview to get O'Chat running:
Install the module
Download O'Chat from the Odoo App Store and install it on your instance.
Register your instance
Go to Settings → O'Chat and click "Register". This generates your encryption keys.
Share your Instance ID
Send your Instance UUID to your client (or receive theirs).
Connect
Create a connection using their ID. Once accepted, you can start chatting!