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

Integrace

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

Dostupné integrace​

IntegraceÚčelStavTarify
Telefonní číslaTelefonní čísla a hovoryDostupnéVšechny
SIP TrunkVlastní operátor (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom)DostupnéVšechny — vyžaduje schválení compliance
Google CalendarPlánování schůzek přes GoogleDostupnéVšechny
Outlook CalendarPlánování schůzek přes Microsoft OutlookDostupnéVšechny
eTerminKontrola dostupnosti a rezervace/přeobjednání/rušení schůzek naživo — viz eTerminDostupnéVšechny
resmioRezervace stolů v restauraci do vaší rezervační knihy naživo — viz resmioDostupnéVšechny
HubSpot CRMČtení/zápis kontaktů a obchodů z vašeho hlasového agentaDostupnéVšechny
MCP serveryVlastní MCP-kompatibilní server nástrojů a zpřístupnění jeho nástrojů agentům — viz MCP serveryDostupnéVšechny
API klíčePřístup pro externí aplikaceDostupnéVšechny
WebhookyOznámení o událostech v reálném časeDostupnéVšechny
Všechny tarify

Kalendářové integrace, SIP, HubSpot, MCP servery, přístup k API a webhooky jsou dostupné ve všech tarifech, včetně Free. SIP trunking vyžaduje jednorázové schválení compliance, než se odemkne průvodce propojením.

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 k číslu agenta

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

Integrace SIP Trunk​

Přineste si vlastního operátora SIP — HANC hovoří SIP nativně a směruje příchozí hovory do vašeho hlasového agenta (a odchozí hovory zpět přes váš trunk). Dostupné ve všech tarifech včetně Free po jednorázovém schválení compliance.

Podporovaní operátoři​

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

OperátorAutomatický import čísel přes APIPoznámky
sipgateAno (Personal Access Token)EU SIP trunking
PlacetelRučněNěmecké VoIP, přihlašovací údaje Webportal
TENIOSRučněEvropské SIP
easybellRučněNěmecký operátor, přihlašovací údaje Kundencenter
ZadarmaAno (volitelný API klíč)Globální čísla
Twilio (BYO)AnoAccount SID + Auth Token
TelnyxAnoSIP a DID řízené přes API
Custom SIP trunkRučněJakýkoli jiný poskytovatel — zadejte host, port, transport

Schválení compliance​

Propojení operátorů SIP prochází stejným procesem compliance jako odchozí kampaně. Dokud není váš účet schválen, otevře tlačítko Propojit SIP ukázkové okno se seznamem všech podporovaných operátorů a výzvou (CTA) mailto:support@hanc.ai. Schválení obvykle proběhne během téhož pracovního dne.

Kroky nastavení (po schválení)​

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

Kdy použít SIP vs. koupit číslo​

ScénářDoporučení
Nováček v telefonních službáchKupte čísla přes HANC (jednodušší — bez kroku compliance)
Stávající PBX nebo smlouva s operátoremPřipojte přes SIP — ponechte si své číslo
Podniková telefonie s přísnými požadavky operátoraSIP pro plnou kontrolu
Více regionů / poolů číselSIP pro flexibilitu

Integrace Google Calendar​

Propojte Google Calendar, aby vaši hlasoví agenti mohli během hovorů kontrolovat dostupnost a rezervovat schůzky.

Kroky nastavení​

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

Požadovaná oprávnění:

  • Zobrazovat události kalendáře (pro kontrolu dostupnosti)
  • Vytvářet události kalendáře (pro rezervaci schůzek)

Konfigurace kalendáře​

Po propojení nakonfigurujte kalendářový nástroj na vašem 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 propojení a konfiguraci mohou agenti:

  • Kontrolovat dostupnost pro konkrétní data a časy
  • Automaticky rezervovat schůzky
  • Respektovat pracovní dobu a rezervy (buffery)
  • Zpracovávat žádosti o přeobjednání

Ukázková konverzace:

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

Agent: [Zkontroluje kalendář]
       „Ano, úterý ve 3 odpoledne je volné.
        Mohu poprosit o vaše jméno pro dokončení rezervace?"

Integrace Outlook Calendar​

Propojte Microsoft Outlook Calendar, abyste umožnili plánování schůzek prostřednictvím vašich hlasových agentů.

Kroky nastavení​

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

Požadovaná oprávnění:

  • Zobrazovat události kalendáře (pro kontrolu dostupnosti)
  • Vytvářet události kalendáře (pro rezervaci schůzek)

Konfigurace kalendáře​

Po propojení nakonfigurujte kalendářový nástroj na vašem 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í dobaDostupné hodiny pro rezervaci (např. pondělí–pátek 9:00–18:00)
Délka slotuVýchozí délka schůzky (např. 30 minut)
Rezerva (buffer)Rezerva mezi schůzkami (např. 15 minut)

Rozdíly oproti Google Calendar​

Obě kalendářové integrace fungují z pohledu agenta identicky. Jediný rozdíl je v přihlašovacím procesu — vyberte si tu kalendářovou službu, kterou už používáte.

tip

Můžete propojit kalendáře Google i Outlook zároveň, ale každý agent může používat pouze jeden kalendářový nástroj.

Rušení schůzek​

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

Rezervace schůzek přes eTermin​

Propojte eTermin, aby vaši agenti mohli kontrolovat dostupnost a rezervovat, přeobjednávat nebo rušit schůzky naživo během hovoru, přímo do vašich kalendářů a služeb eTermin — se zabudovanou ochranou proti dvojité rezervaci. Použijte eTermin místo běžného kalendáře, když vaše schůzky už žijí v eTerminu a nabízíte odlišné služby s vlastními délkami trvání a pravidly.

Kroky propojení, konfiguraci pro jednotlivé agenty a ochranu proti dvojité rezervaci najdete na kompletní stránce eTermin.

resmio – rezervace stolů​

Propojte resmio, aby vaši agenti mohli rezervovat stoly v restauraci přímo do vaší rezervační knihy během hovoru — kontrolovat skutečnou dostupnost podle času a počtu osob a zpracovávat přeobjednání a rušení. Použijte resmio, když vaše restaurace už přes něj přijímá rezervace.

Kroky propojení a podrobnosti najdete na kompletní stránce resmio.

Jednání přes propojené účty ve workflow​

Kromě stále zapnutých nástrojů, které agent používá během živého hovoru, mají workflow vyhrazený krok Integrace (přidán ve v2.8). Vložte do workflow krok Integrace, aby v jediném kroku jednal přes propojený účet Google Calendar, Outlook nebo HubSpot — například vytvořil událost v kalendáři nebo aktualizoval obchod v HubSpotu jako součást většího automatizovaného toku. Krok používá stejná propojení na úrovni účtu, která nastavíte na této stránce, takže není potřeba nic dalšího autorizovat.

Integrace HubSpot CRM​

Propojte svůj workspace HubSpot, aby vaši hlasoví agenti mohli během hovoru číst a zapisovat kontakty a obchody a aby vestavěné CRM v HANC mohlo zrcadlit vaše pipeline v HubSpotu.

Co to umožňuje​

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

Kroky nastavení​

  1. Otevřete stránku Integrace a klikněte na Propojit HubSpot.
  2. Autorizujte HANC ve svém účtu HubSpot.
  3. Vyberte, které pipeline mají být zrcadleny (viditelné v nastavení CRM → Pipeline) a které mají umožnit aktualizace fází agentem.
  4. Přidejte nástroj HubSpot CRM ke každému agentovi, který by měl během hovoru pracovat s HubSpotem.
tip

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

MCP servery​

Model Context Protocol (MCP) je otevřený standard pro propojení asistentů AI s externími nástroji. Pokud provozujete MCP-kompatibilní server, můžete jej 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 Propojit MCP server, zadejte štítek a HTTPS URL vašeho serveru, zvolte autentizaci (žádná nebo Bearer token) a uložte.
  3. Otevřete agenta, u kterého chcete nástroje použít, přejděte na Akce → Přidat akci → MCP servery a zapněte propojení, která má tento agent používat.

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

Podrobné nastavení, řešení problémů a to, jak MCP zapadá vedle vestavěných nástrojů, najdete na kompletní stránce MCP servery.

API klíče​

Vygenerujte 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 Integration")
  4. Nastavte oprávnění (čtení, zápis, admin)
  5. Klíč okamžitě zkopírujte (zobrazí se pouze jednou)

Zabezpečení API klíčů​

Důležité
  • Ukládejte klíče bezpečně (proměnné prostředí, správce tajemství)
  • Nikdy klíče nevkládejte do verzovacího systému
  • Klíče pravidelně obnovujte
  • Nepoužívané klíče mažte

Používání API klíčů​

Vložte do požadavků na API:

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

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

OprávněníPřístup
ReadZobrazení agentů, hovorů, analytiky
WriteVytváření/úprava agentů, nahrávání znalostní báze
AdminVšechny operace, mazání, nastavení

Dostupné endpointy​

Kompletní seznam API endpointů, seskupených podle zdroje (Hovory, Agenti, Znalostní báze, Telefonní čísla, Hlasy, Předplatné, Zákazníci, Workspacy), žije na vlastní stránce:

→ Kompletní API reference

Webhooky​

Po každém hovoru může Hanc.AI odeslat hovor – souhrn, přepis a vaše extrahovaná pole – na váš vlastní endpoint ve formátu JSON. Nastavte to jako akci API volání po hovoru u agenta (Akce → Post call) nebo jako krok Volání API ve workflow.

Pokud váš server není dostupný, požadavek se opakuje podle rozvrhu (ve výchozím nastavení 8 pokusů během přibližně 3,4 dne), každý pokus se zaznamená a neúspěšné doručení lze odeslat znovu.

Opakování, protokol doručení, požadavky na firewall a formát dat popisuje stránka Webhooky a doručování.

Akce po hovoru​

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

Dostupné typy akcí​

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

Nastavení​

  1. Přejděte na 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 spustí (např. po každém hovoru, jen při konkrétních výsledcích)
    • Příjemci: Kdo oznámení obdrží
    • Obsah: Šablona zprávy s proměnnými dat hovoru

Vlastní integrace​

Použití API​

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

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

Dokumentace API​

Kompletní seznam dostupných endpointů najdete v API reference.

Osvědčené postupy pro integrace​

Bezpečnost​

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

Spolehlivost​

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

Testování​

  • Nejprve testujte integrace ve stagingu
  • Ověřte tok dat v obou směrech
  • Testujte chybové scénáře
  • Zdokumentujte nastavení integrace

Řešení problémů​

Integrace se nepropojí​

  1. Ověřte, že jsou přihlašovací údaje správné
  2. Zkontrolujte překlepy
  3. Ujistěte se, že účet třetí strany je aktivní
  4. Zkuste odpojit a znovu propojit

Kalendář se nesynchronizuje​

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

Související témata​