Powiadomienia webhook
Webhook powiadomień wysyła zdarzenia powiadomień AurionAI do innego systemu, na przykład narzędzia do czatu. AurionAI przesyła każde zdarzenie jako treść JSON na adres, który podasz.
Dostępność: Profile Helpdesk i AI Voice + Helpdesk. Tylko administratorzy.
Wymagania wstępne
- Masz rolę Właściciel lub Administrator. Inni użytkownicy widzą Brak dostępu.
- Twoja organizacja korzysta z profilu Helpdesk lub AI Voice + Helpdesk.
- Publiczny adres HTTPS akceptujący żądania POST z treścią JSON.
Otwieranie webhooków powiadomień
- Na pasku bocznym wybierz Konfiguracja.
- Otwórz kategorię System.
- Wybierz Webhooki powiadomień.
Dodawanie webhooka
- Wybierz Dodaj webhook.
- W polu Nazwa wpisz nazwę.
- W polu URL wpisz adres. Musi zaczynać się od
https://. - Opcjonalnie: w polu Sekret (opcjonalnie) wpisz sekret. AurionAI będzie wtedy podpisywać każde żądanie. Pozostaw puste, aby wysyłać niepodpisane żądania.
- Wybierz zdarzenia:
- Aby otrzymywać każde zdarzenie powiadomienia, włącz Subskrybuj wszystkie zdarzenia.
- W przeciwnym razie zaznacz zdarzenia na liście.
- Wybierz Utwórz.
Pojawi się komunikat Webhook utworzony. Nowy webhook ma status Włączony.
Testowanie webhooka
- Na webhooku wybierz Testuj.
- W oknie dialogowym Wysłać testowy ładunek? wybierz Wyślij test.
AurionAI natychmiast wysyła zdarzenie webhook.test. Pojawi się komunikat Testowy ładunek został wysłany pomyślnie lub Nie udało się wysłać testowego ładunku.
Weryfikacja podpisu
Gdy webhook ma sekret, każde żądanie zawiera dwa dodatkowe nagłówki:
X-Webhook-Timestamp: czas żądania w sekundach od 1 stycznia 1970 (UTC).X-Webhook-Signature:sha256=poprzedzające podpis.
Aby zweryfikować żądanie, oblicz HMAC-SHA256 ze znacznika czasu, kropki i surowej treści, używając swojego sekretu. Zapisz wynik w formacie szesnastkowym. Musi być równy części po sha256=.
Edytowanie, wyłączanie lub usuwanie webhooka
- Aby zmienić webhooka, wybierz Edytuj webhook, zmień pola i wybierz Zapisz. Pozostaw sekret pusty, aby go zachować, lub wybierz Usuń sekret, aby wysyłać niepodpisane żądania.
- Aby tymczasowo wstrzymać dostarczanie, otwórz Edytuj webhook i przestaw przełącznik na Wyłączony. Następnie zapisz.
- Aby usunąć webhooka, wybierz Usuń. W oknie dialogowym Usunąć ten webhook? wybierz Usuń webhook. Spowoduje to również usunięcie historii dostarczania i sekretu. Tej operacji nie można cofnąć.
- Aby wyświetlić poprzednie dostarczenia, wybierz Historia na webhooku. Każdy wiersz pokazuje Dostarczono, Niepowodzenie lub Pominięto wraz z przyczyną niepowodzenia.
Wynik
AurionAI wysyła każde wybrane zdarzenie w momencie jego wystąpienia. Jeśli Twój adres nie odpowiada lub odpowiada ze statusem 5xx, AurionAI natychmiast ponawia próbę — łącznie do trzech prób. Odpowiedź 4xx jest ostateczna: AurionAI nie ponawia próby.
Jeśli coś pójdzie nie tak
- Adres URL musi zaczynać się od https://. Rozpocznij adres od
https://. - Punkty końcowe metadanych chmury są zawsze blokowane. lub komunikat informujący, że adres IP należy do zablokowanego zakresu. AurionAI nie wysyła webhooków na prywatne ani wewnętrzne adresy. Użyj publicznego adresu.
- Komunikat informuje o niepowodzeniu rozpoznawania DNS. Nazwa hosta nie istnieje lub nie ma rekordu DNS. Sprawdź adres.
- Wybierz co najmniej jedno zdarzenie lub zaznacz „Subskrybuj wszystkie zdarzenia”. Wybierz co najmniej jedno zdarzenie lub włącz Subskrybuj wszystkie zdarzenia.
- Nie udało się wysłać testowego ładunku Przeczytaj przyczynę, status HTTP i liczbę prób w komunikacie. Sprawdź, czy Twój odbiornik jest online i odpowiada ze statusem 2xx.
- Ten webhook jest wyłączony Najpierw włącz webhooka. Jeśli wybierzesz Wyślij mimo to, AurionAI zarejestruje jedynie pominięta próbę.
- Dostarczenie pokazuje Pominięto. Webhook był wyłączony lub adres nie przeszedł kontroli bezpieczeństwa przed wysłaniem. Przeczytaj przyczynę w historii.
- Nie można załadować webhooków lub Nie można załadować zdarzeń powiadomień Wybierz Spróbuj ponownie.
Powiązane artykuły
Nadal potrzebujesz pomocy? Wyślij zgłoszenie lub .