Project Proposal · February 2026

Instagram DM
AI Chatbot Emergency World Co. for Medical Services (WECO)

An intelligent, 24/7 automated DM assistant built on Laravel — responding instantly in Arabic & English using WECO's curated medical knowledge base.

< 3s
Response Time
24/7
Availability
AR + EN
Languages
22 days
Delivery
W
WECO Assistant Online · AI-powered
هل تقدمون زيارات تمريضية منزلية؟
9:14 AM ✓✓
نعم! نقدم رعاية صحية منزلية على مدار الساعة تشمل التمريض والحقن والعلاج الطبيعي وفحوصات المختبر. هل تريد حجز موعد؟
9:14 AM ✓✓
Do you offer BLS training?
9:15 AM ✓✓
Executive Summary

The Problem.
The Solution.

WECO's Instagram DMs are a missed opportunity — we're here to fix that with a production-grade AI system.

⚡ The Challenge

WECO receives daily Instagram DMs from patients and corporate clients — but responses are manual, inconsistent, and delayed.

  • Delayed replies lose potential clients
  • Staff time wasted on repetitive FAQs
  • No 24/7 coverage for urgent inquiries
  • Inconsistent brand messaging
  • Zero lead capture from DM conversations

✦ The Solution

An AI-powered chatbot built on Laravel that responds instantly using WECO's own verified knowledge base — in any language, any hour.

  • Instant replies in Arabic & English
  • AI strictly grounded on verified WECO content
  • 24/7 fully automated availability
  • Smart escalation to human agents
  • Full lead capture & conversation logging

How It Works

Five stages from user message to intelligent response — all automated.

1
User DMs WECO
Instagram user sends any message to WECO's page — in Arabic or English
2
Webhook Triggered
Meta Graph API fires a POST to our Laravel webhook endpoint instantly
3
AI Processes Query
LLM detects language, understands intent, retrieves relevant KB content
4
Response Sent
Accurate, on-brand reply delivered back to Instagram in under 3 seconds
5
Escalate if Needed
Emergencies or complex queries routed immediately to a WECO agent
🔒 All conversations logged
⚡ Avg response < 3 seconds
🌐 Arabic + English auto-detect
📊 Analytics dashboard included
Capabilities

Key Features

Every component engineered specifically for WECO's medical context and audience.

🤖

AI Response Engine

LLM-powered replies grounded strictly in WECO's knowledge base. No hallucinated services, prices, or incorrect medical info.

🌐

Bilingual Support

Automatically detects Arabic and English. Responds naturally in the user's language with on-brand tone and medical accuracy.

24/7 Availability

Fully automated — responds instantly even at 3 AM. Never miss a lead, an inquiry, or an emergency message again.

🚨

Smart Escalation

Emergency keywords trigger instant agent alerts. Medical cases are never left to a bot alone — people get people when it matters.

📋

Knowledge Base CMS

Admin panel to add, edit, and manage all KB content. Changes reflect in bot responses within minutes — no code needed.

📈

Lead Capture & Analytics

Every conversation logged with user info, topic, and resolution status. Weekly performance dashboards included.

What the AI Knows

The bot is grounded exclusively in WECO's curated, verified content — nothing outside it.

🏥
Services (9 Categories)On-site clinics, home care, ambulance, training, insurance, medevac...
📍
Locations & HoursBreha Branch (HQ), Burjeesia Branch, DAK Camp, Al-Zubair
🏆
CertificationsISO 9001 / 14001 / 45001, AHA Training Center, Iraqi MOH registration
📞
Emergency ContactsHotline 6631, email, escalation chains, on-call procedures
🤝
Partners & ReferralsArab Wings, Saudi German Hospital, Burjeel Medical City, Abdali Hospital
FAQs & Common QueriesPricing questions, booking process, availability, coverage areas
RAG Architecture
Retrieval-Augmented Generation ensures 100% factual accuracy — the model can only say what WECO actually offers.
1User query received from Instagram DM
2Language detected (Arabic / English)
3Relevant KB entries retrieved by category/keyword
4Entries injected into LLM context window
5LLM generates response using only KB content
6Low-confidence queries trigger human escalation
Admin edits KB → Bot learns instantly (no redeploy)
Engineering

Technical Architecture

Built on battle-tested Laravel infrastructure with enterprise-grade reliability.

📱 Instagram Layer
Incoming DM webhook
Meta Graph API v20
Token auth & refresh
Quick reply buttons
Read receipt events
⚙️ Laravel Backend
Webhook Controller
Redis Queue (Horizon)
AI Service Layer
Session Manager
Escalation Service
🧠 AI Engine
Claude / GPT API
RAG retrieval
Language detection
Confidence scoring
Prompt engineering
🗄️ Data & Admin
MySQL (KB + logs)
Filament Admin Panel
Conversation archive
Analytics dashboard
Role-based access
Laravel 11 Redis / Horizon MySQL Meta Graph API v20 Claude API / GPT-4o Filament v3 RAG Architecture Arabic NLP Docker / VPS

Admin Panel

Complete control for WECO's team — no technical knowledge required.

📊

Dashboard

  • Live active conversations count
  • Today's message volume & response rate
  • Escalation alerts with priority badges
  • Weekly performance KPIs
📝

Knowledge Base Manager

  • Add / edit / delete KB entries with rich editor
  • Categorize by service type and language
  • Arabic + English content variants
  • Activate / deactivate entries instantly
💬

Conversation Logs

  • Full thread history per Instagram user
  • Timestamps, resolution status, AI confidence
  • Lead info captured per conversation
  • Export to CSV for CRM import
🚨

Escalation Queue

  • Open escalations list with reason tags
  • Assign to specific team members
  • Mark resolved or schedule follow-up
  • Email alert on every new escalation
Safety Protocol

Escalation System

The bot knows when to step aside. Medical urgency always gets a real person.

🚨 Escalation Triggers
Emergency keywords
"ambulance", "urgent", "طوارئ", "حادث", "إسعاف" — triggers instantly
User requests human
"talk to someone", "كلمني", "أريد موظف" detected in any message
3 unresolved turns
Bot cannot find relevant KB answer after three attempts
Low AI confidence
Confidence score drops below configured threshold
Medical symptom description
Any description of symptoms routes immediately to clinical staff
✅ Escalation Response
Holding message sent
Bot sends emergency hotline (6631) + ETA for human reply
Agent notified instantly
Email alert fires to the on-duty WECO team member
Conversation flagged
Thread appears in admin escalation queue with reason tag
Bot pauses gracefully
Agent takes over natively in Instagram — bot stays silent
Full audit logged
Escalation reason, time, agent assigned, and resolution stored

Sample Conversations

Real examples of how the bot handles common WECO inquiries.

Scenario A — Service Inquiry (EN)
Do you offer home nursing visits?
Yes! WECO provides 24/7 home healthcare including nursing visits, injections, physiotherapy, lab tests & doctor consultations at home. Would you like to book a visit? 📞 6631
Scenario B — Emergency (AR)
أبي يحتاج إسعاف الحين!
🚨 للطوارئ اتصل فوراً: 6631 — فريق الإسعاف متاح 24/7 في البصرة وجنوب العراق. سيتواصل معك أحد المختصين خلال دقائق.
⚡ ESCALATION TRIGGERED — Agent notified immediately
Scenario C — Training Inquiry (EN)
Do you offer BLS certification?
Yes! WECO's Training Center is AHA-certified. We offer Heart Saver, BLS & ACLS courses conducted by certified instructors. Visit weco-iraq.com to schedule your group session.
Delivery Plan

Project Timeline

22 days. Phased delivery with clear milestones at every stage.

Days 1–3

Meta Setup & Webhook Integration

Meta business verification, Instagram API setup, webhook endpoint, basic message echo test, token management system.

Days 4–8

AI Engine & Knowledge Base

LLM API integration, RAG architecture implementation, knowledge base schema design, seed data entry for all WECO services, language detection.

Days 9–11

Conversation Flow & Escalation Logic

Session management, multi-turn conversation state, escalation triggers (emergency keywords, low confidence), agent notification system.

Days 12–16

Admin Panel Development

Filament admin panel: KB manager, conversation logs, escalation queue, analytics dashboard, user roles (admin / agent), settings panel.

Days 17–19

Testing, QA & Arabic Validation

Arabic dialect testing (Iraqi colloquial), edge case scenarios, load testing, security audit, end-to-end UAT with WECO team.

Days 20–22

Deployment & Go-Live

Production server deployment, Meta app review submission & approval, 1-hour staff training session, documentation handover, 30-day support begins.

What You Receive

A complete, production-ready system — source code, training, and 30 days of post-launch support included.

Full Laravel application (source code, fully documented)
Instagram DM webhook integration (Meta Graph API)
AI response engine with RAG knowledge base
Bilingual support — Arabic (Iraqi) + English
Escalation system with emergency alert notifications
Filament admin panel (KB manager, logs, escalation queue)
Conversation logging & lead capture database
Production server deployment & configuration
1-hour staff onboarding & training session
30-day post-launch support & bug fixes

Project Investment

Fixed-price engagement — no surprises

Discovery & ArchitectureIncluded
Phase 1–2: Core Build━━━
Phase 3–4: Admin & Escalation━━━
Phase 5–6: Testing & Deploy━━━
30-Day Post-Launch SupportIncluded
Staff Training SessionIncluded
Risk Management

Risks & Mitigations

Every known risk is already planned for — with concrete mitigation strategies in place.

Risk Level Mitigation
Meta App Review Delay Medium Business verification starts Day 1. Dev runs in parallel with test accounts so no time is lost.
AI Hallucination Low Strict RAG grounding — the LLM prompt forbids any information outside the KB. All outputs referenced.
Medical Liability Low Bot never provides clinical advice. Any symptom/diagnosis triggers immediate escalation with disclaimer.
Arabic Dialect Variation Medium Extensive Iraqi Arabic testing. Modern LLMs handle dialect variation well with proper system prompting.
Data Privacy Low No sensitive health data beyond conversation text. Tokens encrypted. Role-based admin authentication.

Ready to give WECO's patients
the response they deserve?

An instant, accurate, 24/7 AI assistant — built specifically for WECO's medical context, brand, and audience.

< 3s Response Time
24/7 Availability
AR + EN Languages
22 days To Delivery
📧 info@weco-iraq.com