Healthcare Clinic Assistant with WhatsApp and Telegram Integration

Version: 1.1.0
n8n Version: 1.88.0+
License: MIT

📋 Description

A comprehensive and modular automation workflow designed for healthcare clinics.
It manages patient communication, appointment scheduling, confirmations, rescheduling, internal tasks, and media processing by integrating WhatsApp , Telegram , Google Calendar , and Google Tasks , combined with AI-powered agents for maximum efficiency.

This system guarantees proactive communication with patients, streamlined internal clinical management, and consistent data synchronization across platforms.

🌟 Key Features

• 🤖 AI-Powered Specialized Agents :
  Distinct agents handle WhatsApp patient support, appointment confirmations, and internal rescheduling tasks.

• 📱 Omnichannel Communication :
  Handles patient interactions via WhatsApp and staff commands via Telegram.

• 📅 Google Calendar Appointment Management :
  Full synchronization for creating, updating, canceling, and confirming appointments.

• 📋 Task Management with Google Tasks :
  Manages shopping lists and administrative tasks efficiently through staff Telegram requests.

• 🔔 Automated Appointment Reminders :
  Daily-triggered system proactively sends WhatsApp confirmations to patients for next-day appointments.

• 🖼️ Intelligent Media Processing :
  Transcribes audios, extracts text from images, and processes documents using OpenAI and OpenRouter AI models.

• 🛡️ Escalation to Human Support :
  Automatically detects sensitive or urgent cases and escalates them to a human agent when needed.

🏥 Use Cases

• Patient Communication:
  Respond to inquiries, schedule, reschedule, and confirm appointments seamlessly via WhatsApp.

• Internal Clinic Operations:
  Allow staff to modify appointments or add shopping list reminders directly from Telegram.

• Appointment Confirmation System:
  Automatically contacts patients one day prior to appointments for confirmation or rescheduling.

• Task and Reminder Management:
  Keeps clinic operations organized through automatic task management with Google Tasks.

🛠️ Technical Implementation

WhatsApp Patient Interaction Flow

• Webhook Reception: Incoming WhatsApp messages captured via Evolution API webhook.
• Message Classification: Intelligent routing of messages based on content type (text, image, audio, document).
• Media Content Processing:
  • Audios: Download, convert, and transcribe via OpenAI Whisper.
  • Images: Analyze and extract text/descriptions with OpenAI Vision model.
• Patient Request Handling: Specialized WhatsApp assistant responds appropriately using AI prompts.
• Outbound Message Formatting: Ensures messages comply with WhatsApp format standards.
• Message Delivery: Sends responses back via Evolution API.

Telegram Staff Management Flow

• Telegram Webhook Reception: Captures messages from authorized staff accounts.
• Internal Assistant Processing:
  • Appointment Rescheduling: Identifies and updates appointments through MCP Google Calendar.
  • Task Creation: Adds new entries to the clinic's shopping list using Google Tasks.
• Notifications and Confirmations: Sends confirmations back to staff through Telegram.

Appointment Reminder System

• Daily Trigger Activation: Fires every weekday at 08:00 AM.
• Calendar Scraping: Lists next day's appointments from Google Calendar.
• Patient Contact: Sends WhatsApp confirmation messages for each appointment.
• Response Management: Redirects confirmation or rescheduling replies to appropriate agents.

⚙️ Setup Instructions

1. Import the Workflow
   n8n → Workflows → Import from File → Upload this JSON file.

2. Configure Credentials

   • Evolution API (WhatsApp Communication)
   • Telegram Bot API (Staff Communication)
   • Google Calendar OAuth2 (Appointment Management)
   • Google Tasks OAuth2 (Task Management)
   • OpenAI and OpenRouter APIs (AI Agents)
   • PostgreSQL Database (Chat Memory)

3. Set Sensitive Variables

   • Replace placeholder values:
     • {sua instância aqui} → Evolution API instance name
     • {número_whatsapp} → WhatsApp numbers
     • {url_do_servidor} → Server URLs
     • {a sua apikey aqui} → API keys
     • {seu_calendario} → Google Calendar ID

4. Customize AI Prompts

   • Adjust system prompts to fit your clinic's tone, service style, and patient communication guidelines.
   • Set clinic operating hours, escalation rules, and cancellation procedures in AI prompts.

5. Activate and Test

   • Simulate patient messages via WhatsApp.
   • Test Telegram commands from staff members.
   • Validate daily appointment reminders using the scheduled trigger.

🏷️ Tags

Healthcare Clinic Management WhatsApp Integration Telegram Bot Appointment Scheduling Google Calendar Google Tasks AI Agents n8n Automation

📚 Technical Notes

• PostgreSQL is used for persistent chat memory across sessions.
• Multiple AI Models Used:
  • OpenAI GPT-4.1-nano
  • OpenAI GPT-4.1-mini
  • Google Gemini 2.0 and 2.5
• Full media content processing supported (audio, image, text).
• Compliant escalation workflows ensure patient safety and proper handoff to human staff when necessary.
• All sensitive patient data are securely stored inside calendar event descriptions for easy retrieval by agents.

📜 License

This workflow is provided under the MIT License .
Feel free to adapt and customize it for your clinic's specific needs.