| 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ść.
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”
-
Kliknij „Synchronizuj CRM”
-
Dodaj nowy webhook
-
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 |
| Auth Type | Rodzaj uwierzytelniania | API_KEY, Bearer |
| Token | Token bezpieczeństwa do uwierzytelniania | 550e8400-e29b-41d4-a716-446655440000, eyJ0eXAiOi... |
| Method | Metoda HTTP dla wywołania webhooka | POST |
| URL | Docelowy URL Twojego endpointu webhooka | https://twoja-domena.pl/safina-webhook |
| Api Key Location | Gdzie klucz API jest umieszczany w żądaniu | Header, Body |
| Body Attribute Name | Nazwa atrybutu w treści żądania | token |
| Header Name | 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.
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. Możesz skonfigurować wiele webhooków. Każdy może otrzymywać call.ended, na przykład jeden dla CRM, a drugi dla innego systemu.