API kapcsolatok

Csatlakoztasd a külső API-kat az enuchathoz, hogy az AI és a szabályok valós idejű adatokat kérhessenek le a rendszereidből.

Hogyan működik

Az API kapcsolatok lehetővé teszik, hogy integráld az enuchatot a saját backend rendszereiddel — foglalási motorok, CRM-ek, rendelési kezelés, készlet és több. Amikor egy látogató kérdést tesz fel, az enuchat hívhatja az API-dat, hogy valódi adatokat kapjon és belefoglalja a válaszba.

A folyamat

Konfigurálj egy kapcsolatot — az API-d alap URL-je és hitelesítés
Adj hozzá végpontokat — specifikus API hívások útvonalsablonokkal és válasz leképezéssel
Hozz létre szabályt — egy AI vagy statikus szabályt CALL_API művelettel
A látogató kérdést tesz fel — a szabály aktiválódik, hívja az API-dat, leképezi a választ munkamenet változókra
Az AI valódi adatokkal válaszol — a munkamenet változók elérhetők az AI-nak a pontos válasz generálásához

Példa: Hotelszoba elérhetőség

Látogató: „Elérhető a 205-ös szoba a jövő héten?”

Az AI szabály egyezik: „Amikor a látogató szoba elérhetőségről kérdez”

CALL_API művelet: GET https://api.hotel.com/rooms/205/availability

Válasz leképezve: room_available = true, price = „120€/éjszaka”

Az AI válaszol: „A 205-ös szoba elérhető a jövő héten 120€/éjszakáért. Szeretnéd lefoglalni?”

Kapcsolat beállítása

Menj a Beállítások → API kapcsolatok-hoz az irányítópultodban.

1. Kapcsolat létrehozása

Egy kapcsolat egy külső API-t reprezentál. Szükséged van:

Mező	Leírás	Példa
Név	Címke ehhez a kapcsolathoz	Hotel foglalási API
Alap URL	Az API gyökér URL-je	`https://api.hotel.com/v1`
Hitelesítés típus	Hogyan hitelesítsünk	Bearer Token, OAuth2, stb.

2. Hitelesítési típusok

Nincs

Olyan nyilvános API-khoz, amelyek nem igényelnek hitelesítést.

API kulcs

Egy statikus kulcsot küld fejlécként vagy lekérdezési paraméterként.

Mező	Leírás
Kulcs	Az API kulcsod értéke
Fejléc név	Használandó fejléc (alapértelmezett: `X-Api-Key`)

A kulcs így kerül elküldésre: X-Api-Key: your_key_here

Bearer Token

Statikus tokent küld az Authorization fejlécben.

Így kerül elküldésre: Authorization: Bearer your_token_here

Basic Auth

Felhasználónevet és jelszót küld, base64-ben kódolva.

Így kerül elküldésre: Authorization: Basic dXNlcjpwYXNz

OAuth 2.0 (Client Credentials)

Automatikusan lekéri a hozzáférési tokent és gyorsítótárazza a lejáratig. Kiváló modern API-khoz, mint a Salesforce, Google vagy egyedi OAuth szerverek.

Mező	Leírás
Token URL	OAuth token végpont (pl. `https://auth.example.com/oauth/token`)
Client ID	Az OAuth kliens ID-d
Client Secret	Az OAuth kliens titka
Scope	Szóközzel elválasztott scope-ok (pl. `read write`)

Az enuchat automatikusan kezeli a token életciklust — lekéri az első híváskor, gyorsítótárazza a lejáratig, szükség esetén frissíti.

Biztonság: Minden hitelesítő adat nyugalmi állapotban titkosítva van libsodiumot használva. Soha nem kerülnek elérhetővé az API válaszokban — csak maszkolt értékek jelennek meg az irányítópulton.

Végpontok konfigurálása

Minden kapcsolatnak lehet több végpontja — specifikus API hívások, amelyeket el akarsz végezni.

Mező	Leírás	Példa
Név	Címke ehhez a végponthoz	Elérhetőség ellenőrzése
Metódus	HTTP metódus	GET, POST, PUT, DELETE
Útvonal	URL útvonal (az alap URL-hez fűződik). Használj `{'{'}variable}`-t dinamikus értékekhez	`/rooms/{'{'}roomId}/availability`
Lekérdezési paraméterek	URL paraméterek kulcs-érték párokként. Az értékek támogatják a `{'{'}variable}`-t	`date={'{'}checkIn}`
Törzs sablon	JSON törzs POST/PUT-hoz. Támogatja a `{'{'}variable}` interpolációt	`{'{'}"guest": "{'{'}name}"}`
Válasz leképezés	Leképezi a JSON válasz mezőit munkamenet változókra pont jelöléssel	`data.available → room_available`
Leírás	Kontextus az AI-nak (milyen adatokat ad vissza ez a végpont)	Visszaadja a szoba elérhetőségét és árát

Változó interpoláció

Használd a {'{'}variableName}-t útvonalakban, lekérdezési paraméterekben és törzs sablonokban. A változók forrásai:

Munkamenet változók — korábbi szabályok által beállítva (SET_VARIABLE művelet)
Művelet paraméterek — bekódolva a CALL_API szabály műveletben

Válasz leképezés

Képezd le a JSON válasz mezőket munkamenet változókra pont jelöléssel:

// API returns:
{'{'}
  "data": {'{'}
    "available": true,
    "price": {'{'} "amount": 120, "currency": "EUR" }
  }
}

// Mapping:
data.available  →  room_available    // "true"
data.price.amount  →  room_price    // "120"
data.price.currency  →  room_currency  // "EUR"

A leképezett változók munkamenet változókként tárolódnak a beszélgetésen és elérhetők az AI-nak a válaszok generálásához.

Használat szabályokkal

Az API hívásokat a CALL_API művelet váltja ki a szabályokban. Kombinálhatod őket más műveletekkel.

Recept: Rendelési állapot keresése

Kapcsolat: Rendelés kezelő API — https://api.shop.com/v2 — Bearer Token

Végpont: GET /orders/{'{'}orderId} → leképezi data.status → order_status, data.eta → delivery_eta

Szabály (AI típus): „Amikor a látogató a rendelése állapotáról vagy szállításáról kérdez”

Műveletek:

CALL_API → Rendelési állapot végpont
REPLY_AI → Az AI használja order_status-t és delivery_eta-t a válaszhoz

Eredmény: Látogató: „Hol van a #4521-es rendelésem?” — AI: „A #4521-es rendelésed jelenleg szállítás alatt van és csütörtökig meg kell érkeznie.”

Recept: Valós idejű árak

Kapcsolat: Árazási API — https://pricing.example.com — API kulcs

Végpont: GET /products/{'{'}productId}/price → leképezi price → current_price, currency → price_currency

Szabály (statikus): MESSAGE_MATCHES_REGEX: /\b(price|cost|how much)\b/i

Műveletek:

CALL_API → Árazási végpont
REPLY_TEXT → „A jelenlegi ár {'{'}current_price} {'{'}price_currency}.”

Tesztelés

Mindig teszteld a kapcsolataidat és végpontjaidat szabályokban való használat előtt:

Kapcsolat tesztelése — ellenőrzi, hogy a hitelesítés működik-e (OAuth2 esetén: lekér egy tokent)
Végpont tesztelése — valódi API hívást végez mintaváltozókkal és megjeleníti a választ
Szabály tesztelése (dry-run) — a Szabályok oldalon teszteld, hogy egy szabály egyezne-e és milyen műveletek hajtódnának végre

Tipp: Kezdd a kapcsolat tesztelésével, majd minden végponttal, majd a teljes szabállyal. Így izolálhatod a problémákat minden szinten.

Biztonság

Titkosítás nyugalmi állapotban — minden hitelesítő adat libsodiumot használva titkosítva van tárolás előtt
Soha nem elérhető — az API válaszok soha nem tartalmaznak visszafejtett hitelesítő adatokat, csak maszkolt értékeket
SSRF védelem — az enuchat blokkolja a localhost, privát IP-k és belső hosztnevek felé irányuló hívásokat
Időtúllépés — a külső API hívásoknak 5 másodperces időtúllépésük van, hogy megakadályozzák a lefagyást
OAuth2 token gyorsítótárazás — a hozzáférési tokenek biztonságosan gyorsítótárazva vannak és automatikusan frissülnek
Tenant izoláció — a kapcsolatok a tenantodhoz vannak hatóláva, másoknak nem elérhetők

Készen állsz csatlakoztatni az API-kat?

Kezdj el ma integrálni a rendszereidet az enuchattal.

Kezdj ingyen