Połącz Zapier, n8n i Make za pomocą klucza API Safiny

Utwórz klucz API w aplikacji Safina i użyj go w Zapier, n8n, Make lub we własnym skrypcie: odczytuj połączenia i podsumowania, wyszukuj i twórz kontakty oraz uruchamiaj przepływ pracy po każdym połączeniu.

Grafika liniowa: klucz ze znakami kodu w łańcuchu bloków przepływu pracy: błyskawica jako wyzwalacz, koło zębate, karta kontaktu, słuchawka z zielonym znacznikiem i laptop z kodem. Integracja
David Schemm David Schemm
Zaktualizowano

WymaganieWarunek
Plan SafinaPro lub Business
Twoja rola w SafinieWłaściciel lub administrator zespołu

Klucz API pozwala narzędziu do automatyzacji korzystać z REST API Safiny w imieniu Twojego zespołu. Z kluczem Zapier, n8n, Make lub Twój własny skrypt może odczytywać połączenia i ich podsumowania, wyszukiwać i tworzyć kontakty oraz uruchamiać przepływ pracy po każdym połączeniu. Klucz działa tylko z API Safiny. Aplikacje AI, takie jak Claude czy ChatGPT, łączą się w inny sposób. Opisuje go poradnik Połącz Safinę ze swoim asystentem AI.

Utwórz klucz API

  1. W aplikacji Safina otwórz zakładkę Profil i stuknij Klucze API.

Zakładka Profil w aplikacji Safina. W sekcji Konto wyróżniona jest pozycja Klucze API.

  1. Stuknij + obok Twoje klucze API. Jeśli nie masz jeszcze klucza, stuknij Utwórz klucz API pod pustą listą.

Strona Klucze API z listą Twoje klucze API: klucz Zapier i klucz n8n. Przycisk + obok tytułu listy jest wyróżniony.

  1. U góry strony Nowy klucz API stuknij tytuł i wpisz nazwę, z której wynika, gdzie używasz klucza, na przykład „Zapier”.

Strona Nowy klucz API z nazwą Zapier jako tytułem, który jest wyróżniony. Poniżej wybór Co może robić ten klucz? z zaznaczonym Odczyt i zapis.

  1. W sekcji Co może robić ten klucz? wybierz:

    • Tylko odczyt: może odczytywać połączenia, kontakty i asystentów.
    • Odczyt i zapis: może też tworzyć i zmieniać kontakty oraz webhooki.

    Nie możesz tego później zmienić. Aby uzyskać inny dostęp, utwórz nowy klucz.

  2. W sekcji Wygasa po wybierz, kiedy klucz wygaśnie: po 30 dniach, 90 dniach (wybrane domyślnie) lub 1 roku. Możesz też wybrać Bez wygaśnięcia.

  3. Stuknij Utwórz klucz API.

Strona Nowy klucz API z ustawieniem Wygasa po 90 dniach. Przycisk Utwórz klucz API na dole jest wyróżniony.

  1. Strona pokazuje teraz Twój nowy klucz API. Stuknij Kopiuj klucz i wklej klucz do swojej automatyzacji. Zaczyna się od safina_api_. Safina pokazuje pełny klucz tylko raz.

Strona Twój nowy klucz API z kluczem demonstracyjnym. Przycisk Kopiuj klucz jest wyróżniony.

  1. Stuknij Gotowe, aby wrócić do listy.

Każde żądanie wysyła klucz w nagłówku Authorization: Bearer <klucz>. Lista Twoje klucze API pokazuje, kiedy każdy klucz został utworzony, kiedy wygasa i kiedy był ostatnio użyty. Aby od razu wyłączyć klucz, stuknij ikonę kosza obok niego i potwierdź przyciskiem Usuń. Automatyzacje, które go używają, przestaną wtedy działać.

Co może zrobić klucz API

ObszarTylko odczytOdczyt i zapis
AsystenciLista asystentów zespołuTo samo
PołączeniaLista połączeń (najnowsze najpierw, filtry według numeru telefonu, daty i czasu trwania) oraz pojedyncze połączenie z podsumowaniem, dzwoniącym i czasem trwaniaTo samo
KontaktyWyszukiwanie kontaktów, znalezienie kontaktu po numerze telefonuDodatkowo tworzenie i aktualizacja kontaktów
Webhooki–Subskrypcja zdarzenia call.ended i usunięcie subskrypcji

Wszystkie ścieżki, pola i odpowiedzi znajdziesz w dokumentacji API (po angielsku).

Zapier

  • Aplikacja Safina AI dla Zapier: aplikacja ma wyzwalacz New Call, akcje Create Contact i Update Contact oraz wyszukiwania Find Call, Find Contact, Find Contact by Text i Find or Create Contact. Łączysz ją za pomocą klucza API. Aplikacji nie ma jeszcze w katalogu aplikacji Zapier. Aby uzyskać dostęp, napisz na info@safina.ai.
  • Webhooks by Zapier: Catch Hook odbiera dane po każdym połączeniu, bez klucza API. Kroki opisuje strona Safina + Zapier.

n8n

  • Węzeł Safina dla n8n: pakiet @sk-thinking/n8n-nodes-safina dodaje dwa węzły. Safina odczytuje asystentów i połączenia oraz tworzy, wyszukuje i aktualizuje kontakty. Działa też jako narzędzie węzła AI Agent w n8n. Safina Trigger uruchamia przepływ pracy po zakończeniu połączenia i sprawdza podpis każdego zdarzenia. Klucz dodajesz jako dane uwierzytelniające typu Safina API. Węzła nie ma jeszcze na liście węzłów społeczności n8n. Aby uzyskać dostęp, napisz na info@safina.ai. Kod źródłowy jest publiczny na GitHubie.
  • Węzeł HTTP Request: wywołuje dowolną ścieżkę API z nagłówkiem Authorization: Bearer <klucz>.
  • Węzeł Webhook: odbiera dane po każdym połączeniu. Kroki opisuje strona Safina + n8n.

Make

Make nie ma jeszcze aplikacji Safina. Do wywołań API użyj modułu HTTP Make a request z nagłówkiem Authorization: Bearer <klucz>. Aby uruchamiać scenariusz po każdym połączeniu, użyj modułu Custom webhook, jak opisuje strona Safina + Make.

Własny skrypt

Adres API to https://api.backend.safina.ai. Ten przykład odczytuje pięć najnowszych połączeń:

curl "https://api.backend.safina.ai/calls/me?limit=5" \
  -H "Authorization: Bearer safina_api_..."

Wartości zapytania są w formacie JSON. Tekst wymaga cudzysłowów, liczba nie:

curl -G "https://api.backend.safina.ai/contacts/me" \
  --data-urlencode 'search="Miller"' \
  -H "Authorization: Bearer safina_api_..."

Webhook po każdym połączeniu

Z kluczem do odczytu i zapisu wywołanie POST /webhooks z polami name i url subskrybuje zdarzenie call.ended. Safina wysyła wtedy jedno zdarzenie na połączenie, gdy podsumowanie jest gotowe.

  • Ustaw "create_signing_secret": true, aby zdarzenia były podpisywane. Odpowiedź zawiera sekret tylko raz. Jak sprawdzić nagłówek X-Safina-Signature, wyjaśnia artykuł Jak sprawdzić, czy webhook naprawdę pochodzi od Safiny.
  • Safina próbuje dostarczyć każde zdarzenie do trzech razy. Powtórzone dostarczenie ma to samo event_id, więc odrzucaj zdarzenia, które już przetworzyłeś.
  • Zespół może mieć do 20 webhooków. Subskrypcję, której już nie potrzebujesz, usuń przez DELETE /webhooks/{id}.
  • Jeśli adres przy trzech kolejnych połączeniach odpowiada 410 Gone na każdą próbę, Safina wyłącza webhook i wysyła jeden e-mail. Możesz go ponownie włączyć w aplikacji w Safina AI > Zapisywanie połączeń > Webhooki.

Gdy żądanie się nie powiedzie

OdpowiedźZnaczenie
401Klucz jest błędny, usunięty lub wygasł: utwórz nowy klucz i zaktualizuj automatyzację. Odpowiedź 401 pojawia się też, gdy osoba, która utworzyła klucz, nie jest już właścicielem ani administratorem zespołu albo zespół nie ma aktywnego planu.
403 api_keys_not_enabledTwoje konto nie ma jeszcze dostępu do kluczy API.
403 plan_requiredZespół potrzebuje planu Pro lub wyższego.
403 z kluczem tylko do odczytuŻądanie zmienia dane. Użyj klucza do odczytu i zapisu.
409Numer telefonu należy już do kontaktu albo zespół ma już 20 webhooków.

Najczęściej zadawane pytania

Czy zamiast klucza API mogę użyć kodu połączenia dla AI?

Nie. Kod połączenia działa tylko z asystentami AI. Klucz API działa tylko z REST API.

Czy klucz działa we wszystkich moich zespołach?

Nie. Klucz należy do zespołu, który był aktywny, gdy go tworzyłeś. Dla innego zespołu przełącz zespół w aplikacji i utwórz tam nowy klucz.

Co się dzieje, gdy klucz wygaśnie?

Żądania z tym kluczem dostają odpowiedź 401. Utwórz nowy klucz i zastąp nim stary w automatyzacji.

Twój zespół Safina

9:41

Safina obsłużyła w tym tygodniu 51 połączeń

46

Zaufane

4

Podejrzane

1

Niebezpieczne

Ostatnie 7 dni
Filter
EM
Emma Martin 67s 15:30

Chce omówić ofertę na nową kampanię i ma pytania dotyczące harmonogramu.

KN
Katarzyna Nowak 54s 14:45

Pyta o status zamówienia i termin dostawy.

TW
Tomasz Wiśniewski 34s 13:10

Umówienie spotkania w sprawie projektu na przyszły tydzień.

Nieznany 44s 11:30

Obietnica wygranej — prawdopodobnie spam.

MW
Magdalena Wójcik 10s 09:15

Reklamacja ostatniego zamówienia, prosi o oddzwonienie.

PZ
Piotr Zieliński 95s 13 gru

Chce omówić potencjalną współpracę.

AR
Anna Rutkowska 85s 13 gru

Jest Twoją koleżanką i chce porozmawiać o projekcie.

JK
Jakub Krawczyk 42s 12 gru

Pyta o dostępne terminy na przyszły tydzień.

LB
Lena Bąk 68s 12 gru

Ma pytania dotyczące faktury i prosi o wyjaśnienie.

Połączenia
Safina
Kontakty
Profil
9:41
Połączenie od Emmy Martin
12 gru
11:30
67s
+48223456789

Chce omówić ofertę na nową kampanię i ma pytania dotyczące harmonogramu.

Kluczowe punkty

  • Oddzwonić do Emmy Martin
  • Wyjaśnić pytania o harmonogram i warunki cenowe
Oddzwoń
Edytuj kontakt

Wgląd AI

Nastrój rozmówcy Bardzo dobry

Rozmówca był współpracujący i przekazał potrzebne informacje.

Pilność Niski

Rozmówca może poczekać na odpowiedź.

Audio i transkrypcja

0:16

Dzień dobry, tu Safina AI, cyfrowy asystent Piotra. W czym mogę pomóc?

Dzień dobry Safina, tu Emma Martin. Chciałam porozmawiać o ofercie i harmonogramie.

Dziękuję, Emmo. Czy przy wdrożeniu rozważają Państwo głównie pakiet Standard czy Pro?

Dokładnie. Potrzebujemy pakietu Pro i chcielibyśmy wystartować w przyszłym miesiącu, jeśli onboarding będzie możliwy w pierwszym tygodniu.

Pożegnaj się ze staromodną pocztą głosową.

Wypróbuj Safina za darmo i zacznij inteligentnie zarządzać swoimi połączeniami.

Safina Support Bot
Safina Support Bot

Cześć! 👋 Jestem asystentem wsparcia Safina. Zapytaj mnie o konfigurację, przekierowanie połączeń, plany lub Twoje konto. Uwaga: Twoje wiadomości są przetwarzane zgodnie z naszą polityką prywatności.

Twoje wiadomości są przetwarzane zgodnie z naszą polityką prywatności