--- title: "Używaj ThunderPhone z Zapier" description: "Połącz aplikację ThunderPhone w Zapier ze swoją organizacją i utwórz Zap uruchamiany za każdym razem, gdy połączenie się kończy." --- [Zapier](https://zapier.com) łączy aplikacje za pomocą zautomatyzowanych przepływów pracy nazywanych Zapami. Aplikacja ThunderPhone w Zapier oferuje: - **Wyzwalacze:** **Call Completed** uruchamia się po zakończeniu połączenia telefonicznego, internetowego lub testowego. **Call Graded** uruchamia się, gdy dostępna jest ocena zakończonego połączenia. - **Akcje:** **Place Outbound Call**, **Add Contacts to Campaign** oraz **Start Campaign**. - **Wyszukiwanie:** **Find Call** wyszukuje połączenie według identyfikatora i zwraca je wraz z transkrypcją oraz podpisanym adresem URL nagrania, jeśli jest dostępne. Znajdziesz ją na stronie [ThunderPhone w Zapier](https://zapier.com/apps/thunderphone/integrations). Aby poznać oba sposoby korzystania z Zapier z ThunderPhone, zobacz [stronę integracji z Zapier](https://thunderphone.com/integrations/zapier). ## Połącz swoją organizację Aplikacja łączy się przez OAuth. Logujesz się do ThunderPhone i zatwierdzasz dostęp dla jednej organizacji, bez kopiowania klucza API do Zapier. W edytorze Zap wyszukaj **ThunderPhone** (wyświetlane z etykietą Beta) i wybierz wyzwalacz lub akcję. Gdy Zapier poprosi o konto, połącz nowe. Zapier otworzy okno logowania ThunderPhone. Zaloguj się, sprawdź wymagane uprawnienia, wybierz organizację i kliknij **Zatwierdź**. Aplikacja prosi o dostęp do odczytu Twoich agentów i numerów telefonów, odczytu i zapisu połączeń oraz kampanii, zarządzania integracjami, takimi jak punkty końcowe webhooków, a także wyświetlania adresu e-mail konta. Zapier nadaje połączeniu nazwę zatwierdzonej organizacji, dzięki czemu możesz rozróżniać połączenia, gdy należysz do więcej niż jednej organizacji. Połącz konto z rolą administratora lub właściciela w tej organizacji. Włączanie i wyłączanie wyzwalacza Zap oraz każda akcja wymagają tej roli. Wyzwalacz Zap, który jest już włączony, nadal otrzymuje zdarzenia połączeń po zmianie roli lub cofnięciu połączenia. Wyłącz go, aby je zatrzymać. Funkcja Find Call działa dla każdego członka. Aplikacja nie nalicza własnych opłat ThunderPhone. Połączenia, które wykonuje lub uruchamia, są rozliczane według standardowych stawek ThunderPhone, a Zapier nalicza zadania w ramach Twojego planu Zapier. ## Utwórz pierwszy Zap Ten Zap dodaje wiersz do Arkuszy Google za każdym razem, gdy połączenie się kończy. Otwórz agenta w kreatorze, kliknij **Rozmawiaj** i zakończ połączenie. Połączenia testowe w kreatorze wywołują zdarzenie Połączenie zakończone, więc wyzwalacz otrzyma ostatnie połączenie do załadowania. Wybierz **ThunderPhone** jako aplikację wyzwalającą, ustaw zdarzenie na **Połączenie zakończone** i wybierz połączenie z ThunderPhone. Przetestuj wyzwalacz. Zapier ładuje ostatnio zakończone połączenia jako przykłady, w tym samym formacie co zdarzenie na żywo. Dodaj akcję Arkuszy Google, która tworzy wiersz w arkuszu. Wybierz arkusz z wierszem nagłówków, a następnie przypisz każdą kolumnę do pola z wyzwalacza (zobacz tabelę poniżej). Opublikuj i włącz Zap. Włączenie go tworzy punkt końcowy webhooka w organizacji ThunderPhone o nazwie **Zapier: Połączenie zakończone**. Wyłączenie Zapa usuwa ten punkt końcowy. Wykonaj kolejne połączenie testowe w kreatorze. Gdy się zakończy, Zap zostanie uruchomiony i pojawi się wiersz. Przydatne kolumny: | Kolumna | Pole Połączenie zakończone | |---|---| | ID połączenia | ID połączenia | | Agent | Nazwa agenta | | Kierunek | Kierunek | | Od | Numer źródłowy | | Do | Numer docelowy | | Rozpoczęto | Rozpoczęto o | | Zakończono | Zakończono o | | Czas trwania (s) | Czas trwania w sekundach | | Status | Status | | Powód zakończenia | Powód zakończenia | | Link do połączenia | Wpisz `https://app.thunderphone.com/dashboard/call-history/`, a następnie wstaw ID połączenia | Link do połączenia otwiera połączenie w panelu ThunderPhone dla członków Twojej organizacji wraz z jego transkrypcją i nagraniem, więc arkusz nie musi przechowywać żadnego z nich. Zdarzenie może także zawierać transkrypcję jako listę wypowiedzi oraz adres URL nagrania — podpisany link, który wygasa. Dodawaj je tylko wtedy, gdy arkusz ich potrzebuje. Transkrypcje połączeń, podsumowania i nagrania mogą zawierać dane osobowe lub informacje o zdrowiu. Wysyłaj je wyłącznie do aplikacji, których Twoja organizacja może używać do takich danych, na podstawie umowy BAA, gdy dotyczą informacji o zdrowiu, i zachowuj tylko potrzebne pola. Zobacz [`telephony.complete` / `web.complete`](/pl/webhooks/call-complete), aby poznać wszystkie pola. Każde dostarczenie jest podpisane. Aplikacja sprawdza kod HMAC `X-ThunderPhone-Signature` względem sekretu punktu końcowego przed uruchomieniem Zapa i zatrzymuje się przy każdym niepodpisanym lub nieprawidłowym żądaniu. Jeśli Zapier nie zaakceptuje dostarczenia, ThunderPhone ponawia je przez maksymalnie 24 godziny. Zobacz [Omówienie webhooków](/pl/webhooks/overview). ## Wyzwalacze, akcje i wyszukiwanie **Połączenie ocenione** udostępnia identyfikator połączenia, identyfikator agenta, nazwę agenta oraz ocenę: identyfikator oceny, wynik, rezultat połączenia, podsumowanie, model oceniający i czas oceny. Włączenie Zapa tworzy punkt końcowy o nazwie **Zapier: Połączenie ocenione**. Połączenie może zostać ocenione więcej niż raz, a każde zakończone uruchomienie oceny wyzwala wyzwalacz. Zobacz [`call.graded`](/pl/webhooks/events). **Znajdź połączenie** przyjmuje identyfikator połączenia wraz z listą rozwijaną ostatnich połączeń. Zwraca agenta połączenia, kierunek, numery, czas rozpoczęcia i zakończenia, status, powód zakończenia, wynik oceny i rezultat połączenia, transkrypcję oraz podpisany adres URL nagrania, gdy jest dostępny. Nieznany identyfikator połączenia nie zwraca wyniku zamiast błędu. **Wykonaj połączenie wychodzące** przyjmuje: | Pole | Znaczenie | |---|---| | Agent | Zapisany agent. Lista rozwijana zawiera Twoich agentów. | | Numer docelowy | Numer docelowy w formacie E.164, na przykład `+14155552671`. | | Numer źródłowy | Lista rozwijana zawiera tylko numery włączone dla połączeń wychodzących. | | Zmienne | Opcjonalny obiekt JSON z wartościami dla symboli zastępczych w promptcie agenta. | | Klucz idempotencji | Stały identyfikator z wyzwalacza lub rekordu źródłowego. Wymagany. | Zwraca identyfikator połączenia, status i odtworzenie idempotentne. **Dodaj kontakty do kampanii** dodaje kontakty do kampanii roboczej. W przypadku jednego kontaktu wypełnij pole **Numer telefonu** w formacie E.164 oraz opcjonalnie **Zmienne kontaktu**, obiekt JSON, którego właściwości stają się zmiennymi kampanii. W przypadku partii wypełnij pole **Kontakty JSON** tablicą zawierającą maksymalnie 5000 obiektów. Każdy wymaga `phone_number`, a jego pozostałe właściwości stają się zmiennymi. Krok kończy się niepowodzeniem, gdy każdy kontakt zostanie odrzucony, i ustawia **Częściowy sukces**, gdy zostaną przyjęte tylko niektóre. **Rozpocznij kampanię** rozpoczyna lub wznawia kampanię mającą co najmniej jeden kontakt. Wymaga **Zgody na obciążenie**. Zobacz [Kampanie wychodzące](/pl/guides/outbound-campaigns). ## Przed wykonywaniem połączeń przez Zap Wykonaj połączenie wychodzące i Rozpocznij kampanię wybierają rzeczywiste numery telefonów oraz rozpoczynają rozliczane połączenia. - Jeśli ThunderPhone poprosi Twoją organizację o potwierdzenie, że jej połączenia wychodzące są zgodne z TCPA i innymi przepisami dotyczącymi połączeń, administrator musi zapisać to potwierdzenie w panelu, zanim Zap będzie mógł rozpocząć połączenia. - Numer źródłowy musi być włączony dla połączeń wychodzących. Numery przeniesione od własnego operatora kwalifikują się po weryfikacji. Numery udostępnione przez ThunderPhone są początkowo przeznaczone wyłącznie do połączeń przychodzących, a dostęp do połączeń wychodzących dla nich możesz zamówić w panelu. Zobacz [Uzyskaj numer telefonu](/pl/guides/get-a-phone-number). - Wykonaj połączenie wychodzące wymaga **Klucza idempotencji**. Zmapuj stały identyfikator z wyzwalacza lub rekordu źródłowego, taki jak identyfikator zdarzenia ThunderPhone lub identyfikator rekordu CRM. Jeśli Zapier ponowi krok, ThunderPhone rozpozna klucz i zwróci oryginalne połączenie zamiast wykonać drugie. Unikaj znaczników czasu, wartości losowych lub samego identyfikatora Zapa. - Rozpocznij kampanię wymaga **Zgody na obciążenie**, która potwierdza, że Zap może rozpocząć rozliczane połączenia wychodzące na Twoim koncie. - Twoja organizacja odpowiada za posiadanie zgody na dzwonienie pod każdy numer oraz za przestrzeganie obowiązujących przepisów dotyczących połączeń. Zobacz [przepisy dotyczące połączeń wychodzących](/pl/guides/outbound-calling-laws). Klucz idempotencji jest unikalny w całej organizacji i może mieć maksymalnie 128 znaków. Ponowne użycie klucza z innym agentem, numerem lub zmiennymi kończy się konfliktem, dlatego jeśli dwa Zapy mogą dzwonić w sprawie tego samego rekordu, nadaj każdemu Zapowi własny stały prefiks przed identyfikatorem rekordu. [Wykonywanie połączeń wychodzących](/pl/guides/place-outbound-calls) opisuje interfejs API stojący za tą akcją. ## Przykładowe Zapy - **Zakończone połączenie do CRM.** Zapisuj aktywność dla każdego zakończonego połączenia wraz z jego statusem, przyczyną zakończenia i transkrypcją. - **Ocenione połączenie do dalszych działań.** Filtruj według wyniku połączenia lub oceny i kieruj połączenie do odpowiedniego procesu dalszych działań. - **Nowy lead do kampanii.** Dodaj leada do kampanii roboczej za pomocą opcji Dodaj kontakty do kampanii, a następnie uruchom Rozpocznij kampanię, gdy ktoś zatwierdzi listę. Transkrypcje, podsumowania i nagrania połączeń mogą zawierać dane osobowe lub informacje o stanie zdrowia. Wysyłaj je wyłącznie do aplikacji, których Twoja organizacja może używać do przetwarzania takich danych, na podstawie umowy BAA w przypadku informacji o stanie zdrowia, i zachowuj tylko potrzebne pola. ## Rozwiązywanie problemów **Krok kończy się błędem autoryzacji.** Połącz ponownie ThunderPhone w Zapier i ponownie zatwierdź dostęp. Połączenie przestaje działać, gdy osoba, która je utworzyła, cofnie je w ThunderPhone w sekcji **Organizacja → Klucze → Autoryzowane aplikacje**, gdy ta osoba opuści organizację lub gdy przez 30 dni nie nastąpi pomyślne odświeżenie tokenu. Zobacz [Połączenie przez OAuth](/pl/guides/oauth). **Włączenie lub wyłączenie Zapa nie działa albo działanie zostaje odrzucone.** Osoba, która utworzyła połączenie, musi mieć w organizacji rolę administratora lub właściciela. Połącz ponownie konto, które ma tę rolę. Zap wyzwalający, który jest już włączony, nadal otrzymuje zdarzenia połączeń po zmianie roli lub cofnięciu połączenia. Wyłącz go, aby je zatrzymać. **Chcesz odłączyć aplikację.** Wyłącz Zapy ThunderPhone przed cofnięciem połączenia, ponieważ wyłączenie Zapa usuwa jego punkt końcowy i wymaga działającego połączenia. Jeśli najpierw cofnąłeś połączenie, usuń pozostały punkt końcowy **Zapier: …** za pomocą `DELETE /v1/developer/webhook-endpoints/{id}` i klucza API administratora. Zobacz [Punkty końcowe webhooków](/pl/webhooks/endpoints). **Zap powinien używać innej organizacji.** Każde połączenie obejmuje jedną organizację. Najpierw wyłącz Zapa, aby jego punkt końcowy webhooka został usunięty z bieżącej organizacji. Następnie połącz nowe konto ThunderPhone w Zapier, wybierz inną organizację podczas zatwierdzania dostępu i wybierz to połączenie w każdym kroku ThunderPhone. Agenci, numery i kampanie różnią się między organizacjami, dlatego ponownie wybierz **Agenta**, **Numer źródłowy** i **Kampanię** w każdym kroku, w którym występują. Następnie ponownie włącz Zapa. **Wyzwalacz przestał działać.** Każdy Zap z wyzwalaczem ThunderPhone ma jeden punkt końcowy webhooka w Twojej organizacji o nazwie **Zapier: Zakończone połączenie** lub **Zapier: Ocenione połączenie**. Jest tworzony po włączeniu Zapa i usuwany po jego wyłączeniu. Pozostaw go bez zmian. Jeśli został zmodyfikowany lub usunięty w ThunderPhone, wyłącz Zapa i włącz go ponownie, aby utworzyć nowy. Za pomocą klucza API administratora [`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) wyświetla ostatnie próby dostarczenia. Chcesz, aby agent głosowy używał działań Zapier podczas połączenia zamiast po nim? Połącz punkt końcowy Zapier MCP w sekcji **Połączenia → MCP**. Zobacz [Serwery MCP](/pl/guides/mcp-servers). Aby wysyłać te same zdarzenia połączeń na własny serwer, zobacz [Punkty końcowe webhooków](/pl/webhooks/endpoints).