Skip to content

This program uses the Smoobu API to identify gaps in your apartment booking calendar and automatically send personalized email campaigns, encouraging guests to book those free days and maximize your occupancy and revenue.

License

Notifications You must be signed in to change notification settings

OtenMoten/bot-smoobu-free-days-dealer

Repository files navigation

💰 Smoobu Free Days Dealer: Maximize Your Occupancy with Smoobu API

Welcome to Smoobu Free Days Dealer, your intelligent assistant for identifying and filling gaps in your Smoobu apartment booking calendar!

📅 Project Overview

This Python-based system is a sophisticated, open-source toolkit designed to optimize your apartment bookings from the Smoobu platform. Its core feature is identifying free days between bookings and automatically sending targeted email campaigns to encourage guests to book those days, maximizing your occupancy and revenue.

This application brings together a task force of powerful components:

  • Smoobu Free Day Finder: Intelligently identifies gaps between bookings using Smoobu API 🔍
  • Automated Email Campaigns: Sends personalized emails using Jinja2 templates to entice guests to book free days 📧
  • Comprehensive Reporting: Generates reports on occupancy rates and revenue 📈

This system is powered by:

  • SmoobuAPIClient: Communicates with the Smoobu API using the requests library
  • SmoobuService: Orchestrates data retrieval, processing, and updating
  • Formatters: Transforms raw booking data into actionable insights
  • DTOs: Ensures data consistency and type safety

Additional tools in our booking optimization toolkit:

  • logging: Maintains detailed system logs
  • caching: Optimizes API usage with cachetools
  • rate limiting: Ensures compliance with API constraints using ratelimit

🛠️ Installation

To set up your own Smoobu Free Days Dealer:

  1. Clone this revenue-boosting repository:
    git clone https://github.com/otenmoten/bot-smoobu-free-days-dealer.git
    
  2. Enter the project directory:
    cd bot-smoobu-free-days-dealer
    
  3. Install the required dependencies:
    pip install -r requirements.txt
    

🚀 Usage

  1. Configure your Smoobu connection and email settings:

    config.py
    
  2. Start boosting your bookings:

    python main.py
    

📜 License

This project is licensed under the GPL3.0 License - see the LICENSE file for details.

👨‍💼 Authors

  • Kevin Ossenbrück - Lead Developer at Team Bitfuture - ossenbrück.de

🤝 Connect with Team BitFuture

Start maximizing your occupancy and revenue today with Smoobu Free Days Dealer! 💼🏠

About

This program uses the Smoobu API to identify gaps in your apartment booking calendar and automatically send personalized email campaigns, encouraging guests to book those free days and maximize your occupancy and revenue.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published