AI WhatsApp Booking Bot 是用 Python 和人工智能(LLM)开发的虚拟助手,用于为理发店和美发沙龙自动化预约管理和客户服务。它被设计为能够理解上下文、保持对话记忆,并直接与官方 WhatsApp Cloud API(Meta)和 Google 生态集成,以实时读取价格并预约或取消预约。 主要能力包括:通过 Groq API(Llama 3 / Qwen)使用先进语言模型,对相对日期和意图进行自然语言处理;保持上下文、只询问缺失数据的对话记忆;集成 Google Calendar,在营业时间、节假日和已占用时段中查找空闲时间;自动创建和取消预约事件;集成 Google Sheets,动态读取服务项目和最新价格;以及集成 WhatsApp Cloud API,通过 webhook 实时接收和发送消息。 该项目使用 Python 3.14.7、FastAPI、Uvicorn、带智能体式函数调用/工具使用的 Groq API、Meta WhatsApp Cloud API、Google Calendar API、Google Sheets API 和 Ngrok。安装包括克隆仓库、创建虚拟环境、安装依赖、配置 credentials.json、clientes.json 和 .env 变量,然后运行 python main.py。这会在 8000 端口启动 FastAPI 服务器并自动打开 Ngrok 隧道;公网 URL 需要在 Meta for Developers 中配置 /webhook 和 VERIFY_TOKEN,并订阅 messages 事件。
理发店和美发沙龙用该机器人自动化预约管理和客户服务。
商家用该机器人理解 WhatsApp 对话中的相对日期和意图。
团队用对话记忆只请求缺失的数据,而无需重新开始对话。
商家用 Google Calendar 集成在营业时间、节假日和已占用时段中查找空闲时间。
团队用 Google Calendar 集成自动创建和取消预约事件。
商家用 Google Sheets 集成动态读取当前服务列表和最新价格。
团队用 WhatsApp Cloud API 通过 webhook 实时接收和发送消息。
开发者用本地模拟器在 8000 端口启动 FastAPI 服务器并打开 Ngrok 隧道。