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

Integracje

Integracje rozszerzają Twoich agentów głosowych AI poprzez podłączanie do zewnętrznych usług. Ta sekcja obejmuje wszystkie dostępne integracje i sposób ich konfiguracji.

Dostępne integracje​

IntegracjaCelStatusPlany
Numery telefonówNumery telefonów i połączeniaDostępneWszystkie
Trunk SIPPrzynieś własnego operatora (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Niestandardowy)DostępneWszystkie — wymaga zgody compliance
Google CalendarPlanowanie wizyt przez GoogleDostępneWszystkie
Outlook CalendarPlanowanie wizyt przez Microsoft OutlookDostępneWszystkie
HubSpot CRMOdczyt/zapis kontaktów i transakcji z Twojego agenta głosowego AIDostępneWszystkie
Serwery MCPPrzynieś własny serwer narzędzi kompatybilny z MCP i udostępnij jego narzędzia agentom — patrz Serwery MCPDostępneWszystkie
Klucze APIDostęp dla zewnętrznych aplikacjiDostępneWszystkie
WebhookiPowiadomienia o zdarzeniach w czasie rzeczywistymDostępneWszystkie
Wszystkie plany

Integracje kalendarza, SIP, HubSpot, serwery MCP, dostęp do API i webhooki są dostępne we wszystkich planach, w tym Free. Trunking SIP wymaga jednorazowej zgody compliance, zanim kreator połączeń się odblokuje.

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 skonfigurowane i gotowe do użycia po zakupie.

Integracja trunka SIP​

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

Obsługiwani operatorzy​

HANC ma dostrojone adaptery dla następujących operatorów oraz ogólną opcję dla wszystkich pozostałych:

OperatorAuto-import numerów przez APIUwagi
sipgateTak (Personal Access Token)Trunking SIP w UE
PlacetelRęcznyNiemiecki VoIP, poświadczenia z Webportalu
TENIOSRęcznyEuropejski SIP
easybellRęcznyNiemiecki operator, poświadczenia z Kundencenter
ZadarmaTak (opcjonalny klucz API)Globalne numery
Twilio (BYO)TakAccount SID + Auth Token
TelnyxTakSIP i DID napędzane API
Niestandardowy trunk SIPRęcznyDowolny inny dostawca — podaj host, port, transport

Zgoda compliance​

Podłączenia operatorów SIP używają tego samego procesu compliance co kampanie wychodzące. Dopóki Twoje konto nie zostanie zatwierdzone, przycisk Podłącz SIP otwiera modal prezentacji z listą wszystkich obsługiwanych operatorów z CTA mailto:support@hanc.ai. Zatwierdzenie zwykle tego samego dnia roboczego.

Kroki konfiguracji (po zatwierdzeniu)​

  1. Przejdź do Numery telefonów → Podłącz SIP.
  2. Wybierz swojego operatora.
  3. Wprowadź poświadczenia SIP (i opcjonalny klucz/sekret API, jeśli Twój operator wspiera auto-import).
  4. Dla Niestandardowego SIP podaj także host, port (domyślnie 5060) i transport (UDP / TCP / TLS).
  5. Kliknij Podłącz — HANC rejestruje Twojego użytkownika SIP i tam, gdzie wspierane, wymienia Twoje numery telefonów.
  6. Wybierz numery do zaimportowania (lub dodaj ręcznie przez E.164).
  7. Przypisz agenta przychodzącego i/lub wychodzącego do każdego numeru.

Kiedy używać SIP vs. kupowania numeru​

ScenariuszRekomendacja
Nowy w usłudze telefonicznejKup numery przez HANC (prostsze — brak kroku compliance)
Istniejący PBX lub kontrakt z operatoremPodłącz przez SIP — zachowaj swój numer
Telefonia korporacyjna ze ścisłymi wymaganiami operatoraSIP dla pełnej kontroli
Wiele regionów / puli numerówSIP dla elastyczności

Integracja Google Calendar​

Podłącz Google Calendar, aby umożliwić swoim agentom głosowym AI sprawdzanie dostępności i rezerwowanie wizyt podczas połączeń.

Kroki konfiguracji​

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

Wymagane uprawnienia:

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

Konfiguracja kalendarza​

Po podłączeniu skonfiguruj narzędzie kalendarza na swoim agencie:

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

Użycie kalendarza w agentach​

Po podłączeniu i skonfigurowaniu agenci mogą:

  • Sprawdzać dostępność dla konkretnych dat i godzin
  • Automatycznie rezerwować wizyty
  • Respektować godziny pracy i czasy buforów
  • 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ę poznać Pana/Pani imię, aby dokończyć rezerwację?"

Integracja Outlook Calendar​

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

Kroki konfiguracji​

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

Wymagane uprawnienia:

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

Konfiguracja kalendarza​

Po podłączeniu skonfiguruj narzędzie kalendarza na swoim agencie:

UstawienieOpis
KalendarzKtóry kalendarz Outlook używać do planowania
Strefa czasowaStrefa czasowa dla planowania wizyt (np. Europe/Vienna)
Godziny pracyDostępne godziny rezerwacji (np. poniedziałek-piątek 9:00-18:00)
Długość slotuDomyślna długość wizyty (np. 30 minut)
BuforBufor czasowy 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 podłączyć jednocześnie zarówno Google, jak 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 anulujący. Mogą anulować swoją wizytę bezpośrednio bez konieczności oddzwaniania.

Integracja HubSpot CRM​

Podłącz swoją przestrzeń roboczą HubSpot, aby Twoi agenci głosowi AI mogli odczytywać i zapisywać kontakty oraz transakcje podczas połączenia, a wbudowany CRM HANC mógł odzwierciedlać Twoje pipeline'y HubSpot.

Co 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. Patrz Akcje i narzędzia.
  • Odzwierciedlanie pipeline'u w CRM HANC. Twoje etapy transakcji HubSpot pokazują się w kanbanie Transakcje, dzięki czemu możesz widzieć połączenia i kontekst HubSpot obok siebie.
  • Przełącznik AI per pipeline — zdecyduj, 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 na swoim koncie HubSpot.
  3. Wybierz, które pipeline'y mają być odzwierciedlane (widoczne pod ustawieniami CRM → Pipeline) i które mają zezwalać na aktualizacje etapów przez agenta.
  4. Dodaj narzędzie HubSpot CRM do dowolnego agenta, który ma dotykać HubSpot podczas połączenia.
wskazówka

Nie musisz używać HubSpot, aby używać CRM HANC. Wbudowany CRM działa samodzielnie — integracja 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 kompatybilny z MCP, możesz zarejestrować go raz na stronie Integracji i pozwolić swoim agentom 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 URL HTTPS swojego serwera, wybierz uwierzytelnianie (Brak lub Bearer token) i zapisz.
  3. Otwórz agenta, który ma używać narzędzi, przejdź do Akcje → Dodaj akcję → Serwery MCP i włącz połączenia, których ten agent ma używać.

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

Zobacz pełną stronę Serwery MCP dla szczegółowej konfiguracji, rozwiązywania problemów i tego, jak MCP wpasowuje się obok wbudowanych narzędzi.

Klucze API​

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

Tworzenie klucza API​

Możesz utworzyć do 3 kluczy 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 (pokazany tylko raz)

Bezpieczeństwo klucza API​

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

Używanie kluczy API​

Dołącz do zapytań API:

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

Uprawnienia klucza API​

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

Dostępne endpointy​

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

→ Pełna referencja API

Webhooki​

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

Konfiguracja​

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

Webhooki wysyłają żądania HTTP POST na Twój endpoint z danymi zdarzenia w formacie JSON.

Akcje po rozmowie​

Akcje po rozmowie uruchamiają się automatycznie po zakończeniu rozmowy z agentem głosowym AI. Skonfiguruj je na poszczególnych agentach.

Dostępne typy akcji​

AkcjaOpis
EmailWyślij podsumowanie rozmowy emailem (do właściciela biznesu, 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 rozmowy

Konfiguracja​

  1. Przejdź do Agenci głosowi AI → 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 konkretnych wynikach)
    • Odbiorcy: Kto otrzymuje powiadomienie
    • Treść: Szablon wiadomości ze zmiennymi z danych rozmowy

Niestandardowe integracje​

Używanie API​

Buduj niestandardowe integracje za pomocą API Hanc.AI:

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

Dokumentacja API​

Zobacz Referencję API dla pełnej listy dostępnych endpointów.

Najlepsze praktyki integracji​

Bezpieczeństwo​

  • Przechowuj poświadczenia bezpiecznie
  • Rotuj klucze API regularnie
  • Ogranicz uprawnienia do minimalnie potrzebnych

Niezawodność​

  • Loguj wszystkie zdarzenia integracji
  • Monitoruj stan integracji

Testowanie​

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

Rozwiązywanie problemów​

Integracja nie chce się podłączyć​

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

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​