> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Odoo

> Automatically recognize contacts from your Odoo CRM and log all calls and messages

<iframe src="https://www.youtube.com/embed/NjyDPYIT0XM" title="YouTube video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

## How to connect

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

### 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

<Steps>
  <Step title="Log into Odoo">
    Open your Odoo account
  </Step>

  <Step title="Go to Preferences">
    Click your profile icon > **Preferences**
  </Step>

  <Step title="Navigate to Account Security">
    Select **Account Security** > **New API Key**
  </Step>

  <Step title="Create API key">
    * Name: "Allo"
    * Duration: "Persistent Key"

    Click **Generate**
  </Step>

  <Step title="Copy the API key">
    Copy the generated API key immediately.

    <Warning>
      You can only see the API key once. Store it securely.
    </Warning>
  </Step>
</Steps>

### Connect in Allo

<Steps>
  <Step title="Open Allo app">
    Launch Allo on mobile or desktop
  </Step>

  <Step title="Go to Integrations">
    Navigate to **Settings** > **Integrations** > **Odoo**
  </Step>

  <Step title="Enter credentials">
    Fill in the three required fields:

    * Odoo account username (your email)
    * Odoo database name
    * Odoo API key
  </Step>

  <Step title="Save and connect">
    Tap **Save** and wait for confirmation
  </Step>
</Steps>

<Info>
  Your Odoo contacts will sync to Allo automatically. Contact information displays during calls.
</Info>

## 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](https://web.withallo.com)** — each call has an integration indicator showing its sync state.

<AccordionGroup>
  <Accordion title="I cannot connect my integration">
    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.
  </Accordion>

  <Accordion title="Call not synced to my integration">
    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.
  </Accordion>

  <Accordion title="Contacts not syncing">
    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.
  </Accordion>

  <Accordion title="SMS not synced">
    This integration does not support SMS sync.
  </Accordion>

  <Accordion title="Duplicate contacts">
    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.
  </Accordion>

  <Accordion title="Call synced to the wrong contact">
    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.
  </Accordion>
</AccordionGroup>