Elbuz łączy Aircall API z CRM: menedżer widzi kartę klienta, gdy dzwoni Aircall, wybiera numer klienta z karty przez Aircall Workspace, a każda rozmowa z nagraniem trafia do dziennika i historii klienta.
Kiedy to się przyda:
- Dzwoni klient — w Elbuz wyskakuje karta z imieniem, miastem i ostatnimi zamówieniami klienta.
- Połączenie nieodebrane — w „Pulsie” pojawia się zadanie „Oddzwoń”.
- Trzeba oddzwonić — „Zadzwoń” w karcie przekazuje numer do Workspace menedżera.
- Kierownik chce słyszeć rozmowy — nagranie i pocztę głosową odsłuchuje się z dziennika, a analiza AI pisze podsumowanie.
Od czego zacząć: wygeneruj API ID i API token w Aircall Dashboard.
Co potrafi integracja z Aircall
Przez Elbuz uruchamia połączenie w Twoim Aircall Workspace, co godzinę uzgadnia historię połączeń i pobiera linki do nagrań. Przez Aircall sam informuje Elbuz o każdym połączeniu. Główna różnica w stosunku do innych operatorów: w Aircall nie ma numerów wewnętrznych, dlatego pracownikowi w Elbuz wpisuje się jego użytkownika Aircall.
- Karta osoby, która dzwoni. Gdy dzwoni Aircall, wyskakuje „Połączenie przychodzące” z imieniem klienta, miastem i zamówieniami (karta połączenia).
- Nieodebrane staje się zadaniem. Jeśli połączenie szło do konkretnego użytkownika Aircall, menedżerowi wyskakuje „Nieodebrane połączenie” z przyciskiem „Oddzwoń”, a w „Pulsie” — zadanie z wysokim priorytetem; po rozmowie z tym numerem znika samo.
- Połączenie z karty klienta. Numer trafia do Workspace menedżera na komputerze (jak przebiega połączenie).
- Nagranie, tekst i podsumowanie. Nagranie Aircall odsłuchuje się z dziennika, a analiza AI pisze podsumowanie na oś zdarzeń klienta (analiza połączeń AI).
- Wszystkie rozmowy w jednym dzienniku. Przychodzące i wychodzące wszystkich menedżerów z wynikiem, czasem trwania i czasem oczekiwania (dziennik połączeń).
Czego potrzeba od Aircall
- Para API ID i API token z Dashboard → Integrations → API keys.
- Webhook na adres Elbuz — w tym samym koncie Aircall co klucze.
- Aircall Workspace na komputerze każdego menedżera, który dzwoni z Elbuz: z aplikacji mobilnej Aircall połączenia z Elbuz nie da się uruchomić.
- Telefony klientów z kodem kraju — numeru bez niego Aircall nie przyjmie (format numeru).
Nazwy pozycji Aircall Dashboard są po angielsku, jak w interfejsie Aircall. Ścieżki pochodzą z dokumentacji Aircall; jeśli pozycja nazywa się inaczej — kieruj się tymi stronami lub zapytaj wsparcie Aircall:
Jak podłączyć Aircall
Trzy kroki: klucze API, webhook i ID użytkowników.
Krok pierwszy: API ID i API token
- Aircall Dashboard → Integrations → API keys.
- Kliknij Generate API key (w prawym górnym rogu). Aircall pokaże parę: API ID i API token.
- Skopiuj od razu obie wartości: token Aircall pokazuje tylko raz, po zamknięciu okna nie będzie go widać. Zgubiony — wygeneruj nową parę na tej samej stronie.
Otwórz wiersz Aircall w grupie „Telefonia”. Przełącznik „Aktywność” jest już włączony — zostaw go tak. Pola:
| Pole w formularzu | Co wpisać |
|---|---|
| „API ID” | API ID z Aircall |
| „API token” | API token z tej samej pary |
| „Linia dla połączeń wychodzących” | numer Aircall, z którego dzwonić do klienta (można wpisać też ID numeru w Aircall). Puste — Elbuz tylko wstawi numer klienta do Workspace, a linię wybierze menedżer |
1
API ID i API token2
Linia dla połączeń wychodzących3
Sprawdź połączenie- API ID i API token — klucze z Twojego konta Aircall.
- Linia dla połączeń wychodzących — numer linii Aircall, z którego dzwoni się do klientów.
- Sprawdź połączenie — sprawdza klucze i pokazuje użytkowników Aircall z ich ID; w Aircall niczego nie zmienia.
Formularz zapisuje się sam mniej więcej sekundę po zmianie: na dole widać „Zapisywanie...”, a potem „Zapisano”. Na koniec kliknij „Sprawdź połączenie”. Elbuz odczyta listę użytkowników Aircall — na Twoim koncie niczego nie zmienia:
- odpowiedź „Połączono z centralą. Pracowników w centrali: ‹liczba›”;
- wiersz „Numery centrali bez pracownika Elbuz” — ID i imiona użytkowników Aircall, których nie wpisano jeszcze żadnemu pracownikowi;
- sprawdzenie odczytuje tylko jedną stronę listy (do pięćdziesięciu użytkowników): w dużym zespole pozostałe ID sprawdź w Aircall Dashboard.
Krok drugi: webhook w Aircall
- W formularzu Elbuz skopiuj adres z karty „Adres webhooka centrali” przyciskiem „Kopiuj”.
- Aircall Dashboard → Integrations → Webhooks → Add webhook → Install Webhook.
- Name — dowolna nazwa, — skopiowany adres. Events zostaw bez zmian: domyślnie włączone są wszystkie, a wśród nich te, których potrzebuje Elbuz.
- Kliknij Add Webhook.
1
Adres webhooka z zamaskowanym kluczem2
Kopiuj- Adres webhooka — wklej go w Aircall jako nowy webhook; klucz na końcu jest tu zamaskowany.
- Kopiuj — kopiuje adres do schowka.
Tokenu, który Aircall nadaje webhookowi, nie trzeba wpisywać w Elbuz. Każde zdarzenie Aircall zawiera ten token, a Elbuz sam poznaje go przez API — szuka wśród Twoich webhooków tego, który prowadzi na adres Elbuz. Dlatego webhook musi być utworzony w tym samym koncie Aircall, z którego pochodzą API ID i API token.
Po „Sprawdź połączenie” Elbuz zapamiętuje token z wyprzedzeniem. Jeśli webhook został utworzony od nowa, Elbuz zauważy nowy token przy pierwszym zdarzeniu i ponownie odczyta listę.
Krok trzeci: ID użytkowników Aircall w kartach pracowników
W Aircall nie ma numerów wewnętrznych: połączenie jest przypisane do użytkownika. Dlatego w pole „Telefon wewnętrzny” karty pracownika Elbuz wpisuje się jego ID użytkownika Aircall — liczbę. Listę ID pokazuje „Sprawdź połączenie” w wierszu „Numery centrali bez pracownika Elbuz”.
Po tym ID Elbuz wie, komu pokazać kartę połączenia przychodzącego, czyje imię wpisać w kolumnie „Menedżer” dziennika i z czyjego Workspace dzwonić, gdy menedżer kliknie „Zadzwoń”.
Aby Aircall zadziałał z Elbuz
Co trafia do Elbuz
| Funkcja | Jak to działa z Aircall |
|---|---|
| Połączenie z karty i dziennika („Zadzwoń”) | tak, przez Aircall Workspace na komputerze menedżera (jak przebiega połączenie) |
| Przychodzące i wychodzące w dzienniku | tak, ze zdarzeń webhooka: od razu po zakończeniu połączenia i ostatecznie — gdy Aircall zamknie połączenie |
| Karta przychodzącego w Elbuz, gdy dzwoni | tak: gdy połączenie dzwoni u konkretnego użytkownika Aircall, kartę widzi pracownik Elbuz z takim ID w „Telefon wewnętrzny” |
| Nagranie rozmowy i poczta głosowa | tak: link Elbuz pobiera z Aircall w chwili kliknięcia „Odsłuchaj nagranie” |
| Czas oczekiwania osobno od rozmowy | tak: Aircall przekazuje moment rozpoczęcia, odebrania i zakończenia |
| Cogodzinne uzgodnienie dziennika | tak, w 25. minucie każdej godziny za ostatnią dobę |
| Nazwa klienta na ekranie Aircall | nie: Aircall nie pyta Elbuz, kto dzwoni |
| Rozłączenie połączenia z karty przychodzącego | nie: w Aircall API nie ma takiej metody, w karcie nie ma przycisku „Rozłącz” |
| SMS przez Aircall | nie |
| Głosowy pracownik AI | nie: Aircall nie ma wśród operatorów sekcji „Głos przez telefon” |
Specyfika Aircall
Jak przebiega połączenie z przycisku „Zadzwoń”
Połączenie z Elbuz Aircall pozwala uruchomić tylko w Aircall Workspace na komputerze — z aplikacji mobilnej się nie da. Menedżer musi być w tym momencie dostępny i nie rozmawiać, inaczej Aircall odpowie „User not available”, a Elbuz pokaże „Centrala odrzuciła żądanie: HTTP 405: …”.
- „Linia dla połączeń wychodzących” jest wypełniona — Workspace menedżera sam wybiera numer klienta z tej linii. Menedżer musi być przypisany w Aircall do tego numeru. Jeśli takiego numeru lub ID nie ma na koncie, Elbuz odpowie „Centrala odrzuciła żądanie: Aircall number not found: ‹numer›”.
- Pole jest puste — numer klienta pojawi się w Workspace, a linię wybiera i połączenie uruchamia sam menedżer.
Aircall nie zwraca numeru połączenia w odpowiedzi na żądanie. Elbuz od razu zapisuje próbę w dzienniku, a gdy przyjdzie zdarzenie webhooka dotyczące tego samego numeru, dopisze do tego wiersza dane Aircall.
Format numeru klienta
Aircall przyjmuje numer klienta tylko w formacie międzynarodowym. Elbuz bierze cyfry z karty i stawia przed nimi „+”. Numer zapisany jako 512 345 678 zamieni się w +512345678 i Aircall odrzuci połączenie. Zapisuj telefony klientów z kodem kraju: +48 512 345 678.
Jakie zdarzenia Elbuz bierze z webhooka
| Zdarzenie Aircall | Co robi Elbuz |
|---|---|
call.ringing_on_agent | szuka klienta po numerze, zapisuje wiersz „Trwa teraz” i pokazuje kartę „Połączenie przychodzące” pracownikowi, który ma w „Telefon wewnętrzny” ten ID. Połączenie do zespołu (Team) bez konkretnego użytkownika karty nie daje |
call.hungup | od razu zapisuje połączenie w dzienniku — dane wstępne |
call.ended, call.voicemail_left | uzupełnia wiersz dziennika: wynik, czas trwania, informację o nagraniu |
call.comm_assets_generated | oznacza, że nagranie lub poczta głosowa są gotowe |
Pozostałe zdarzenia Elbuz przyjmuje i pomija.
| Co się stało | „Wynik” w dzienniku |
|---|---|
| odebrano | Odebrane |
| odebrano i przekierowano do innej osoby | Przekierowane |
| zostawiono wiadomość | Poczta głosowa |
| klient rozłączył się od razu, w menu głosowym lub w kolejce | Anulowane |
| połączenie jeszcze się nie skończyło | Trwa teraz |
| inaczej | Nieodebrane |
Nagrania rozmów
Link do nagrania Aircall wydaje na godzinę, dlatego Elbuz go nie przechowuje, tylko pobiera za każdym razem, gdy klikniesz „Odsłuchaj nagranie”. Jeśli nie ma nagrania, ale jest poczta głosowa, odtworzy się ona.
Cogodzinne uzgodnienie
Co godzinę Elbuz pobiera z Aircall połączenia z ostatniej doby i dopisuje to, czego nie przyniosły zdarzenia. Aircall pozwala na 120 zapytań API na minutę dla całej firmy, dlatego Elbuz robi pół sekundy przerwy między stronami, a gdy limit mimo to się wyczerpie — czeka 10 sekund i kontynuuje. Pozostałe Twoje integracje z Aircall dzielą ten sam limit.
Scenariusze
Wszyscy menedżerowie dzwonią z jednej linii firmy
Wpisz numer tej linii w „Linia dla połączeń wychodzących” i przypisz do niej w Aircall wszystkich menedżerów. „Zadzwoń” będzie od razu wybierać numer klienta z Workspace menedżera, niczego nie trzeba wybierać.
Menedżerowie mają różne linie
Zostaw „Linia dla połączeń wychodzących” puste. „Zadzwoń” wstawi numer klienta do Workspace, a menedżer sam wybierze linię i uruchomi połączenie.
Przychodzące idą do zespołu (Team)
Karta przychodzącego wyskoczy temu menedżerowi, u którego połączenie zadzwoniło jak u konkretnego użytkownika — w tym celu każdemu wpisano ID użytkownika Aircall. Dopóki połączenie czeka w zespole bez konkretnego użytkownika, karty nie ma; do dziennika i tak trafi — ze zdarzenia zakończenia lub z cogodzinnego uzgodnienia.
Co zrobić, gdy Aircall nie dzwoni lub połączenia nie docierają
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Centrala odrzuciła żądanie: HTTP 405: …” | Menedżer nie jest w Aircall Workspace na komputerze, nie ma statusu „dostępny” lub już rozmawia | Otwórz Workspace na komputerze, ustaw status dostępny i kliknij „Zadzwoń” jeszcze raz |
| „Centrala odrzuciła żądanie: HTTP 400: …” | Numer klienta bez kodu kraju — po dodaniu „+” powstał nieistniejący numer | Popraw telefon w karcie na format +48… (format numeru) |
| „Centrala odrzuciła żądanie: Aircall number not found: …” | W „Linia dla połączeń wychodzących” jest numer lub ID, którego nie ma na koncie Aircall | Wpisz numer linii tak, jak jest zapisany w Aircall, albo wyczyść pole |
| „W Twojej karcie pracownika nie podano wewnętrznego numeru telefonu” | Puste pole „Telefon wewnętrzny”: Elbuz nie wie, z czyjego Workspace dzwonić | Wpisz ID użytkownika Aircall (krok trzeci) |
| Połączenia pojawiają się w dzienniku dopiero po godzinie, karta przychodzącego nie wyskakuje | Webhook nie został utworzony, ma stary adres lub jest utworzony w innym koncie Aircall niż klucze API | Skopiuj ponownie adres z karty „Adres webhooka centrali” i sprawdź webhook w Integrations → Webhooks tego samego konta |
| W dzienniku w kolumnie „Menedżer” jest imię z Aircall, a nie pracownika Elbuz | W karcie pracownika nie wpisano jego ID użytkownika Aircall, więc połączenie nie jest do niego przypisywane | Weź ID z wiersza „Numery centrali bez pracownika Elbuz” i wpisz w „Telefon wewnętrzny” |
Pozostałe przypadki, gdy połączenie się nie pojawiło, — w ogólnym omówieniu Telefonia w Elbuz.
Najczęstsze pytania
Gdzie w Aircall wziąć API ID i API token?
Aircall Dashboard → Integrations → API keys → Generate API key. Aircall pokaże API ID i API token; token widać tylko raz, więc skopiuj go od razu i wpisz w pola „API ID” i „API token”.
Co wpisać w „Telefon wewnętrzny”, jeśli w Aircall nie ma numerów wewnętrznych?
ID użytkownika Aircall — liczbę. Listę ID pokazuje przycisk „Sprawdź połączenie” w wierszu „Numery centrali bez pracownika Elbuz”. Po tym ID Elbuz pokazuje kartę przychodzącego, podpisuje menedżera w dzienniku i dzwoni z jego Workspace.
Gdzie w Aircall wkleić adres z Elbuz?
Aircall Dashboard → Integrations → Webhooks → Add webhook → Install Webhook: w pole URL — adres z karty „Adres webhooka centrali”, zdarzenia zostaw domyślne, potem Add Webhook. Tokenu webhooka nie trzeba wpisywać w Elbuz.
Dlaczego „Zadzwoń” odpowiada HTTP 405?
Aircall uruchamia połączenie tylko w Workspace na komputerze i tylko wtedy, gdy użytkownik jest dostępny i nie rozmawia. Otwórz Workspace, przejdź na status „dostępny” i powtórz.
Czy można odsłuchać nagranie rozmowy Aircall z Elbuz?
Tak. „Odsłuchaj nagranie” za każdym razem prosi Aircall o świeży link, bo Aircall wydaje go na godzinę. Jeśli nie ma nagrania, ale klient zostawił wiadomość głosową, odtworzy się ona.
Czy można dzwonić z Elbuz przez aplikację mobilną Aircall?
Nie. Aircall uruchamia połączenie z Elbuz tylko w Workspace na komputerze.
Czy można rozłączyć połączenie Aircall z Elbuz?
Nie: w Aircall API nie ma takiej metody, dlatego w karcie przychodzącego nie ma przycisku „Rozłącz”.
Czy można ustawić głosowego pracownika AI na numerze Aircall?
Nie: Aircall nie ma wśród operatorów sekcji „Głos przez telefon”. Którzy operatorzy są obsługiwani — w artykule Głosowy pracownik AI.
Gdzie to jest i kto ma dostęp
- Menu
- „Panel klienta” → „Ustawienia systemu” → „Inne ustawienia” → „Usługi zewnętrzne i integracje” → „Telefonia” → Aircall
- ID użytkownika Aircall
- „Użytkownicy (pracownicy)” → karta pracownika → „Telefon wewnętrzny”
- Dziennik połączeń
- „Słowniki” → „Kontakty” → „Dziennik połączeń”
- Uprawnienia
- ustawienia systemu i okno „Dziennik połączeń”; aby po prostu dzwonić, uprawnienia nie są potrzebne
- Przygotuj
- dostęp do Aircall Dashboard; Aircall Workspace na komputerach menedżerów
Okno z wiersza operatora nazywa się „Ustawienia dostępu do API usług zewnętrznych”. Bez uprawnienia do „Dziennika połączeń” nie działają „Sprawdź połączenie” ani adres webhooka. Ogólne zasady — dziennik, karta połączenia, uprawnienia — w artykule Telefonia w Elbuz.
Powiązane tematy
- Jeśli trzeba zrozumieć dziennik, kartę połączenia lub to, kto co widzi — Telefonia w Elbuz.
- Jeśli menedżerowi trzeba wpisać ID Aircall w „Telefon wewnętrzny” — Karta pracownika.
- Jeśli trzeba znaleźć rozmowę w historii klienta — Karta kontrahenta.
- Jeśli potrzebny jest i dziennik połączeń, i głosowy AI na tym samym numerze — Zadarma i Elbuz.
