Skip to main content

​
How to connect

The setup steps below apply to both Odoo Web (cloud) and self-hosted Odoo instances. The API key generation process is the same.

​
Get your Odoo credentials

You’ll need three pieces of information from your Odoo account:

​
1. Odoo account username

This is the email address you use to log into Odoo.

​
2. Odoo database name

This is the first part of your Odoo URL. Example:
If your Odoo URL is https://your-company.odoo.com/odoo, your database name is your-company

​
3. Odoo API key

1

Log into Odoo

Open your Odoo account
2

Go to Preferences

Click your profile icon > Preferences
3

Navigate to Account Security

Select Account Security > New API Key
4

Create API key

  • Name: “Allo”
  • Duration: “Persistent Key”
Click Generate
5

Copy the API key

Copy the generated API key immediately.
You can only see the API key once. Store it securely.

​
Connect in Allo

1

Open Allo app

Launch Allo on mobile or desktop
2

Go to Integrations

Navigate to Settings > Integrations > Odoo
3

Enter credentials

Fill in the three required fields:
  • Odoo account username (your email)
  • Odoo database name
  • Odoo API key
4

Save and connect

Tap Save and wait for confirmation
Your Odoo contacts will sync to Allo automatically. Contact information displays during calls.

​
What syncs

From Odoo to Allo:
  • Contacts
Contacts created in Allo are not pushed to Odoo. Sync direction: One-way (Odoo → Allo).

​
How calls are synced

After each call, Allo creates a note on the matching contact in Odoo with the call summary and a link to the recording.

​
How SMS are synced

SMS sync is not available for this integration.

​
Click-to-call

Click on any phone number in Odoo to open the call directly in the Allo app. The Allo app must be installed on your device.

​
Troubleshooting

Check the sync status of any call from the call list on web.withallo.com — each call has an integration indicator showing its sync state.
Only admins and managers of an Allo workspace can connect integrations. If you don’t see the option, ask your workspace admin or manager to set it up.
Check the integration indicator on the call in the web app. The error will be one of these:
  • Contact not found — The contact doesn’t exist in your CRM. By default, Allo only syncs calls to existing contacts. To auto-create contacts, go to your integration settings and enable Create lead for unknown calls.
  • Contact deleted — The contact was removed from your CRM. Allo is additive and won’t sync calls for deleted contacts. Re-create the contact in your CRM, then retry the sync.
  • Integration disconnected — Your OAuth token or API key was revoked on the integration side. Allo still appears connected but requests fail. Disconnect and reconnect the integration in Allo.
  • Call pending (spinner icon) — Allo is still matching the contact. This can take up to 24 hours before being marked as an error. Once the contact exists in your CRM, you can retry manually.
The first sync can take up to 15 minutes for large contact databases. After that, contacts sync incrementally every 10 minutes — not in real time.Allo only syncs contacts that have at least one phone number in a native phone number field. Contacts without a phone number will not appear in Allo.If contacts still don’t appear after 15 minutes, disconnect and reconnect the integration.
This integration does not support SMS sync.
Allo mirrors your integration exactly. If your CRM has duplicate contacts with the same phone number, they appear as separate contacts in Allo.Clean up duplicates in your CRM — Allo will reflect the change on the next sync.
When multiple contacts share the same phone number, Allo syncs the call to all matching contacts. Before reporting a missing sync, check all contacts that share that phone number — the call may already be synced to another one. Click the integration indicator on any call in the web app to see exactly which contacts it was synced to.