AirDoo Overview¶
What is AirDoo?¶
AirDoo is an Odoo 18 module that automates Airbnb reservation management by converting confirmation emails into structured bookings in Odoo.
The Problem¶
Short-term rental owners spend hours: - Manually entering Airbnb reservations into their system - Paying expensive subscriptions to Channel Managers (€20–40/month/property) - Managing fragmented data across Airbnb, their CRM, and accounting
The Solution¶
AirDoo eliminates these problems by: 1. Automatically parsing Airbnb confirmation emails via the Gmail API 2. Automatically creating reservations, customers, and invoices in Odoo 3. Synchronising the occupancy calendar in real time 4. Building a proprietary customer database
Technical Architecture¶
graph TD
A[Airbnb Emails] --> B[Gmail API]
B --> C[AirDoo Parser]
C --> D[Validation & Enrichment]
D --> E[Odoo Reservation Created]
E --> F[Dashboard]
E --> G[Calendar]
E --> H[Invoicing]
Core Components¶
| Component | Description |
|---|---|
| Email Parser | Extracts data from Airbnb emails (dates, price, guest, property) |
| Matching Engine | Links reservations to Odoo accommodations |
| Reservation Creator | Generates sales orders, customers, and invoices |
| Dashboard | Overview of occupancy and revenue |
| REST API | Interface for external integrations (websites, apps) |
Key Features¶
✅ Automatic Sync¶
- Frequency: Every 30 minutes (Odoo cron)
- Source: Gmail emails (
automated@airbnb.com) - Supported languages: French, English, Portuguese, Spanish, German, Italian
- Authentication: Google OAuth2 (read-only, secure)
✅ Multi-Property Management¶
- Smart matching: Exact Airbnb name ↔ Odoo
- Calendar colours: 11 auto-assigned colours
- Multi-company: Full support
- Rich information: GPS coordinates, logo, signature
✅ Automated Communication¶
- Pre-configured multilingual email templates
- WhatsApp Business: configurable fields (auto-send coming soon)
- Automated messages: confirmation, instructions, post-stay
- Per-property and per-company customisation
✅ API & Integration¶
- Calendar API: Availability and reservations
- Booking API: Direct reservation creation
- Webhooks: Bidirectional synchronisation
- iCal export: ICS files in cleaning emails (public feed coming soon)
Competitive Advantages¶
Economic¶
| Saving | Amount | Calculation |
|---|---|---|
| Channel Manager | €240–480/year/property | €20–40 × 12 months |
| Data entry time | ~€600/year (estimated) | 5 min/booking × 2/week × 52 weeks × €20/h |
| Total/property | €840–1,080/year |
Technical¶
- Open Source (LGPL-3): No vendor lock-in
- Native Odoo integration: CRM, accounting, invoicing
- Gmail read-only scope: Maximum security
- Auto-refreshed token: No interruptions
Operational¶
- Full traceability: History in Odoo chatter
- Cancellation handling: Automatic
- Conflict detection: Error prevention
- Diagnostic logs: Ignored emails, parsing errors
Use Cases¶
Independent Owner (1–3 properties)¶
- Problem: Time lost on manual entry
- Solution: Full automation, saves 10h/month
- ROI: < 1 month
Portfolio Manager (5–20 properties)¶
- Problem: Multiple platforms, complex reporting
- Solution: Centralisation, automated reporting
- ROI: 2–3 months
Digital Hotelier (small structure)¶
- Problem: Expensive tools, complex integrations
- Solution: All-in-one, reduced commissions
- ROI: 3–4 months
Technical Requirements¶
Odoo¶
- Version: Odoo 18.0+
- Database: PostgreSQL
- Required modules:
sale_management,account,contacts,web
Google Cloud¶
- Google Cloud account with Gmail API enabled
- OAuth2 credentials (
credentials.json,token.json) - Scope:
https://www.googleapis.com/auth/gmail.readonly
Odoo Configuration¶
- Products: "Accommodation Nights" and "Cleaning Fee" (service type)
- Accommodations: Registered in AirDoo → Accommodations
- Settings: Configured in AirDoo → Configuration → Settings
Next Steps¶
- Installation: Install and configure the module
- Configuration: Set up parameters and accommodations
- Quick Start: Run your first sync
← Back: Home | Next: Installation →