| Wymaganie | Warunek |
|---|---|
| Plan Safina | Pro lub wyższy |
Wprowadzenie
W dzisiejszym cyfrowym świecie biznesu bezproblemowa integracja różnych systemów ma kluczowe znaczenie dla efektywnego projektowania przepływów pracy. Webhooki stały się niezbędnym narzędziem do wymiany danych w czasie rzeczywistym między aplikacjami. W tym artykule pokażę Ci, jak tworzyć i wykorzystywać webhooki dla Safina AI, aby zautomatyzować i zoptymalizować Twoją komunikację.
Safina AI, innowacyjna usługa AI poczty głosowej z Niemiec, oferuje firmom inteligentne rozwiązanie do zarządzania połączeniami. Dzięki integracji webhooków możesz połączyć możliwości Safina z istniejącymi systemami biznesowymi, tworząc jeszcze większą wartość.
Korzystasz z HubSpot? Safina może zapisywać każde odebrane połączenie w HubSpot bez webhooka: Zapisuj każde połączenie Safiny w HubSpot.
Podstawy webhooków
Czym są webhooki?
Webhooki to automatyczne wiadomości wysyłane z jednej aplikacji do drugiej, gdy wystąpią określone zdarzenia.
Pasujący przewodnik: Czym jest webhook i jak działa? Nasz przewodnik wyjaśnia Ci w prosty sposób z przykładami, jak za pomocą webhooków połączyć aplikacje biznesowe i zautomatyzować procesy.
W przeciwieństwie do tradycyjnych API, gdzie Twoja aplikacja musi aktywnie odpytywać dane, webhooki działają na zasadzie „push”: gdy tylko wystąpi istotne zdarzenie, dane są automatycznie wysyłane do Twojego zdefiniowanego endpointu.
Różnica między webhookami a API
Podczas gdy API działają na modelu żądanie-odpowiedź i wymagają regularnych odpytywań (polling), webhooki są sterowane zdarzeniami. Czyni to je szczególnie efektywnymi dla powiadomień w czasie rzeczywistym i redukuje niepotrzebny ruch danych.
Typowe przypadki użycia
- Powiadomienia w czasie rzeczywistym: natychmiastowe informacje o nowych połączeniach
- Integracja danych: automatyczny transfer danych o połączeniach do systemów CRM
- Zautomatyzowane przepływy pracy: uruchamianie akcji na podstawie treści lub wyniku połączenia
Tworzenie webhooka z istniejącym CRM
Prawie wszystkie wiodące platformy CRM obsługują webhooki. Automatycznie udostępniają bezpieczny endpoint, który może odbierać dane z Safina. Wystarczy skopiować odpowiedni URL i informacje o uwierzytelnianiu i wpisać je w Safina.
Ponieważ tworzenie webhooków w każdym z tych narzędzi wygląda nieco inaczej, poniżej zebraliśmy linki do instrukcji kilku liderów rynku.
Instrukcje popularnych narzędzi CRM
| Nazwa narzędzia | Tworzenie webhooka |
|---|---|
| Salesforce | Erstellen eines Webhook-Datenaktionsziels |
| Hubspot | Webhooks |
| Zapier | How to get started with Webhooks by Zapier |
| Make | Webhooks |
| Zoho | Creating Webhooks |
| Microsoft Dynamics 365 | Use webhooks to create external handlers for server events |
| Freshsales CRM | What are webhooks? How to configure webhooks for Workflows? |
| Pipedrive | Webhooks |
| Monday | Webhooks |
| Insightly | Webhooks - How to Setup |
| Zendesk | Webhooks |
| SAP CRM | Manage Webhooks |
Dodawanie webhooka w aplikacji Safina
W planie Pro lub wyższym webhooki konfigurujesz w aplikacji Safina tak:
- Zaloguj się do aplikacji Safina
- Przejdź do zakładki „Safina AI”
- W sekcji „Integracja i automatyzacja” naciśnij „Zapisywanie połączeń”

- Naciśnij „+ Webhook” i wypełnij formularz

- Nie zapomnij następnie zapisać.

Pola konfiguracyjne webhooka w aplikacji Safina AI
Podczas konfiguracji webhooka w Safina AI musisz podać następujące informacje:
| Pole | Opis | Przykład |
|---|---|---|
| Nazwa (tylko dla ciebie) | Wewnętrzna nazwa do identyfikacji webhooka | Hubspot Hook |
| Uwierzytelnianie | Rodzaj uwierzytelniania | Klucz API, Bearer, Żadne |
| Token | Token bezpieczeństwa do uwierzytelniania | 550e8400-e29b-41d4-a716-446655440000, eyJ0eXAiOi... |
| Metoda | Metoda HTTP dla wywołania webhooka | POST |
| URL | Docelowy URL Twojego endpointu webhooka | https://twoja-domena.pl/safina-webhook |
| Lokalizacja klucza API | Gdzie klucz API jest umieszczany w żądaniu | Nagłówek, Treść |
| Nazwa atrybutu treści | Nazwa atrybutu w treści żądania | token |
| Nazwa nagłówka | Nazwa atrybutu w nagłówku żądania | x-api-key |
Dodatkowo dostępne są przyciski do aktywacji i usunięcia webhooka.
Przykłady zastosowania
Integracja CRM
Połącz Safina AI ze swoim systemem CRM, aby automatycznie zapisywać informacje o połączeniach jako aktywności lub notatki. Pozwala to na kompletny przegląd komunikacji z klientami.
Automatyczne tworzenie zadań
Na podstawie treści połączenia możesz automatycznie tworzyć zadania w swoim narzędziu do zarządzania projektami. Na przykład, gdy klient zgłosi problem techniczny, automatycznie tworzony jest ticket wsparcia.
Business Intelligence
Zbieraj dane o połączeniach na potrzeby analiz i raportów. Śledź liczbę połączeń, najczęstsze sprawy i nastroje klientów, aby optymalizować swoje procesy biznesowe.
Systemy powiadomień
Skonfiguruj powiadomienia o ważnych lub pilnych połączeniach. Możesz wysyłać e-maile, SMS-y lub powiadomienia push do odpowiedzialnych pracowników.
Jakie dane wysyła Safina?
Dokładna treść zależy od zdarzenia. Przy call.ended zazwyczaj dostajesz:
- Nazwę zdarzenia, ID i znacznik czasu
- Połączenie: ID, czas, URL audio, tracking i podsumowanie
- Agenta: ID i nazwę
- Kontakt: imię, firmę i numer telefonu, jeśli są
Przykład call.ended
{
"event": "call.ended",
"event_id": "evt_abc123",
"occurred_at": "2026-01-28T14:32:00.000Z",
"data": {
"call": {
"id": "call_abc123",
"timestamp": "2026-01-28T14:29:38.000Z",
"summary": {},
"call_tracking": {
"from_number": "+4917612345678",
"to_number": "+498962828095"
}
},
"agent": {
"id": "agent_123",
"name": "Safina"
},
"contact": {
"name": "Stefan Bauer",
"company": "Bauer Elektrotechnik GmbH",
"phone_number": "+4917612345678"
}
}
}
Obsługiwane zdarzenia
| Zdarzenie | Opis |
|---|---|
call.ended | Rozmowa się zakończyła, z podsumowaniem |
Safina obecnie wysyła tylko call.ended.
Uwierzytelnianie i szczegóły techniczne
Safina obsługuje Bearer Token, API Key (nagłówek lub body) oraz brak uwierzytelniania. Możesz też dodać własne nagłówki HTTP.
- Metody HTTP: POST (domyślnie), GET, PUT, PATCH, DELETE
- POST, PUT, PATCH i DELETE wysyłają payload w formacie JSON.
- GET nie zawiera treści żądania ani danych zdarzenia w parametrach zapytania.
- Safina próbuje dostarczyć dane od jednego do trzech razy, zależnie od skonfigurowanej liczby prób.
Podpis
Podpis jest opcjonalny. Podczas tworzenia webhooka włącz Podpisuj wysyłki. Safina podpisuje wtedy każde żądanie tego webhooka, a aplikacja jeden raz pokazuje jego sekret podpisu (whsec_…). Skopiuj go i zapisz w swoim odbiorniku. Każde podpisane żądanie ma nagłówek X-Safina-Signature: t=<czas>,v1=<HMAC-SHA256 z "<czas>.<surowe body>">. Sprawdź go sekretem i odrzucaj żądania starsze niż 5 minut. Każda próba dostarczenia ma nowy czas i nowy podpis.
Webhook bez sekretu wysyła niepodpisane żądania, tak jak wcześniej. Aby podpisać go później, dotknij w aplikacji Utwórz sekret przy webhooku. Utwórz nowy sekret zastępuje sekret; stary pozostaje ważny przez 24 godziny. Przykłady kodu dla Node.js i Pythona znajdziesz w dokumentacji API (po angielsku).
Często zadawane pytania
Co się stanie, gdy mój serwer jest niedostępny?
Safina próbuje dostarczyć dane od jednego do trzech razy. Jeśli wszystkie próby się nie powiodą, sprawdź adres URL i dane uwierzytelniające oraz przejrzyj logi odbiorcy. Safina próbuje też wysłać e-mail o błędzie.
Czy mogę użyć więcej niż jednego webhooka?
Tak. Zespół może mieć do 20 webhooków. Każdy może otrzymywać call.ended, na przykład jeden dla CRM, a drugi dla innego systemu.
Co się dzieje, gdy adres odpowiada 410 Gone?
Zapier, Make i podobne narzędzia odpowiadają 410 Gone, gdy usunęły hook. Jeśli adres przy trzech kolejnych połączeniach odpowiada 410 na każdą próbę, Safina wyłącza webhook i wysyła jeden e-mail. Włącz go ponownie przełącznikiem w aplikacji albo go usuń.
Czy mogę utworzyć webhook przez API?
Tak. Z kluczem API wywołanie POST /webhooks subskrybuje zdarzenie call.ended. Zobacz Połącz Zapier, n8n i Make za pomocą klucza API Safiny.