Przejdź do głównej zawartości
DocumentationAPI ReferenceVideo Tutorials

Integracje

Integracje rozszerzają możliwości Twoich agentów głosowych poprzez podłączanie do zewnętrznych usług. Ta sekcja obejmuje wszystkie dostępne integracje oraz sposób ich konfiguracji.

Dostępne integracje​

IntegracjaCelStatusPlany
Numery telefonówNumery telefonów i połączeniaDostępneWszystkie
SIP TrunkPodłącz własnego operatora (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Niestandardowy)DostępneWszystkie — wymaga zatwierdzenia zgodności
Google CalendarRezerwacja wizyt przez GoogleDostępneWszystkie
Outlook CalendarRezerwacja wizyt przez Microsoft OutlookDostępneWszystkie
eTerminSprawdzaj dostępność oraz rezerwuj/przekładaj/anuluj wizyty na żywo — zobacz eTerminDostępneWszystkie
resmioRezerwuj stoliki w restauracji w księdze rezerwacji na żywo — zobacz resmioDostępneWszystkie
HubSpot CRMOdczyt/zapis kontaktów i transakcji z agenta głosowegoDostępneWszystkie
Serwery MCPPodłącz własny serwer narzędzi zgodny z MCP i udostępnij jego narzędzia agentom — zobacz Serwery MCPDostępneWszystkie
Klucze APIDostęp aplikacji zewnętrznychDostępneWszystkie
WebhookiPowiadomienia o zdarzeniach w czasie rzeczywistymDostępneWszystkie
Wszystkie plany

Integracje kalendarzy, SIP, HubSpot, serwery MCP, dostęp API oraz webhooki są dostępne we wszystkich planach, w tym w planie Free. SIP trunking wymaga jednorazowego zatwierdzenia zgodności, zanim kreator połączenia zostanie odblokowany.

Konfiguracja numeru telefonu​

Numery telefonów pozwalają Twoim agentom odbierać i wykonywać prawdziwe połączenia telefoniczne.

Kroki konfiguracji​

  1. Przejdź do Numery telefonów w panelu bocznym
  2. Kliknij „Kup numer"
  3. Wybierz kraj i typ numeru
  4. Dokończ zakup
  5. Przypisz agenta do numeru

Numery są automatycznie konfigurowane i gotowe do użycia po zakupie.

Integracja SIP Trunk​

Podłącz własnego operatora SIP — HANC mówi natywnie w SIP i kieruje połączenia przychodzące do Twojego agenta głosowego (a połączenia wychodzące z powrotem przez Twój trunk). Dostępne we wszystkich planach, w tym Free po jednorazowym zatwierdzeniu zgodności.

Obsługiwani operatorzy​

HANC ma dostrojone adaptery dla następujących operatorów, plus opcję ogólną dla wszystkiego innego:

OperatorAuto-import numerów przez APIUwagi
sipgateTak (Personal Access Token)SIP trunking w UE
PlacetelRęcznieNiemiecki VoIP, dane logowania Webportal
TENIOSRęcznieEuropejski SIP
easybellRęcznieNiemiecki operator, dane logowania Kundencenter
ZadarmaTak (opcjonalny klucz API)Numery globalne
Twilio (BYO)TakAccount SID + Auth Token
TelnyxTakSIP i DID sterowane przez API
Niestandardowy SIP trunkRęcznieDowolny inny dostawca — podaj host, port, transport

Zatwierdzenie zgodności​

Połączenia operatorów SIP korzystają z tego samego procesu zgodności co kampanie wychodzące. Dopóki Twoje konto nie zostanie zatwierdzone, przycisk Podłącz SIP otwiera okno prezentacyjne z listą wszystkich obsługiwanych operatorów oraz CTA mailto:support@hanc.ai. Zatwierdzenie zwykle następuje jeszcze tego samego dnia roboczego.

Kroki konfiguracji (po zatwierdzeniu)​

  1. Przejdź do Numery telefonów → Podłącz SIP.
  2. Wybierz swojego operatora.
  3. Wprowadź dane logowania SIP (oraz opcjonalny klucz API / sekret, jeśli Twój operator obsługuje auto-import).
  4. Dla niestandardowego SIP podaj również host, port (domyślnie 5060) i transport (UDP / TCP / TLS).
  5. Kliknij Połącz — HANC rejestruje Twojego użytkownika SIP i tam, gdzie to obsługiwane, wyświetla listę Twoich numerów telefonów.
  6. Wybierz numery do zaimportowania (lub dodaj ręcznie w formacie E.164).
  7. Przypisz agenta przychodzącego i/lub wychodzącego do każdego numeru.

Kiedy używać SIP, a kiedy kupować numer​

ScenariuszRekomendacja
Nowość w usługach telefonicznychKup numery przez HANC (prościej — bez etapu zgodności)
Istniejąca centrala PBX lub umowa z operatoremPodłącz przez SIP — zachowaj swój numer
Telefonia korporacyjna ze ścisłymi wymaganiami operatoraSIP dla pełnej kontroli
Wiele regionów / pule numerówSIP dla elastyczności

Integracja Google Calendar​

Podłącz Google Calendar, aby umożliwić Twoim agentom głosowym sprawdzanie dostępności i rezerwowanie wizyt podczas rozmów.

Kroki konfiguracji​

  1. Przejdź do Integracja → Kalendarze
  2. Kliknij „Podłącz Google Calendar"
  3. Zaloguj się przez Google
  4. Autoryzuj dostęp Hanc.AI

Żądane uprawnienia:

  • Wyświetlanie wydarzeń w kalendarzu (do sprawdzania dostępności)
  • Tworzenie wydarzeń w kalendarzu (do rezerwowania wizyt)

Konfiguracja kalendarza​

Po podłączeniu skonfiguruj narzędzie kalendarza u swojego agenta:

UstawienieOpis
calendar_idKtóry Google Calendar używać do planowania
timezoneStrefa czasowa dla planowania wizyt (np. Europe/Vienna)
work_hoursDostępne godziny do rezerwacji (np. poniedziałek-piątek 9:00-18:00)
slot_durationDomyślna długość wizyty (np. 30 minut)
bufferCzas buforowy między wizytami (np. 15 minut)

Użycie kalendarza u agentów​

Po podłączeniu i skonfigurowaniu agenci mogą:

  • Sprawdzać dostępność dla konkretnych dat i godzin
  • Rezerwować wizyty automatycznie
  • Respektować godziny pracy i czasy buforowe
  • Obsługiwać prośby o przełożenie

Przykładowa rozmowa:

Klient: „Czy mogę zarezerwować wizytę na wtorek o 15:00?"

Agent: [Sprawdza kalendarz]
       „Tak, wtorek o 15:00 jest dostępny.
        Czy mogę prosić o Pana nazwisko, aby dokończyć rezerwację?"

Integracja Outlook Calendar​

Podłącz Microsoft Outlook Calendar, aby umożliwić rezerwację wizyt przez Twoich agentów głosowych.

Kroki konfiguracji​

  1. Przejdź do Integracja → Kalendarze
  2. Kliknij „Podłącz Outlook Calendar"
  3. Zaloguj się swoim kontem Microsoft
  4. Autoryzuj dostęp Hanc.AI

Żądane uprawnienia:

  • Wyświetlanie wydarzeń w kalendarzu (do sprawdzania dostępności)
  • Tworzenie wydarzeń w kalendarzu (do rezerwowania wizyt)

Konfiguracja kalendarza​

Po podłączeniu skonfiguruj narzędzie kalendarza u swojego agenta:

UstawienieOpis
KalendarzKtóry kalendarz Outlook używać do planowania
Strefa czasowaStrefa czasowa dla planowania wizyt (np. Europe/Vienna)
Godziny pracyDostępne godziny do rezerwacji (np. poniedziałek-piątek 9:00-18:00)
Długość slotuDomyślna długość wizyty (np. 30 minut)
BuforCzas buforowy między wizytami (np. 15 minut)

Różnice względem Google Calendar​

Obie integracje kalendarza działają identycznie z perspektywy agenta. Jedyną różnicą jest proces logowania — wybierz tę usługę kalendarza, której już używasz.

wskazówka

Możesz jednocześnie podłączyć kalendarze Google i Outlook, ale każdy agent może używać tylko jednego narzędzia kalendarza.

Anulowanie wizyt​

Dzwoniący, którzy zarezerwowali wizytę, otrzymują link do anulowania. Mogą anulować swoją wizytę bezpośrednio, bez potrzeby ponownego dzwonienia.

Rezerwacja wizyt eTermin​

Podłącz eTermin, aby Twoi agenci mogli sprawdzać dostępność oraz rezerwować, przekładać lub anulować wizyty na żywo podczas rozmowy, bezpośrednio w Twoich kalendarzach i usługach eTermin — z wbudowaną ochroną przed podwójną rezerwacją. Użyj eTermin zamiast zwykłego kalendarza, gdy Twoje wizyty żyją już w eTermin i oferujesz odrębne usługi z własnym czasem trwania i zasadami.

Zobacz pełną stronę eTermin, aby poznać kroki połączenia, konfigurację per agent i ochronę przed podwójną rezerwacją.

Rezerwacje stolików resmio​

Podłącz resmio, aby Twoi agenci mogli rezerwować stoliki w restauracji bezpośrednio w Twojej księdze rezerwacji podczas rozmowy — sprawdzając rzeczywistą dostępność według czasu i liczby osób oraz obsługując przekładanie i anulowanie. Użyj resmio, gdy Twoja restauracja już przyjmuje przez nie rezerwacje.

Zobacz pełną stronę resmio, aby poznać kroki połączenia i szczegóły.

Działanie przez połączone konta w przepływach pracy​

Poza zawsze aktywnymi narzędziami, których agent używa podczas rozmowy na żywo, przepływy pracy mają dedykowany krok Integracja (dodany w v2.8). Umieść krok Integracja w przepływie pracy, aby działał przez połączone konto Google Calendar, Outlook lub HubSpot w jednym kroku — na przykład utwórz wydarzenie w kalendarzu lub zaktualizuj transakcję HubSpot jako część większego zautomatyzowanego przepływu. Krok używa tych samych połączeń na poziomie konta, które skonfigurowałeś na tej stronie, więc nie ma nic dodatkowego do autoryzowania.

Integracja HubSpot CRM​

Podłącz swój workspace HubSpot, aby Twoi agenci głosowi mogli odczytywać i zapisywać kontakty oraz transakcje podczas rozmowy, a wbudowany CRM HANC mógł odzwierciedlać Twoje pipeline'y HubSpot.

Co to umożliwia​

  • Narzędzie na żywo — HubSpot CRM w zakładce Akcje agenta. Agent może dopasować dzwoniącego do kontaktu HubSpot po telefonie, pobrać etap transakcji i zaktualizować właściwości z rozmowy na żywo. Zobacz Akcje i narzędzia.
  • Odzwierciedlanie pipeline'ów w CRM HANC. Etapy transakcji HubSpot pojawiają się w kanban Transakcje, więc możesz widzieć połączenia i kontekst HubSpot obok siebie.
  • Przełącznik AI per pipeline — decyduj, na których pipeline'ach HubSpot AI może działać; wszystko inne pozostaje tylko do odczytu.

Kroki konfiguracji​

  1. Otwórz stronę Integracje i kliknij Podłącz HubSpot.
  2. Autoryzuj HANC w swoim koncie HubSpot.
  3. Wybierz, które pipeline'y mają być odzwierciedlane (widoczne w ustawieniach CRM → Pipeline) i które mają zezwalać na aktualizacje etapów przez agenta.
  4. Dodaj narzędzie HubSpot CRM do każdego agenta, który powinien dotykać HubSpot podczas rozmowy.
wskazówka

Nie musisz używać HubSpot, aby korzystać z CRM HANC. Wbudowany CRM działa samodzielnie — integracja z HubSpot jest wyłącznie dla organizacji, które już żyją w HubSpot i chcą mieć oba światy zsynchronizowane.

Serwery MCP​

Model Context Protocol (MCP) to otwarty standard łączenia asystentów AI z zewnętrznymi narzędziami. Jeśli prowadzisz serwer zgodny z MCP, możesz zarejestrować go raz na stronie Integracja i sprawić, że Twoi agenci będą wywoływać jego narzędzia w trakcie rozmowy.

Kroki konfiguracji (przegląd)​

  1. Przejdź do Integracja → Serwery MCP.
  2. Kliknij Podłącz serwer MCP, wprowadź etykietę i adres HTTPS swojego serwera, wybierz uwierzytelnianie (Brak lub token Bearer) i zapisz.
  3. Otwórz agenta, u którego chcesz używać narzędzi, przejdź do Akcje → Dodaj akcję → Serwery MCP i włącz połączenia, których ten agent powinien używać.

Agent odkryje i będzie używać narzędzi serwera na początku każdej rozmowy.

Zobacz pełną stronę Serwery MCP, aby poznać szczegółową konfigurację, rozwiązywanie problemów oraz sposób, w jaki MCP funkcjonuje obok wbudowanych narzędzi.

Klucze API​

Generuj klucze API, aby zintegrować Hanc.AI z własnymi aplikacjami.

Tworzenie klucza API​

Możesz utworzyć maksymalnie 3 klucze API na użytkownika.

  1. Przejdź do Integracja → Klucze API
  2. Kliknij „Utwórz klucz API"
  3. Wprowadź nazwę (np. „Integracja CRM")
  4. Ustaw uprawnienia (odczyt, zapis, admin)
  5. Skopiuj klucz natychmiast (pokazywany tylko raz)

Bezpieczeństwo kluczy API​

Ważne
  • Przechowuj klucze bezpiecznie (zmienne środowiskowe, menedżer sekretów)
  • Nigdy nie umieszczaj kluczy w systemie kontroli wersji
  • Rotuj klucze okresowo
  • Usuwaj nieużywane klucze

Używanie kluczy API​

Dołącz w żądaniach API:

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

Uprawnienia kluczy API​

UprawnienieDostęp
OdczytWyświetlanie agentów, połączeń, analityki
ZapisTworzenie/modyfikowanie agentów, wgrywanie KB
AdminWszystkie operacje, usuwanie, ustawienia

Dostępne endpointy​

Pełna lista endpointów API, pogrupowanych według zasobu (Połączenia, Agenci, Baza wiedzy, Numery telefonów, Głosy, Subskrypcja, Klienci, Workspace'y), znajduje się na osobnej stronie:

→ Pełne API Reference

Webhooki​

Skonfiguruj webhooki, aby otrzymywać powiadomienia o zdarzeniach w Twoim koncie Hanc.AI w czasie rzeczywistym.

Konfiguracja​

  1. Przejdź do Integracja → Webhooki
  2. Wprowadź adres URL endpointu swojego webhooka
  3. Wybierz zdarzenia, na które chcesz się zapisać
  4. Zapisz konfigurację

Webhooki wysyłają żądania HTTP POST do Twojego endpointu z danymi zdarzenia w formacie JSON.

Akcje po rozmowie​

Akcje po rozmowie wyzwalają się automatycznie po zakończeniu rozmowy z agentem głosowym. Skonfiguruj je u poszczególnych agentów.

Dostępne typy akcji​

AkcjaOpis
EmailWyślij e-mailowe podsumowanie rozmowy (do właściciela firmy, klienta lub obu)
SMSWyślij powiadomienie SMS po rozmowie
WhatsAppWyślij wiadomość WhatsApp po rozmowie
Wywołanie APIWykonaj żądanie HTTP do zewnętrznego endpointu z danymi połączenia

Konfiguracja​

  1. Przejdź do Agenci głosowi → wybierz swojego agenta
  2. Otwórz zakładkę Akcje
  3. Kliknij „Dodaj akcję"
  4. Wybierz typ akcji i skonfiguruj:
    • Wyzwalacz: Kiedy akcja się uruchamia (np. po każdej rozmowie, tylko przy określonych wynikach)
    • Odbiorcy: Kto otrzymuje powiadomienie
    • Treść: Szablon wiadomości ze zmiennymi danych połączenia

Niestandardowe integracje​

Używanie API​

Buduj niestandardowe integracje za pomocą API Hanc.AI:

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

Dokumentacja API​

Zobacz API Reference, aby uzyskać pełną listę dostępnych endpointów.

Najlepsze praktyki integracji​

Bezpieczeństwo​

  • Przechowuj dane uwierzytelniające bezpiecznie
  • Rotuj klucze API regularnie
  • Ograniczaj uprawnienia do niezbędnego minimum

Niezawodność​

  • Loguj wszystkie zdarzenia integracji
  • Monitoruj stan integracji

Testowanie​

  • Testuj integracje najpierw w środowisku testowym
  • Weryfikuj przepływ danych w obu kierunkach
  • Testuj scenariusze błędów
  • Dokumentuj konfigurację integracji

Rozwiązywanie problemów​

Integracja nie chce się połączyć​

  1. Zweryfikuj, czy dane uwierzytelniające są poprawne
  2. Sprawdź literówki
  3. Upewnij się, że konto strony trzeciej jest aktywne
  4. Spróbuj odłączyć i podłączyć ponownie

Kalendarz się nie synchronizuje​

  1. Ponownie autoryzuj dostęp do kalendarza
  2. Sprawdź uprawnienia kalendarza
  3. Zweryfikuj, czy wybrany kalendarz jest poprawny
  4. Sprawdź opóźnienia synchronizacji (do 5 minut)

Powiązane tematy​