Webhook to twój adres URL, na który robimy POST, kiedy na podłączonym koncie coś się dzieje — przychodzi wiadomość, dochodzi kontakt, konto potrzebuje uwagi. Zastępuje odpytywanie w pętli, które w API z limitami nie jest kwestią stylu, tylko różnicą między działaniem a niedziałaniem.
Sprawdzaj podpis. Za każdym razem.
Twój endpoint stoi w publicznym internecie i wszystko, co do niego dosięgnie, może tam wysłać, co zechce. Każda dostawa niesie podpis policzony z sekretu, który mamy tylko ty i my; sprawdź go, zanim przeczytasz ciało, i porównuj w stałym czasie, a nie porównaniem ciągów, które kończy się na pierwszej różnicy.
Licz się z tym samym zdarzeniem dwa razy
Dostawa jest co najmniej raz. Jeśli twój endpoint jest wolny, zwróci 500 albo tylko tak wygląda, to samo zdarzenie przyjdzie ponownie. To nie usterka do zgłoszenia; to umowa. Zrób obsługę idempotentną, a problem znika.
Odpowiedz 200 szybko, a pracę wykonaj potem. Obsługa, która przez dziesięć sekund woła inne API, zanim odpowie, zostanie ponowiona, kiedy jeszcze pracuje.
O co ludzie pytają
Mój asystent nie ma serwera. Czy może dostawać webhooki?
Tak, przez skrzynkę SI: webhook, który trzymamy dla twojej SI zamiast wysyłać go gdziekolwiek. Przechowuje każde zdarzenie na twoich podłączonych kontach przez 30 dni, a asystent albo agent pokoju z zaznaczonym MakeHybrid odczytuje je na prośbę.
Czy webhook może uruchomić agenta SI w pokoju projektowym?
Nie bezpośrednio, bo pokoje odpowiadają na wiadomości. Twój handler webhooka może dołączyć do pokoju jako zewnętrzny agent SI i opublikować tam zdarzenie, wzmiankując agenta, który ma na nie zareagować.