🤖 Gemini AI – Contact Enrichment

Automatically enrich your Odoo contacts using Google Gemini AI

✨ Main Features

AI Enrichment

Gemini analyses the contact's name, email, and website to suggest reliable complementary data.

Validate before applying

Preview suggestions field by field and choose exactly what to apply. Nothing is changed without your approval.

Bulk Enrichment

Select multiple contacts in the list and launch a group enrichment in a single action.

Full history

Every API call is logged: prompt sent, raw response, tokens consumed, fields updated

Budget management

Set a daily and monthly budget in euros. API calls are blocked automatically when the limit is reached.

Free Tier Available

Gemini 2.0 Flash offers 1,500 requests/day and 1 million tokens/minute for free — no credit card required.

Decision-maker Contacts

For companies, Gemini suggests up to 3 key decision-makers (CEO, CFO…) to create as child contacts. If a contact already exists, their email/phone is updated if currently empty.

📋 Enriched Fields

Description

Short presentation of the company or contact

Industry

e.g. Technology, Healthcare, Finance…

Website

Official URL if missing and inferable

LinkedIn

LinkedIn profile or company page

Twitter / X

Company Twitter / X account

Phone / Mobile

Main contact number

Address

Street, zip code, city, country

Headcount

Employee range (e.g. 10–50 employees)

Revenue

Annual revenue range

VAT / SIREN

Tax identifier if identifiable

Decision-makers

Up to 3 key contacts (CEO, CFO…) created as child contacts; email/phone updated if empty on existing contacts

🔑 Getting a Google Gemini API Key

  1. Go to aistudio.google.com/apikey
  2. Sign in with a Google account (personal or Google Workspace)
  3. Click “Create API key” and select or create a Google Cloud project
  4. Copy the generated key (starts with AIza....)
🆓 Free tier: 1,500 requests/day and 1 million tokens/minute with Gemini 2.0 Flash — no credit card required.

📦 Installation

  1. Copy the module to your Odoo addons folder
  2. Restart Odoo
  3. Enable developer mode
  4. Update the apps list
  5. Install the module “Gemini AI – Contact Enrichment

🚀 Configuration in 3 Steps

  1. Add your API key
    • Go to Settings → Gemini AI
    • Paste your Google API key (AIza...)
  2. Choose the model and language
    • Recommended model: gemini-2.5-flash
    • Response language: French or English
  3. Set a budget (optional)
    • Daily and monthly budget in euros
    • Automatic blocking when the limit is exceeded
    • Real-time cost tracking
💡 Bulk enrichment: From the contacts list, select multiple records then use Action → Enrich with Gemini to launch a group enrichment.

▶️ Usage

  1. Open a contact record
  2. Click “Enrich with Gemini
  3. Wait a few seconds
  4. Preview suggestions and check the fields to apply
  5. Click “Apply Selected Fields

📊 History & Logs

Access the full history via Contacts → Gemini AI → Enrichment History:

  • Date and enriched contact
  • Gemini model used
  • Tokens consumed and estimated cost
  • Suggested fields and applied fields
  • Status (success, error, partial)
  • Raw JSON response for diagnostics

📋 Requirements

  • Odoo 17.0
  • Module contacts(included in Odoo Community and Enterprise)
  • Python 3.8+ with requests library requests
  • Google Gemini API key (free at aistudio.google.com)

🆘 Support

  • Check the README.md for full documentation
  • Review enrichment logs in Contacts → Gemini AI → History
  • Contact us at ezway-technology.com/contact

⭐ Support offert le premier mois

Notre équipe d'experts Odoo est à votre service

Support téléphonique pour toutes vos questions techniques