Přeskočit na hlavní obsah
DocumentationAPI ReferenceVideo Tutorials

Integrace

Integrace rozšiřují vaše AI hlasové agenty propojením s externími službami. Tato sekce pokrývá všechny dostupné integrace a jak je konfigurovat.

Dostupné integrace​

IntegraceÚčelStavPlány
Telefonní číslaTelefonní čísla a hovoryDostupnéVšechny
SIP TrunkPřineste si vlastního operátora (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Vlastní)DostupnéVšechny — vyžaduje schválení souladu
Google CalendarPlánování schůzek přes GoogleDostupnéVšechny
Outlook CalendarPlánování schůzek přes Microsoft OutlookDostupnéVšechny
HubSpot CRMČtení/zápis kontaktů a obchodů z vašeho AI hlasového agentaDostupnéVšechny
MCP serveryPřineste si vlastní MCP-kompatibilní tool server a zpřístupněte jeho nástroje agentům — viz MCP serveryDostupnéVšechny
API klíčePřístup externí aplikaceDostupnéVšechny
WebhookyNotifikace událostí v reálném časeDostupnéVšechny
Všechny plány

Integrace kalendáře, SIP, HubSpot, MCP servery, přístup k API a webhooky jsou dostupné na všech plánech, včetně Free. SIP trunking vyžaduje jednorázové schválení souladu, než se průvodce připojením odemkne.

Nastavení telefonního čísla​

Telefonní čísla umožňují vašim agentům přijímat a uskutečňovat skutečné telefonní hovory.

Kroky nastavení​

  1. Přejděte na Telefonní čísla v postranním panelu
  2. Klikněte na "Koupit číslo"
  3. Vyberte zemi a typ čísla
  4. Dokončete nákup
  5. Přiřaďte agenta k číslu

Čísla jsou po nákupu automaticky nakonfigurována a připravena k použití.

Integrace SIP Trunk​

Přineste si vlastního SIP operátora — HANC mluví SIP nativně a směruje příchozí hovory do vašeho AI hlasového agenta (a odchozí hovory zpět přes váš trunk). K dispozici na všech plánech včetně Free po jednorázovém schválení souladu.

Podporovaní operátoři​

HANC má vyladěné adaptéry pro následující operátory plus obecnou možnost pro cokoli jiného:

OperátorAutomatický import čísel přes APIPoznámky
sipgateAno (osobní přístupový token)SIP trunking pro EU
PlacetelManuálněNěmecký VoIP, přihlašovací údaje z webportálu
TENIOSManuálněEvropský SIP
easybellManuálněNěmecký operátor, přihlašovací údaje z Kundencenter
ZadarmaAno (volitelný API klíč)Globální čísla
Twilio (BYO)AnoAccount SID + Auth Token
TelnyxAnoAPI řízený SIP a DID čísla
Vlastní SIP trunkManuálněJakýkoli jiný poskytovatel — poskytněte host, port, transport

Schválení souladu​

Připojení SIP operátorů sdílí stejný tok souladu jako odchozí kampaně. Dokud váš účet není schválen, tlačítko Připojit SIP otevírá ukázkový modál se seznamem všech podporovaných operátorů s CTA mailto:support@hanc.ai. Schválení je obvykle ve stejný pracovní den.

Kroky nastavení (po schválení)​

  1. Přejděte na Telefonní čísla → Připojit SIP.
  2. Vyberte svého operátora.
  3. Zadejte SIP přihlašovací údaje (a volitelný API klíč/secret, pokud váš operátor podporuje automatický import).
  4. Pro Vlastní SIP také poskytněte host, port (výchozí 5060) a transport (UDP / TCP / TLS).
  5. Klikněte na Připojit — HANC zaregistruje vašeho SIP uživatele a, kde je to podporováno, vypíše vaše telefonní čísla.
  6. Vyberte čísla k importu (nebo přidejte manuálně přes E.164).
  7. Přiřaďte příchozího a/nebo odchozího agenta na každé číslo.

Kdy použít SIP vs. nákup čísla​

ScénářDoporučení
Nový v telefonních službáchKupte čísla přes HANC (jednodušší — žádný krok souladu)
Existující PBX nebo smlouva s operátoremPřipojte přes SIP — udržte si své číslo
Enterprise telefonie s přísnými požadavky operátoraSIP pro plnou kontrolu
Více regionů / soubory číselSIP pro flexibilitu

Integrace Google Calendar​

Připojte Google Calendar, abyste umožnili svým AI hlasovým agentům kontrolovat dostupnost a rezervovat schůzky během hovorů.

Kroky nastavení​

  1. Přejděte na Integrace → Kalendáře
  2. Klikněte na "Připojit Google Calendar"
  3. Přihlaste se přes Google
  4. Autorizujte přístup Hanc.AI

Požadovaná oprávnění:

  • Zobrazit události kalendáře (pro kontrolu dostupnosti)
  • Vytvořit události kalendáře (pro rezervaci schůzek)

Konfigurace kalendáře​

Po připojení nakonfigurujte nástroj kalendáře na svém agentovi:

NastaveníPopis
calendar_idKterý Google Calendar použít pro plánování
timezoneČasové pásmo pro plánování schůzek (např. Europe/Vienna)
work_hoursDostupné hodiny pro rezervaci (např. pondělí–pátek 9:00–18:00)
slot_durationVýchozí délka schůzky (např. 30 minut)
bufferRezerva mezi schůzkami (např. 15 minut)

Použití kalendáře v agentech​

Po připojení a konfiguraci mohou agenti:

  • Kontrolovat dostupnost pro konkrétní data a časy
  • Automaticky rezervovat schůzky
  • Respektovat pracovní hodiny a rezervní časy
  • Zpracovávat požadavky na přeobjednání

Příklad konverzace:

Zákazník: "Mohu si rezervovat schůzku na úterý ve tři odpoledne?"

Agent: [Kontroluje kalendář]
       "Ano, úterý ve tři odpoledne je dostupné.
        Mohu znát vaše jméno, abychom dokončili rezervaci?"

Integrace Outlook Calendar​

Připojte Microsoft Outlook Calendar pro umožnění plánování schůzek přes vaše AI hlasové agenty.

Kroky nastavení​

  1. Přejděte na Integrace → Kalendáře
  2. Klikněte na "Připojit Outlook Calendar"
  3. Přihlaste se svým Microsoft účtem
  4. Autorizujte přístup Hanc.AI

Požadovaná oprávnění:

  • Zobrazit události kalendáře (pro kontrolu dostupnosti)
  • Vytvořit události kalendáře (pro rezervaci schůzek)

Konfigurace kalendáře​

Po připojení nakonfigurujte nástroj kalendáře na svém agentovi:

NastaveníPopis
KalendářKterý Outlook kalendář použít pro plánování
Časové pásmoČasové pásmo pro plánování schůzek (např. Europe/Vienna)
Pracovní hodinyDostupné hodiny pro rezervaci (např. pondělí–pátek 9:00–18:00)
Délka slotuVýchozí délka schůzky (např. 30 minut)
RezervaRezerva mezi schůzkami (např. 15 minut)

Rozdíly oproti Google Calendar​

Obě integrace kalendáře fungují identicky z pohledu agenta. Jediný rozdíl je přihlašovací proces — vyberte si kalendářovou službu, kterou již používáte.

tip

Můžete připojit jak Google, tak Outlook kalendář současně, ale každý agent může používat pouze jeden nástroj kalendáře.

Rušení schůzek​

Volající, kteří si rezervovali schůzku, dostanou odkaz na zrušení. Mohou svou schůzku zrušit přímo, aniž by museli volat zpět.

Integrace HubSpot CRM​

Připojte svůj HubSpot workspace, aby vaši AI hlasoví agenti mohli číst a zapisovat kontakty a obchody během hovoru, a aby vestavěné CRM HANC mohlo zrcadlit vaše HubSpot pipeliny.

Co to umožňuje​

  • Živý nástroj — HubSpot CRM v kartě Akce agenta. Agent může spárovat volajícího s HubSpot kontaktem podle telefonu, načíst fázi obchodu a aktualizovat vlastnosti z živé konverzace. Viz Akce a nástroje.
  • Zrcadlení pipeline v CRM HANC. Vaše fáze obchodů HubSpot se objeví v kanbanu Obchody, takže můžete vidět hovory a HubSpot kontext vedle sebe.
  • Přepínač AI na pipeline — rozhodněte, na kterých HubSpot pipelinech smí AI jednat; vše ostatní zůstane pouze pro čtení.

Kroky nastavení​

  1. Otevřete stránku Integrace a klikněte na Připojit HubSpot.
  2. Autorizujte HANC ve svém HubSpot účtu.
  3. Vyberte, které pipeliny by měly být zrcadleny (viditelné v nastavení CRM → Pipeline) a které by měly umožnit aktualizace fáze agentem.
  4. Přidejte nástroj HubSpot CRM k jakémukoli agentovi, který by se měl během hovoru dotýkat HubSpotu.
tip

Nemusíte používat HubSpot, abyste mohli používat CRM HANC. Vestavěné CRM funguje samostatně — integrace HubSpot je čistě pro organizace, které již žijí v HubSpotu a chtějí oba světy v synchronizaci.

MCP servery​

Model Context Protocol (MCP) je otevřený standard pro propojení AI asistentů s externími nástroji. Pokud provozujete MCP-kompatibilní server, můžete ho jednou zaregistrovat na stránce Integrace a nechat své agenty volat jeho nástroje uprostřed konverzace.

Kroky nastavení (přehled)​

  1. Přejděte na Integrace → MCP servery.
  2. Klikněte na Připojit MCP server, zadejte label a HTTPS URL vašeho serveru, vyberte autentizaci (Žádná nebo Bearer token) a uložte.
  3. Otevřete agenta, který by měl nástroje používat, přejděte na Akce → Přidat akci → MCP servery a zapněte připojení, která má tento agent používat.

Agent objeví a použije nástroje serveru na začátku každého hovoru.

Viz úplná stránka MCP servery pro detailní nastavení, řešení problémů a jak MCP zapadá vedle vestavěných nástrojů.

API klíče​

Generujte API klíče pro integraci Hanc.AI s vašimi vlastními aplikacemi.

Vytvoření API klíče​

Můžete vytvořit až 3 API klíče na uživatele.

  1. Přejděte na Integrace → API klíče
  2. Klikněte na "Vytvořit API klíč"
  3. Zadejte název (např. "CRM integrace")
  4. Nastavte oprávnění (čtení, zápis, admin)
  5. Klíč okamžitě zkopírujte (zobrazuje se pouze jednou)

Zabezpečení API klíče​

Důležité
  • Ukládejte klíče bezpečně (proměnné prostředí, secrets manager)
  • Nikdy nezavádějte klíče do verzovacího systému
  • Pravidelně rotujte klíče
  • Smažte nepoužívané klíče

Použití API klíčů​

Zahrňte do API požadavků:

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

Oprávnění API klíče​

OprávněníPřístup
ReadZobrazit agenty, hovory, analytiku
WriteVytvářet/upravovat agenty, nahrávat KB
AdminVšechny operace, mazání, nastavení

Dostupné endpointy​

Úplný seznam API endpointů seskupený podle zdroje (Hovory, Agenti, Znalostní báze, Telefonní čísla, Hlasy, Předplatné, Zákazníci, Workspaces) je na vlastní stránce:

→ Úplná API reference

Webhooky​

Konfigurujte webhooky pro přijímání notifikací o událostech ve vašem účtu Hanc.AI v reálném čase.

Nastavení​

  1. Přejděte na Integrace → Webhooky
  2. Zadejte URL svého webhook endpointu
  3. Vyberte události k odběru
  4. Uložte konfiguraci

Webhooky odesílají HTTP POST požadavky na váš endpoint s daty události ve formátu JSON.

Akce po hovoru​

Akce po hovoru se automaticky spouštějí po skončení konverzace s AI hlasovým agentem. Nakonfigurujte je na jednotlivých agentech.

Dostupné typy akcí​

AkcePopis
EmailOdeslat e-mailové shrnutí hovoru (vlastníkovi firmy, zákazníkovi nebo oběma)
SMSOdeslat SMS notifikaci po hovoru
WhatsAppOdeslat WhatsApp zprávu po hovoru
API voláníProvést HTTP požadavek na externí endpoint s daty hovoru

Nastavení​

  1. Přejděte na AI hlasoví agenti → vyberte svého agenta
  2. Otevřete kartu Akce
  3. Klikněte na "Přidat akci"
  4. Vyberte typ akce a nakonfigurujte:
    • Spouštěč: Kdy se akce spouští (např. po každém hovoru, pouze při určitých výsledcích)
    • Příjemci: Kdo dostává notifikaci
    • Obsah: Šablona zprávy s proměnnými dat hovoru

Vlastní integrace​

Použití API​

Vytvářejte vlastní integrace pomocí Hanc.AI API:

Základní URL: https://api.hanc.ai/v1
Autentizace: Bearer token (API klíč)
Formát: JSON

Dokumentace API​

Viz API reference pro úplný seznam dostupných endpointů.

Osvědčené postupy integrace​

Zabezpečení​

  • Ukládejte přihlašovací údaje bezpečně
  • Pravidelně rotujte API klíče
  • Omezte oprávnění na minimum potřebné

Spolehlivost​

  • Logujte všechny události integrace
  • Sledujte zdraví integrace

Testování​

  • Otestujte integrace nejprve ve stagingu
  • Ověřte tok dat oběma směry
  • Otestujte chybové scénáře
  • Dokumentujte nastavení integrace

Řešení problémů​

Integrace se nepřipojí​

  1. Ověřte správnost přihlašovacích údajů
  2. Zkontrolujte překlepy
  3. Ujistěte se, že účet třetí strany je aktivní
  4. Zkuste odpojit a znovu připojit

Kalendář se nesynchronizuje​

  1. Znovu autorizujte přístup ke kalendáři
  2. Zkontrolujte oprávnění kalendáře
  3. Ověřte, že vybraný kalendář je správný
  4. Zkontrolujte zpoždění synchronizace (až 5 minut)

Související témata​