Połącz Rinkel z Twoim CRM, helpdeskiem, Slackiem lub własnym narzędziem. Dzięki API i webhookom Rinkel przekaże dane o rozmowach tam, gdzie ich potrzebujesz, i zautomatyzuje sporo ręcznej pracy.
Warto wiedzieć ❗
API i webhooki są dostępne w taryfach Professional i Expert (webhooki były wcześniej tylko w Expert, teraz są też w Professional). To praca techniczna: programista lub informatyk załatwi to szybko, samodzielnie też się da, ale zajmie trochę czasu.
Pełna dokumentacja techniczna znajduje się na developers.rinkel.com (po angielsku).
Co to jest klucz API i do czego służy?
Klucz API to unikalny kod, podobny do hasła, który daje Twojemu systemowi dostęp do danych konta Rinkel. Nie ma klucza, nie ma dostępu.
Klucz API tworzysz w MyRinkel (tutaj).
Uwaga❗
Traktuj klucz API jak hasło. Nie udostępniaj go publicznie i nie umieszczaj w kodzie, który wypychasz do publicznego repozytorium.
Pierwsze kroki z API Rinkel
API działa w oparciu o REST. Wszystkie endpointy, parametry i przykłady znajdziesz w naszej dokumentacji dla programistów.
Praca z webhookami
Webhook automatycznie wysyła wiadomość do Twojego systemu, gdy tylko coś wydarzy się w Rinkel. Na przykład: nowe połączenie przychodzące? Otwórz zgłoszenie. Koniec rozmowy? Zaktualizuj kartę klienta w CRM.
Konfiguracja webhooka
W MyRinkel otwórz ustawienia integracji i wybierz webhooki.
Wybierz webhook, który chcesz skonfigurować, i wpisz adres URL swojego endpointu (musi przyjmować żądania POST).
Jakich zdarzeń możesz używać?
Połączenie przychodzące — przychodzi rozmowa (jeszcze nieodebrana). Wysyła id, datetime, to i from.
Połączenie wychodzące — dzwonisz na zewnątrz (jeszcze nieodebrane). Te same pola co wyżej.
Początek rozmowy — rozmowa została odebrana. Wysyła id, datetime, answeredBy i ewentualny wybór z menu głosowego.
Koniec rozmowy — rozmowa się zakończyła. Wysyła id, datetime i cause (sześć możliwych powodów: nieodebrane, odebrane, zablokowane, poczta głosowa, callcenter, poza godzinami pracy).
Masz podpowiedzi AI? Możesz też użyć zdarzenia Call insights, aby wysłać podsumowanie, ton rozmowy i tematy do własnego systemu. Powiąż je z rozmową przez to samo call id.
Dokładne pola payloadu znajdziesz w naszej https://developers.rinkel.com/.
Bezpieczeństwo
Cały ruch webhooków odbywa się przez HTTPS, a payload jest w formacie JSON. Po swojej stronie akceptuj wyłącznie żądania z domeny Rinkel.
Twój webhook nie działa?
Sprawdź kolejno:
Czy adres URL endpointu jest poprawny i dostępny w internecie?
Czy endpoint przyjmuje żądania POST?
Czy Twoja aplikacja odsyła 200 OK po odebraniu?
Czy dopuszczasz żądania z domeny Rinkel?
Nadal się blokuje? Napisz do nas na czacie z treścią błędu, a pomożemy dalej.
Najczęściej zadawane pytania
W jakich taryfach mogę korzystać z API i webhooków?
Professional i Expert.
Czy mogę przesyłać podpowiedzi AI do CRM?
Tak, przez zdarzenie webhooka Call insights. Powiąż je z innymi zdarzeniami webhooków przez to samo call id, jeśli potrzebujesz również numerów telefonów.
Chcę widzieć nazwę dzwoniącego na żywo w CRM podczas połączenia przychodzącego. Czy to możliwe?
Tak. Użyj webhooka Połączenie przychodzące, aby wysłać dane do CRM zaraz po nadejściu połączenia.
Czy Rinkel działa z Zapier, Make lub Integrately?
Bezpośrednia integracja z Zapier została wycofana. Za pomocą webhooków samodzielnie połączysz Rinkel z każdą platformą, która przyjmuje webhooki. Zapier, Make i Integrately sprawdzają się tu bez problemu.