Ugrás a fő tartalomhoz
DocumentationAPI ReferenceVideo Tutorials

Integrációk

Az integrációk kibővítik az AI hangügynökeidet azáltal, hogy külső szolgáltatásokhoz kapcsolódnak. Ez a szakasz áttekinti az összes elérhető integrációt és azok konfigurálását.

Elérhető integrációk​

IntegrációCélÁllapotCsomagok
Phone NumbersTelefonszámok és hívásokElérhetőMind
SIP TrunkHozd a saját szolgáltatódat (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom)ElérhetőMind — megfelelőségi jóváhagyást igényel
Google CalendarIdőpont-ütemezés a Google-ön keresztülElérhetőMind
Outlook CalendarIdőpont-ütemezés a Microsoft Outlookon keresztülElérhetőMind
eTerminElérhetőség ellenőrzése és időpontok foglalása/átütemezése/lemondása élőben — lásd eTerminElérhetőMind
resmioÉttermi asztalok foglalása közvetlenül a foglalási könyvedbe élőben — lásd resmioElérhetőMind
HubSpot CRMKontaktok és üzletek olvasása/írása az AI hangügynöködbőlElérhetőMind
MCP serversHozd a saját MCP-kompatibilis eszközszerveredet, és tedd elérhetővé az eszközeit az ügynökök számára — lásd MCP ServersElérhetőMind
API KeysKülső alkalmazások hozzáféréseElérhetőMind
WebhooksValós idejű eseményértesítésekElérhetőMind
Minden csomag

A naptárintegrációk, a SIP, a HubSpot, az MCP serverek, az API-hozzáférés és a webhookok minden csomagban elérhetőek, beleértve a Free-t is. A SIP trunking egy egyszeri megfelelőségi jóváhagyást igényel, mielőtt a kapcsolatvarázsló feloldódna.

Telefonszám beállítása​

A telefonszámok lehetővé teszik, hogy az ügynökeid valódi telefonhívásokat fogadjanak és kezdeményezzenek.

Beállítási lépések​

  1. Menj a Phone Numbers menüpontra az oldalsávban
  2. Kattints a „Buy Number" gombra
  3. Válaszd ki az országot és a számtípust
  4. Fejezd be a vásárlást
  5. Rendelj hozzá egy ügynököt a számhoz

A számok automatikusan konfigurálódnak, és a vásárlás után azonnal használatra készek.

SIP Trunk integráció​

Hozd a saját SIP szolgáltatódat — a HANC natívan beszéli a SIP-et, és a bejövő hívásokat az AI hangügynöködbe (a kimenő hívásokat pedig vissza a trunködön keresztül) irányítja. Minden csomagban, beleértve a Free-t is elérhető egy egyszeri megfelelőségi jóváhagyás után.

Támogatott szolgáltatók​

A HANC finomhangolt adaptereket kínál a következő szolgáltatókhoz, plusz egy általános opciót minden máshoz:

SzolgáltatóSzámok automatikus importja API-n keresztülMegjegyzések
sipgateIgen (Personal Access Token)EU SIP trunking
PlacetelKéziNémet VoIP, Webportal hitelesítő adatok
TENIOSKéziEurópai SIP
easybellKéziNémet szolgáltató, Kundencenter hitelesítő adatok
ZadarmaIgen (opcionális API-kulcs)Globális számok
Twilio (BYO)IgenAccount SID + Auth Token
TelnyxIgenAPI-vezérelt SIP és DID-ek
Custom SIP trunkKéziBármely más szolgáltató — add meg a hostot, portot, transportot

Megfelelőségi jóváhagyás​

A SIP szolgáltatói kapcsolatok ugyanazt a megfelelőségi folyamatot használják, mint a kimenő kampányok. Amíg a fiókod nincs jóváhagyva, a Connect SIP gomb egy bemutató ablakot nyit meg, amely felsorolja az összes támogatott szolgáltatót egy mailto:support@hanc.ai CTA-val. A jóváhagyás általában még ugyanazon a munkanapon megtörténik.

Beállítási lépések (jóváhagyás után)​

  1. Menj a Phone Numbers → Connect SIP menüpontra.
  2. Válaszd ki a szolgáltatódat.
  3. Add meg a SIP hitelesítő adatokat (és az opcionális API-kulcsot/titkot, ha a szolgáltatód támogatja az automatikus importot).
  4. Custom SIP esetén add meg a hostot, portot (alapértelmezetten 5060) és a transportot (UDP / TCP / TLS) is.
  5. Kattints a Connect gombra — a HANC regisztrálja a SIP felhasználódat, és ahol támogatott, felsorolja a telefonszámaidat.
  6. Válaszd ki az importálandó számokat (vagy add hozzá őket kézzel E.164 formátumban).
  7. Rendelj hozzá egy bejövő és/vagy kimenő ügynököt minden számhoz.

Mikor használj SIP-et szám vásárlása helyett​

ForgatókönyvAjánlás
Új vagy a telefonszolgáltatásbanVásárolj számokat a HANC-on keresztül (egyszerűbb — nincs megfelelőségi lépés)
Meglévő PBX vagy szolgáltatói szerződésCsatlakozz SIP-en keresztül — tartsd meg a számodat
Vállalati telefónia szigorú szolgáltatói követelményekkelSIP a teljes kontrollhoz
Több régió / számkészletekSIP a rugalmasságért

Google Calendar integráció​

Kösd be a Google Calendart, hogy az AI hangügynökeid ellenőrizhessék az elérhetőséget és időpontokat foglalhassanak hívások közben.

Beállítási lépések​

  1. Menj az Integration → Calendars menüpontra
  2. Kattints a „Connect Google Calendar" gombra
  3. Jelentkezz be a Google-lel
  4. Engedélyezd a Hanc.AI hozzáférését

Kért engedélyek:

  • Naptáresemények megtekintése (az elérhetőség ellenőrzéséhez)
  • Naptáresemények létrehozása (időpontok foglalásához)

Naptárkonfiguráció​

A csatlakoztatás után konfiguráld a naptáreszközt az ügynöködön:

BeállításLeírás
calendar_idMelyik Google Calendart használja az ütemezéshez
timezoneAz időpont-ütemezés időzónája (pl. Europe/Vienna)
work_hoursFoglalásra elérhető órák (pl. hétfő–péntek 9:00–18:00)
slot_durationAlapértelmezett időpont-hossz (pl. 30 perc)
bufferPuffer idő az időpontok között (pl. 15 perc)

Naptárhasználat az ügynökökben​

Ha egyszer csatlakoztattad és konfiguráltad, az ügynökök:

  • Ellenőrizhetik az elérhetőséget konkrét dátumokra és időpontokra
  • Automatikusan foglalhatnak időpontokat
  • Betartják a munkaidőt és a puffer időket
  • Kezelhetik az átütemezési kéréseket

Példabeszélgetés:

Customer: "Can I book an appointment for Tuesday at 3pm?"

Agent: [Checks calendar]
       "Yes, Tuesday at 3pm is available.
        May I have your name to complete the booking?"

Outlook Calendar integráció​

Kösd be a Microsoft Outlook Calendart, hogy az AI hangügynökeiden keresztül lehetővé tedd az időpont-ütemezést.

Beállítási lépések​

  1. Menj az Integration → Calendars menüpontra
  2. Kattints a „Connect Outlook Calendar" gombra
  3. Jelentkezz be a Microsoft fiókoddal
  4. Engedélyezd a Hanc.AI hozzáférését

Kért engedélyek:

  • Naptáresemények megtekintése (az elérhetőség ellenőrzéséhez)
  • Naptáresemények létrehozása (időpontok foglalásához)

Naptárkonfiguráció​

A csatlakoztatás után konfiguráld a naptáreszközt az ügynöködön:

BeállításLeírás
CalendarMelyik Outlook naptárat használja az ütemezéshez
TimezoneAz időpont-ütemezés időzónája (pl. Europe/Vienna)
Work HoursFoglalásra elérhető órák (pl. hétfő–péntek 9:00–18:00)
Slot DurationAlapértelmezett időpont-hossz (pl. 30 perc)
BufferPuffer idő az időpontok között (pl. 15 perc)

Eltérések a Google Calendartól​

Mindkét naptárintegráció azonosan működik az ügynök szemszögéből. Az egyetlen különbség a bejelentkezési folyamat — válaszd azt a naptárszolgáltatást, amelyet már használsz.

tanács

Egyszerre csatlakoztathatod a Google és az Outlook naptárat is, de minden ügynök csak egy naptáreszközt használhat.

Időpontok lemondása​

Az időpontot foglaló hívók egy lemondási linket kapnak. Visszahívás nélkül, közvetlenül lemondhatják az időpontjukat.

eTermin időpontfoglalás​

Kösd be az eTermin integrációt, hogy az ügynökeid ellenőrizhessék az elérhetőséget és foglalhassanak, átütemezhessenek vagy lemondhassanak időpontokat élőben a hívás során, közvetlenül az eTermin naptáraidba és szolgáltatásaidba — beépített kettősfoglalás-védelemmel. Egyszerű naptár helyett akkor használj eTermint, ha az időpontjaid már az eTerminben élnek, és külön szolgáltatásokat kínálsz saját időtartammal és szabályokkal.

A csatlakozási lépésekért, az ügynökönkénti konfigurációért és a kettősfoglalás-védelemért lásd a teljes eTermin oldalt.

resmio asztalfoglalás​

Kösd be a resmio integrációt, hogy az ügynökeid éttermi asztalokat foglalhassanak közvetlenül a foglalási könyvedbe egy hívás során — valós elérhetőséget ellenőrizve idő és létszám szerint, valamint kezelve az átütemezéseket és lemondásokat. Akkor használj resmiót, ha az éttermed már azon keresztül fogad foglalásokat.

A csatlakozási lépésekért és részletekért lásd a teljes resmio oldalt.

Cselekvés csatlakoztatott fiókokon keresztül a munkafolyamatokban​

Az ügynök által élő hívás során használt, mindig aktív eszközökön túl a munkafolyamatoknak van egy dedikált Integration lépésük (a v2.8-ban került be). Helyezz el egy Integration lépést egy munkafolyamatba, hogy egyetlen lépésben cselekedjen egy csatlakoztatott Google Calendar, Outlook vagy HubSpot fiókon keresztül — például naptáresemény létrehozásához vagy egy HubSpot deal frissítéséhez egy nagyobb automatizált folyamat részeként. A lépés ugyanazokat a fiókszintű kapcsolatokat használja, amelyeket ezen az oldalon állítottál be, így nincs semmi extra engedélyeznivaló.

HubSpot CRM integráció​

Kösd be a HubSpot workspace-edet, hogy az AI hangügynökeid a hívás alatt olvashassanak és írhassanak kontaktokat és üzleteket, és hogy a HANC beépített CRM-je tükrözhesse a HubSpot pipeline-jaidat.

Mit tesz lehetővé​

  • Élő eszköz — HubSpot CRM az ügynök Actions fülén. Az ügynök telefonszám alapján párosíthatja a hívót egy HubSpot kontakthoz, lekérheti a deal állapotát, és frissítheti a tulajdonságokat az élő beszélgetésből. Lásd Actions & Tools.
  • Pipeline-tükrözés a HANC CRM-jében. A HubSpot deal állapotaid megjelennek a Deals kanbanban, így egymás mellett láthatod a hívásokat és a HubSpot kontextust.
  • Pipeline-onkénti AI kapcsoló — döntsd el, mely HubSpot pipeline-okon cselekedhet az AI; minden más csak olvasható marad.

Beállítási lépések​

  1. Nyisd meg az Integrations oldalt, és kattints a Connect HubSpot gombra.
  2. Engedélyezd a HANC-ot a HubSpot fiókodban.
  3. Válaszd ki, mely pipeline-okat kell tükrözni (a CRM → Pipeline beállítások alatt látható), és melyek engedélyezik az ügynöki állapotfrissítéseket.
  4. Add hozzá a HubSpot CRM eszközt bármelyik ügynökhöz, amelyiknek a hívás során hozzá kell nyúlnia a HubSpothoz.
tanács

Nem kell HubSpotot használnod ahhoz, hogy a HANC CRM-jét használd. A beépített CRM önállóan is működik — a HubSpot integráció kizárólag azoknak a szervezeteknek szól, amelyek már a HubSpotban élnek, és mindkét világot szinkronban szeretnék tartani.

MCP Servers​

A Model Context Protocol (MCP) egy nyílt szabvány az AI asszisztensek külső eszközökhöz kapcsolására. Ha MCP-kompatibilis szervert üzemeltetsz, egyszer regisztrálhatod az Integration oldalon, és az ügynökeiddel meghívathatod az eszközeit a beszélgetés közben.

Beállítási lépések (áttekintés)​

  1. Menj az Integration → MCP servers menüpontra.
  2. Kattints a Connect MCP server gombra, adj meg egy címkét és a szervered HTTPS URL-jét, válaszd ki a hitelesítést (None vagy Bearer token), és ments.
  3. Nyisd meg azt az ügynököt, amelyikkel használni szeretnéd az eszközöket, menj az Actions → Add Action → MCP servers menüpontra, és kapcsold be azokat a kapcsolatokat, amelyeket ennek az ügynöknek használnia kell.

Az ügynök minden hívás elején felfedezi és használja a szerver eszközeit.

A részletes beállításért, hibaelhárításért, és arról, hogyan illeszkedik az MCP a beépített eszközök mellé, lásd a teljes MCP Servers oldalt.

API Keys​

Generálj API-kulcsokat, hogy a Hanc.AI-t a saját alkalmazásaiddal integráld.

API-kulcs létrehozása​

Felhasználónként legfeljebb 3 API-kulcsot hozhatsz létre.

  1. Menj az Integration → API Keys menüpontra
  2. Kattints a „Create API Key" gombra
  3. Adj meg egy nevet (pl. „CRM Integration")
  4. Állítsd be az engedélyeket (read, write, admin)
  5. Másold ki a kulcsot azonnal (csak egyszer jelenik meg)

API-kulcs biztonsága​

Fontos
  • Tárold a kulcsokat biztonságosan (környezeti változók, secrets manager)
  • Soha ne commitold a kulcsokat verziókövetésbe
  • Rotáld a kulcsokat rendszeresen
  • Töröld a nem használt kulcsokat

API-kulcsok használata​

Add hozzá az API-kérésekhez:

curl -X GET "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

API-kulcs engedélyek​

EngedélyHozzáférés
ReadÜgynökök, hívások, analitika megtekintése
WriteÜgynökök létrehozása/módosítása, KB feltöltése
AdminMinden művelet, törlés, beállítások

Elérhető végpontok​

Az API-végpontok teljes listája, erőforrás szerint csoportosítva (Calls, Agents, Knowledge Base, Phone Numbers, Voices, Subscription, Customers, Workspaces) saját oldalon található:

→ Teljes API-referencia

Webhooks​

A Hanc.AI minden hívás után el tudja küldeni a hívást – az összefoglalót, az átiratot és a kinyert mezőket – JSON formátumban egy saját végpontra. Ez beállítható hívás utáni API hívás műveletként az ügynökön (Műveletek → Post call), vagy API-hívás lépésként egy munkafolyamatban.

Ha a fogadó szerver nem érhető el, a kérést a rendszer ütemezés szerint megismétli (alapértelmezés szerint 8 próbálkozás körülbelül 3,4 nap alatt), minden próbálkozást naplóz, a sikertelen kézbesítés pedig újraküldhető.

Az újrapróbálkozásokról, a kézbesítési naplóról, a tűzfalkövetelményekről és az adatformátumról lásd: Webhookok és kézbesítés.

Hívás utáni műveletek​

A hívás utáni műveletek automatikusan aktiválódnak, miután egy AI hangügynöki beszélgetés véget ér. Ezeket az egyes ügynökökön konfigurálhatod.

Elérhető művelettípusok​

MűveletLeírás
EmailKüldj e-mailes összefoglalót a hívásról (a vállalkozás tulajdonosának, az ügyfélnek, vagy mindkettőnek)
SMSKüldj SMS-értesítést a hívás után
WhatsAppKüldj WhatsApp-üzenetet a hívás után
API CallKüldj HTTP-kérést egy külső végpontra a hívás adataival

Beállítás​

  1. Menj a Voice Agents menüpontra → válaszd ki az ügynöködet
  2. Nyisd meg az Actions fület
  3. Kattints az „Add Action" gombra
  4. Válaszd ki a művelettípust és konfiguráld:
    • Trigger: Mikor aktiválódjon a művelet (pl. minden hívás után, csak bizonyos kimeneteknél)
    • Recipients: Ki kapja az értesítést
    • Content: Üzenetsablon a hívás adatváltozóival

Egyedi integrációk​

Az API használata​

Építs egyedi integrációkat a Hanc.AI API segítségével:

Base URL: https://api.hanc.ai/v1
Authentication: Bearer token (API key)
Format: JSON

API-dokumentáció​

Az elérhető végpontok teljes listájáért lásd az API-referenciát.

Integrációs bevált gyakorlatok​

Biztonság​

  • Tárold a hitelesítő adatokat biztonságosan
  • Rotáld az API-kulcsokat rendszeresen
  • Korlátozd az engedélyeket a szükséges minimumra

Megbízhatóság​

  • Naplózz minden integrációs eseményt
  • Figyeld az integrációk állapotát

Tesztelés​

  • Először staging környezetben teszteld az integrációkat
  • Ellenőrizd az adatáramlást mindkét irányban
  • Teszteld a hibaforgatókönyveket
  • Dokumentáld az integráció beállítását

Hibaelhárítás​

Az integráció nem csatlakozik​

  1. Ellenőrizd, hogy a hitelesítő adatok helyesek-e
  2. Ellenőrizd az elgépeléseket
  3. Győződj meg róla, hogy a harmadik fél fiókja aktív
  4. Próbáld meg szétkapcsolni és újracsatlakoztatni

A naptár nem szinkronizálódik​

  1. Engedélyezd újra a naptárhozzáférést
  2. Ellenőrizd a naptárengedélyeket
  3. Ellenőrizd, hogy a kiválasztott naptár helyes-e
  4. Ellenőrizd a szinkronizálási késéseket (akár 5 perc is lehet)

Kapcsolódó témák​