Egyéni akciók (CRM)

Az egyéni akciók lehetővé teszik, hogy a chatbot a párbeszéd során valós adatokat kérdezzen le és írjon külső rendszerekbe — CRM-ekbe, foglalási rendszerekbe, rendeléskövető platformokba. Ehhez nincs szükség fejlesztésre az ügyfél oldalán: elegendő egy HTTP végpont.

Mi az az egyéni akció?

Egy akció egy HTTP API végpont hívása, amelyet az AI automatikusan indít el, ha a párbeszéd kontextusa megkívánja. Az AI dönt arról, hogy az akciót el kell-e hívni, és ha igen, milyen paraméterekkel.

Read vs Write akciók

• Read akció: Adatokat kérdez le (pl. rendelés állapota, szabad időpontok). Az eredményt az AI azonnal beépíti a válaszba. Nincs megerősítési lépés.
• Write akció: Adatokat módosít (pl. foglalás, rendelés lemondása). Mindig megerősítési lépéssel jár — az AI összefoglalja a látogatónak, mit akar csinálni, és megkérdezi, hogy valóban folytatja-e.

Konfigurálás

Az akciók a dashboard chatbot beállítások oldalán, az Akciók fülön konfigurálhatók:

• Név: Emberi olvasható cím (pl. "Rendelés állapot lekérdezése")
• Leírás: Természetes nyelvi leírás az AI számára — ebből dönt az AI, mikor hívja meg az akciót.
• URL: A külső API végpont teljes URL-je.
• HTTP metódus: GET, POST, PUT vagy DELETE.
• Paraméter séma: JSON Schema formátumban megadott paraméterek, amelyeket az AI tölt ki a párbeszédből (pl. rendelésszám, email).
• Típus: Read vagy Write.

Authentikáció

Hogyan dönt az AI?

Az AI a Function Calling mechanizmust használja (amely elsősorban az OpenAI esetében érhető el stabilan). Az akció leírása és paraméter sémája automatikusan eszközdefinícióvá (tool) alakul, amelyet az AI a rendszer promptjával együtt kap meg. Az AI a párbeszéd alapján dönt, hogy és mikor hívja meg az akciót — automatikusan kinyerve a szükséges paramétereket (pl. rendelésszámot) a látogató üzeneteiből.

Write megerősítés

Ha a chatbot Write akciót akar végrehajtani, előbb összefoglalja a tervezett műveletet és megkérdezi a látogatót:

Chatbot: "Átütemezem az időpontodat péntek 15:00-ra. Folytathatom?"
Látogató: "Igen"
Chatbot: [API hívás] "Kész! Az időpontod átkerült péntek 15:00-ra."

Ha a látogató nem fogadja el, az akció nem hajtódik végre.

Rendelés lekérdezése rendelésszám alapján

Ez az egyik leggyakoribb integrációs példa: a látogató megad egy rendelésszámot, a chatbot pedig azonnal lekéri a rendelés aktuális állapotát a webshop vagy az ERP rendszer API-ján keresztül. Ennek beállítása nem igényel fejlesztést az ügyfél részéről — elegendő hozzá egy meglévő REST végpont.

Előfeltétel: Szükséged lesz egy API végpontra, amely rendelésszám alapján ad vissza rendelési adatokat. Nézzünk egy példát:

GET https://api.myshop.com/orders/{order_number}
Authorization: Bearer <api_key>

// Válasz (példa):
{
  "order_number": "ORD-4821",
  "status": "shipped",
  "estimated_delivery": "2026-03-25",
  "tracking_url": "https://tracking.dhl.com/...",
  "items": [{ "name": "Fekete póló", "qty": 2 }]
}

Az akció konfigurálása a dashboardon:

• Típus: Read
• Név: Rendelés állapotának lekérdezése
• Leírás (az AI számára): “Ha a látogató a rendelése állapotáról érdeklődik és megad egy rendelésszámot, hívd meg ezt az akciót.”
• URL: https://api.myshop.com/orders/{order_number}
• HTTP metódus: GET
• Autentikáció: Bearer token (ide kerül az API kulcsod)
• Paraméter séma:

{
  "properties": {
    "order_number": {
      "type": "string",
      "description": "A rendelés azonosítója, pl. ORD-4821"
    }
  },
  "required": ["order_number"]
}

A beállítások mentése után a chatbot automatikusan felismeri, ha egy látogató a rendelését keresi. Kinyeri a rendelésszámot az üzenetből, meghívja az API-t, majd a kapott adatokat természetes, emberi nyelven adja át a felhasználónak.

Példa párbeszéd:

Látogató: "Hol tart az ORD-4821-es rendelésem?"
Chatbot:  [API hívás → GET /orders/ORD-4821]
Chatbot:  "A rendelésedet feladtuk, várható kézbesítés: március 25.
           Nyomon követheted itt: https://tracking.dhl.com/..."

Példák