This guide explains how to install and configure the Aircall integration with Odoo Online. The Aircall to Odoo Online integration supports Odoo version 18. It works with the following Odoo apps:

  • Contacts
  • CRM
  • HelpDesk

Pricing

The integration is available at no additional cost, apart from your existing Odoo and Aircall subscriptions.

Important: Odoo may apply extra charges for using Marketplace apps or supporting custom code. Aircall provides full support if you encounter issues with the integration. Please contact our customer support team for assistance.
Note: The integration does not work with the Odoo mobile application.

Installation

Steps:

  1. Go to the Odoo App Store and search for Aircall, or click here to view available modules.
  2. Select your preferred module and download it.
  3. Open your Odoo Online app.
  4. Navigate to the Apps section.
  5. Enable Developer Mode in settings (required to see the Upload module option).
  6. Click Upload module.
  7. Select the file you downloaded from your computer and upload it.
  8. Once uploaded, locate the module in the Apps section.
  9. Click Install.

Configuration

The integration relies on API keys and webhooks. Configuration requires actions in both Aircall and Odoo.

Create Aircall API keys

  1. In the Aircall Dashboard > API Keys.
  2. Click Generate API Key.
  3. Give the key a name.
  4. Save both the API ID and API Token securely.
Important: You will only see the API Token once. If lost, you must generate a new set of keys.
  1. Click Confirm to save.

Odoo setup

  1. Ensure Developer Mode is enabled in Odoo.
  2. From the main Odoo dashboard, open the Aircall app.
  3. Click Configuration (next to the Aircall logo).
  4. Click New to create a configuration record.
  5. Enter a name, for example: Default configuration.
  6. Paste the API ID and API Token from above.
  7. Enable the modules and settings you want to use.
    • When you enable a module, a new tab appears at the bottom of the configuration screen.
    • For each enabled module, open the tab and click Connect all.
1.png
  1. If the API details are correct, your Aircall numbers will connect (highlighted in purple).
  2. Click Save to finish.
    • To edit later, return to the configuration screen and select your record.
2.png

Create an Aircall webhook

To ensure Odoo receives events such as new calls, messages, and conversation intelligence data, you must configure a webhook in Aircall.

Steps:

  1. In the Odoo Aircall configuration screen (Step 2), copy the Webhook URL.
  2. In the Aircall Dashboard, go to Discover integrations.
  3. Scroll to Webhooks (integrations are listed alphabetically) or use the search bar.
  4. Click Webhooks, then click Install.
  5. Give the webhook a name of your choice.
  6. Paste the Webhook URL from Odoo.
  7. Enable the following events:
    • Call events: call.created, call.ended, call.commented, call.tagged, call.untagged
    • Contact events: contact.created
    • Message events: message.sent, message.received
    • Conversation Intelligence events: sentiment.created, summary.created, topics.created, transcription.created
  8. Click Add webhook at the bottom to save.
Important: The Odoo integration does not support multi-company Odoo environment.

Uninstalling the integration

To remove the Aircall integration from Odoo:

  1. Go to Apps.
  2. Remove any filters.
  3. Search for Aircall.
  4. Click Uninstall on the module(s).