Ugrás a fő tartalomhoz
DocumentationAPI ReferenceVideo Tutorials

Integrációk

Az integrációk kibővítik az AI hangügynökeit külső szolgáltatásokhoz történő csatlakoztatással. Ez a szakasz az összes elérhető integrációt és azok konfigurálását tárgyalja.

Elérhető integrációk​

IntegrációCélÁllapotCsomagok
TelefonszámokTelefonszámok és hívásokElérhetőMinden
SIP-trunkHozza saját szolgáltatóját (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, egyéni)ElérhetőMinden — megfelelőségi jóváhagyást igényel
Google NaptárIdőpont-egyeztetés Google-on keresztülElérhetőMinden
Outlook naptárIdőpont-egyeztetés Microsoft Outlookon keresztülElérhetőMinden
HubSpot CRMOlvasás/írás kapcsolatokba és üzletekbe az AI hangügynökébőlElérhetőMinden
MCP szerverekHozza saját MCP-kompatibilis eszközszerverét, és tegye elérhetővé az eszközeit az ügynökök számára — lásd MCP szerverekElérhetőMinden
API-kulcsokKülső alkalmazás-hozzáférésElérhetőMinden
WebhookokValós idejű esemény-értesítésekElérhetőMinden
Minden csomag

A naptár-integrációk, SIP, HubSpot, MCP-szerverek, API-hozzáférés és webhookok minden csomagon elérhetők, beleértve a Free-t is. A SIP trunking egyszeri megfelelőségi jóváhagyást igényel, mielőtt a csatlakozási varázsló feloldódik.

Telefonszám beállítása​

A telefonszámok lehetővé teszik az ügynökök számára, hogy valódi telefonhívásokat fogadjanak és indítsanak.

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

  1. Menjen a Telefonszámok menüpontra az oldalsávon
  2. Kattintson a „Szám vásárlása" gombra
  3. Válasszon országot és számtípust
  4. Fejezze be a vásárlást
  5. Rendelje hozzá az ügynököt a számhoz

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

SIP-trunk integráció​

Hozza saját SIP-szolgáltatóját — a HANC natívan beszéli a SIP-et, és a bejövő hívásokat az AI hangügynökébe irányítja (a kimenő hívásokat pedig a trunkjén keresztül vissza). Elérhető minden csomagon, beleértve a Free-t is egyszeri megfelelőségi jóváhagyás után.

Támogatott szolgáltatók​

A HANC az alábbi szolgáltatókhoz hangolt adaptereket biztosít, plusz egy általános opciót minden máshoz:

SzolgáltatóAutomatikus szám-importálás API-n keresztülMegjegyzések
sipgateIgen (Personal Access Token)EU SIP trunking
PlacetelKéziNémet VoIP, Webportál 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
Egyéni SIP-trunkKéziBármely más szolgáltató — adja meg a hostot, portot, transportot

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

A SIP-szolgáltatói kapcsolatok ugyanazt a megfelelőségi folyamatot követik, mint a kimenő kampányok. Amíg fiókja nincs jóváhagyva, a SIP csatlakoztatása gomb egy bemutató modált 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 az aktuális munkanapon megtörténik.

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

  1. Menjen a Telefonszámok → SIP csatlakoztatása menüpontra.
  2. Válassza ki szolgáltatóját.
  3. Adja meg a SIP hitelesítő adatokat (és opcionális API-kulcsot/titkot, ha a szolgáltatója támogatja az automatikus importálást).
  4. Egyéni SIP esetén adja meg a hostot, portot (alapértelmezett 5060) és transportot (UDP / TCP / TLS).
  5. Kattintson a Csatlakozás gombra — a HANC regisztrálja a SIP-felhasználóját, és ahol támogatott, listázza a telefonszámait.
  6. Válassza ki az importálandó számokat (vagy adjon hozzá kézzel E.164 formátumban).
  7. Rendeljen bejövő és/vagy kimenő ügynököt minden számhoz.

Mikor használjon SIP-et vs. számot vásároljon​

ForgatókönyvAjánlás
Új a telefonszolgáltatásbanVásároljon 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ésCsatlakozzon SIP-en keresztül — tartsa meg a számát
Vállalati telefonia szigorú szolgáltatói követelményekkelSIP a teljes ellenőrzéshez
Több régió / szám-poolokSIP a rugalmasságért

Google Naptár integráció​

Csatlakoztassa a Google Naptárt, hogy az AI hangügynökei ellenőrizhessék az elérhetőséget, és időpontokat foglalhassanak a hívások során.

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

  1. Menjen az Integráció → Naptárak menüpontra
  2. Kattintson a „Google Naptár csatlakoztatása" gombra
  3. Jelentkezzen be Google-fiókkal
  4. Engedélyezze a Hanc.AI hozzáférést

Kért engedélyek:

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

Naptár-konfiguráció​

A csatlakozás után konfigurálja a naptár-eszközt az ügynökén:

BeállításLeírás
calendar_idMely Google Naptárt használja az ütemezéshez
timezoneIdőzóna az időpont-egyeztetéshez (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)
bufferPufferidő az időpontok között (pl. 15 perc)

Naptár-használat az ügynökökben​

Csatlakoztatás és konfigurálás után az ügynökök képesek:

  • Ellenőrizni az elérhetőséget meghatározott dátumokra és időpontokra
  • Időpontokat foglalni automatikusan
  • Tiszteletben tartani a munkaidőt és a pufferidőket
  • Kezelni az átütemezési kéréseket

Példa beszélgetés:

Ügyfél: „Foglalhatok időpontot keddre 15 órára?"

Ügynök: [Ellenőrzi a naptárt]
       „Igen, kedden 15 órakor van szabad időpont.
        Megkaphatom a nevét a foglalás befejezéséhez?"

Outlook naptár integráció​

Csatlakoztassa a Microsoft Outlook naptárt, hogy időpont-egyeztetést tegyen lehetővé az AI hangügynökein keresztül.

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

  1. Menjen az Integráció → Naptárak menüpontra
  2. Kattintson az „Outlook naptár csatlakoztatása" gombra
  3. Jelentkezzen be Microsoft-fiókjával
  4. Engedélyezze a Hanc.AI hozzáférést

Kért engedélyek:

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

Naptár-konfiguráció​

A csatlakozás után konfigurálja a naptár-eszközt az ügynökén:

BeállításLeírás
NaptárMely Outlook naptárt használja az ütemezéshez
IdőzónaIdőzóna az időpont-egyeztetéshez (pl. Europe/Vienna)
MunkaidőFoglalásra elérhető órák (pl. hétfő-péntek 9:00-18:00)
Slot-időtartamAlapértelmezett időpont-hossz (pl. 30 perc)
PufferPufferidő az időpontok között (pl. 15 perc)

Különbségek a Google Naptárhoz képest​

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

tanács

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

Időpontok lemondása​

A foglaló hívók lemondási linket kapnak. Közvetlenül lemondhatják az időpontjukat anélkül, hogy vissza kellene hívniuk.

HubSpot CRM integráció​

Csatlakoztassa HubSpot munkaterét, hogy az AI hangügynökei a hívás alatt olvashassanak és írhassanak kapcsolatokba és üzletekbe, és hogy a HANC beépített CRM-je tükrözze a HubSpot pipeline-jait.

Mit tesz lehetővé​

  • Élő eszköz — HubSpot CRM az ügynök Műveletek lapján. Az ügynök telefonszám alapján egyeztetheti a hívót egy HubSpot-kapcsolathoz, lekérheti az üzlet szakaszát, és tulajdonságokat frissíthet az élő beszélgetésből. Lásd Műveletek és eszközök.
  • Pipeline-tükrözés a HANC CRM-jében. A HubSpot üzlet-szakaszai megjelennek az Üzletek kanbanban, így a hívásokat és a HubSpot-kontextust egymás mellett láthatja.
  • Pipeline-szintű AI-kapcsoló — döntse el, mely HubSpot pipeline-okra hagyhat az AI hatni; minden más csak olvasható marad.

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

  1. Nyissa meg az Integrációk oldalt, és kattintson a HubSpot csatlakoztatása gombra.
  2. Engedélyezze a HANC-ot a HubSpot-fiókjában.
  3. Válassza ki, mely pipeline-okat tükrözze (látható a CRM → Pipeline beállítások alatt), és melyek engedjék az ügynök-szakaszfrissítéseket.
  4. Adja hozzá a HubSpot CRM eszközt bármely ügynökhöz, amelynek a hívás során érintenie kell a HubSpot-ot.
tanács

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

MCP szerverek​

A Model Context Protocol (MCP) egy nyílt szabvány az AI-asszisztensek külső eszközökhöz történő csatlakoztatására. Ha MCP-kompatibilis szervert futtat, egyszer regisztrálhatja az Integráció oldalon, és az ügynökei beszélgetés közben hívhatják az eszközeit.

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

  1. Menjen az Integráció → MCP szerverek menüpontra.
  2. Kattintson az MCP szerver csatlakoztatása gombra, adjon meg egy címkét és a szerver HTTPS URL-jét, válasszon hitelesítést (Nincs vagy Bearer token), és mentse.
  3. Nyissa meg azt az ügynököt, amellyel az eszközöket szeretné használni, menjen a Műveletek → Művelet hozzáadása → MCP szerverek menüpontra, és kapcsolja be azokat a kapcsolatokat, amelyeket az ügynöknek használnia kell.

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

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

API-kulcsok​

Generáljon API-kulcsokat a Hanc.AI saját alkalmazásokkal való integrálásához.

API-kulcs létrehozása​

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

  1. Menjen az Integráció → API-kulcsok menüpontra
  2. Kattintson az „API-kulcs létrehozása" gombra
  3. Adjon meg egy nevet (pl. „CRM-integráció")
  4. Állítson be engedélyeket (olvasás, írás, admin)
  5. Másolja a kulcsot azonnal (csak egyszer jelenik meg)

API-kulcs biztonsága​

Fontos
  • Tárolja a kulcsokat biztonságosan (környezeti változók, titokkezelő)
  • Soha ne kommitolja a kulcsokat verziókezelésbe
  • Időszakonként cserélje a kulcsokat
  • Törölje a nem használt kulcsokat

API-kulcsok használata​

Foglalja bele az API-kérésekbe:

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
OlvasásÜgynökök, hívások, analitika megtekintése
ÍrásÜ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​

A teljes API-végpontok listája, erőforrás szerint csoportosítva (Hívások, Ügynökök, Tudásbázis, Telefonszámok, Hangok, Előfizetés, Ügyfelek, Munkaterek), saját oldalon él:

→ Teljes API-referencia

Webhookok​

Konfiguráljon webhookokat, hogy valós idejű értesítéseket kapjon a Hanc.AI-fiókjában történő eseményekről.

Beállítás​

  1. Menjen az Integráció → Webhookok menüpontra
  2. Adja meg a webhook végpontjának URL-jét
  3. Válassza ki, mely eseményekre szeretne feliratkozni
  4. Mentse a konfigurációt

A webhookok HTTP POST kéréseket küldenek a végpontjára eseményadatokkal JSON formátumban.

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

A hívás utáni műveletek automatikusan elindulnak, miután egy AI hangügynök-beszélgetés véget ér. Konfigurálja ezeket az egyes ügynökökön.

Elérhető művelettípusok​

MűveletLeírás
E-mailE-mail összefoglaló küldése a hívásról (vállalkozás tulajdonosának, ügyfélnek vagy mindkettőnek)
SMSSMS-értesítés küldése a hívás után
WhatsAppWhatsApp-üzenet küldése a hívás után
API-hívásHTTP-kérés indítása külső végpontra híváskaadatokkal

Beállítás​

  1. Menjen az AI hangügynökök → válassza ki az ügynökét
  2. Nyissa meg a Műveletek lapot
  3. Kattintson a „Művelet hozzáadása" gombra
  4. Válassza ki a művelet típusát, és konfigurálja:
    • Trigger: Mikor lép működésbe a művelet (pl. minden hívás után, csak meghatározott kimenetelek esetén)
    • Címzettek: Ki kapja az értesítést
    • Tartalom: Üzenet-sablon híváskaadat-változókkal

Egyéni integrációk​

Az API használata​

Építsen egyéni integrációkat a Hanc.AI API használatával:

Alap URL: https://api.hanc.ai/v1
Hitelesítés: Bearer token (API-kulcs)
Formátum: JSON

API dokumentáció​

A teljes elérhető végpontlista az API-referencia oldalon található.

Integrációs bevált gyakorlatok​

Biztonság​

  • Tárolja a hitelesítő adatokat biztonságosan
  • Rendszeresen cserélje az API-kulcsokat
  • Korlátozza az engedélyeket a szükséges minimumra

Megbízhatóság​

  • Naplózza az összes integrációs eseményt
  • Figyelje az integráció állapotát

Tesztelés​

  • Először tesztelje az integrációkat stagingben
  • Ellenőrizze az adatáramlást mindkét irányba
  • Tesztelje a hibaforgatókönyveket
  • Dokumentálja az integráció beállítását

Hibaelhárítás​

Az integráció nem csatlakozik​

  1. Ellenőrizze, hogy a hitelesítő adatok helyesek-e
  2. Ellenőrizze az elgépeléseket
  3. Győződjön meg róla, hogy a harmadik féltől származó fiók aktív
  4. Próbálja meg leválasztani és újra csatlakoztatni

A naptár nem szinkronizálódik​

  1. Engedélyezze újra a naptár-hozzáférést
  2. Ellenőrizze a naptár-engedélyeket
  3. Ellenőrizze, hogy a kiválasztott naptár helyes-e
  4. Ellenőrizze a szinkronizációs késéseket (akár 5 percig)

Kapcsolódó témák​