Webhooki

Webhooki to mechanizm, za pomocą którego Logora powiadamia Twoje systemy o zdarzeniach w czasie rzeczywistym. Tam, gdzie API oparte na odpytywaniu (polling) wymaga, byś co minutę pytał „czy jest coś nowego?”, webhooki odwracają przepływ : Logora wysyła zdarzenie do Twojego punktu końcowego w chwili, gdy ono następuje.

Zdarzenia wysyłane domyślnie przez Logora

• comment.created, comment.moderated, comment.deleted
• user.signed_up, user.badge_unlocked, user.tier_changed
• debate.opened, debate.closed, consultation.completed
• moderation.flagged, moderation.appealed

Każdy ładunek (payload) to podpisana koperta JSON zawierająca typ zdarzenia, znacznik czasu oraz zasób, którego dotyczy. Weryfikacja podpisu wykorzystuje HMAC-SHA256 ze współdzielonym sekretem.

Typowe zastosowania

• Przesyłaj rejestracje czytelników do Twojego CRM (Salesforce, HubSpot) w chwili, gdy się pojawiają.
• Zasilaj swoje CDP (Segment, mParticle, Tealium) zdarzeniami zaangażowania na potrzeby modelowania retencji.
• Uruchamiaj alerty dla redakcji : gdy sztandarowa debata osiągnie 10 tys. uczestników lub pojawi się kontrowersyjne odwołanie od decyzji moderacyjnej, powiadom redaktora na Slacku.
• Aktualizuj swój system subskrypcji : gdy czytelnik odblokuje poziom najlepszego współtwórcy, oznacz go w swoim ESP, aby wysłać e-mail z podziękowaniem.

Niezawodność

Logora ponawia nieudane dostarczenia z wykładniczym wycofywaniem (exponential backoff) przez 24 godziny. Zdarzenia, których nie udało się dostarczyć na stałe, trafiają do kolejki odtwarzania (replay queue), którą możesz odpytać przez publiczne API. Opóźnienie webhooków na poziomie P95 wynosi poniżej 500 ms (zobacz status.logora.fr, aby poznać aktualne liczby).

Zobacz OAuth 2.0 / OIDC oraz Single Sign-On, aby poznać szerszy kontekst integracji.