🤖 AI Ügynökök és Foglalási Asszisztensek

WhatsApp AI Időpontfoglaló Ügynök

🎯 Cél és üzleti hatás

Ez a workflow lecseréli a manuális, csak nyitvatartási időben elérhető időpont-egyeztetést egy AI Ügynökre, amely 0–24-ben válaszol a WhatsApp üzenetekre, valós időben ellenőrzi a tényleges Cal.com szabad kapacitást, és közvetlenül a beszélgetésben lefoglalja az időpontot — nincs dupla foglalás, nincs elveszett, munkaidőn kívüli lead. Szolgáltató vállalkozásoknak (fogászat, ügyvédi iroda, edzőterem, ingatlaniroda, klinika) ez pontosan azt a rést zárja be, ami a legtöbb konverziót viszi el: az „érdekel” és a „van egy megerősített időpontom” közötti időablakot, ami ma jellemzően azt jelenti, hogy a hívó tartásban vár, vagy egy email válasz nélkül marad reggelig.

🛠️ Szükséges tech stack és előfeltételek

WhatsApp Business API (Meta Developer fiók, vagy n8n/Make-kompatibilis szolgáltató, pl. Twilio vagy 360dialog)
n8n vagy Make.com workflow motor
OpenAI API kulcs (GPT-4o / Assistant API)
Cal.com fiók (az automatizált időpontfoglaláshoz) — minden kínált szolgáltatáshoz egy Event Type, saját Event ID-val
Google Sheets vagy GoHighLevel (lead-tárolásra)
Opcionális: SMS szolgáltató (pl. seven/sms77, Twilio) az emlékeztetőkhöz

📋 Lépésről lépésre DIY implementációs logika

Webhook és trigger beállítása: A bejövő WhatsApp üzenetek fogadása Meta Webhookon (vagy a szolgáltatód webhookján) keresztül, az n8n/Make workflow belépési node-jára irányítva.
AI ügynök és memória rendszer: Az üzenet továbbítása egy GPT-4o agent node-hoz, system prompttal (lásd az alábbi sablont) és a kontaktus WhatsApp ID-jához kötött beszélgetés-memóriával, hogy a beszélgetés során megjegyezze a kontextust.
Cal.com szabad kapacitás ellenőrzés: Adj az ügynöknek egy eszközt, amely lekérdezi a Cal.com /v2/slots/available végpontját a kiválasztott szolgáltatás Event ID-jára, egy rövid időablakon belül (pl. a következő 48 órában), és csak néhány opciót ad vissza — a hosszú listák rontják a konverziót egy chat felületen.
CRM és lead rögzítés: Írd be a nevet, emailt, telefonszámot és a kért szolgáltatást a Google Sheets-be vagy GHL-be, amint ezek rendelkezésre állnak — még a foglalás megerősítése előtt, hogy sose veszíts el egy leadet, aki félbehagyja a beszélgetést.
Megerősítés és foglalás végrehajtása: Amint a felhasználó megerősít egy konkrét időpontot, egy külön ág UTC-re konvertálja a választott időt, meghívja a Cal.com /v2/bookings végpontját az esemény létrehozásához, és visszaküld egy megerősítő üzenetet WhatsAppon. Egy külön, ütemezett workflow átnézheti a közelgő foglalásokat, és ~2 órával előtte SMS emlékeztetőt küldhet.

⚡ System prompt sablon (struktúra-útmutató)

A saját éles system promptunkat itt nem osztjuk meg — a pontos prompt vállalkozásra szabott (hangnem, szolgáltatáslista, edge case-ek kezelése), és ez a kiépített verzió része. Amit viszont megadunk, az a struktúra, amire minden működő verziónak szüksége van, hogy magad is megírhasd:

# WHATSAPP BOOKING AGENT — SYSTEM PROMPT STRUCTURE

## 1. IDENTITY & CONTEXT
- Who the agent is (business name, role — "friendly booking assistant")
- Business hours, location, tone of voice

## 2. SERVICE CATALOG (CRITICAL)
- List every bookable service: name, duration, price, Cal.com Event ID
- Map every way a customer might refer to a service → correct Event ID
  (this mapping is the #1 source of failed bookings if incomplete)

## 3. CONVERSATION FLOW
- Greet → ask ONE qualifying question at a time
- Collect: service preference → name → email
- Never re-ask a question the user already answered
- Only call the lead-capture tool ONCE, after name + email are both known

## 4. AVAILABILITY & TIME HANDLING
- Always call the availability tool with ISO 8601 timestamps
- Convert returned UTC times to the business's local timezone before
  showing them to the user — this is the #1 source of wrong bookings
  if skipped
- Limit results to a small number of slots (5 or fewer)

## 5. BOOKING CONFIRMATION LOGIC
- Require an explicit confirmation keyword (e.g. "confirm") before
  the booking tool fires — never book on an ambiguous "yes"
- State the exact date/time back to the user before asking for
  final confirmation, once, without repeating it

## 6. GUARDRAILS
- Never book without name + email + service on file
- Never repeat a question that's already been answered
- Define a "reset" keyword for testing/support
- Keep replies short, plain text, no heavy markdown (chat UI)

Használd ezt vázlatként, és töltsd ki a részletekkel a saját vállalkozásod szerint. Ha nem szeretnéd magad hangolni és tesztelni, a kiépített verzió egy éles, tesztelt prompttal érkezik, amely már kezeli az alábbi edge case-eket.

⚠️ Gyakori buktatók és edge case-ek

Időzóna-eltérések a Cal.com payloadokban: A Cal.com mindig UTC-ben adja vissza a szabad időpontokat. Ha nem konvertálsz a vállalkozás helyi időzónájára — sem a felhasználónak megjelenítéskor, sem a végleges foglalás elküldésekor —, az ügyfelek rossz órára kapnak megerősítést.
Végtelen AI újrapróbálkozási hurkok megelőzése hibás telefonszámoknál: egy szigorú védőkorlát nélkül egy hibás vagy hiányzó telefonszám a végtelenségig ugyanazt a kérdést ismételtetheti az ügynökkel. Korlátozd az újrapróbálkozásokat, és 2-3 sikertelen kísérlet után válts emberi átirányításra.
Meta API 24 órás ablak-szabályának korlátai: A Meta csak a felhasználó utolsó üzenetétől számított 24 órán belül engedélyez szabad formátumú WhatsApp választ. Ezen az ablakon kívül (pl. emlékeztetőknél) előre jóváhagyott WhatsApp üzenetsablont kell használnod — ezt már a tervezéskor építsd be az emlékeztető-folyamatba, ne csak azután, hogy élesben elromlik.