Webhooks

Webhooks umożliwiają Trimoji wysyłanie powiadomień w czasie rzeczywistym do Twojej aplikacji, gdy tylko wystąpi zdarzenie (koniec testu, utworzenie kampanii itp.). Jest to najskuteczniejsza metoda synchronizacji danych bez niepotrzebnego obciążania API.

Działanie: Gdy wystąpi zdarzenie, Trimoji wykonuje wywołanie HTTP POST na skonfigurowany przez Ciebie adres URL, dołączając odpowiednie dane.

Konfiguracja Webhooka

Zarządzanie webhookami odbywa się w panelu klienta: Moje Konto Trimoji.

Kroki konfiguracji:

• Wpisz adres URL docelowy swojego serwera (np.: https://twoja-strona.com/api/webhook).
• Wybierz zdarzenia, których chcesz nasłuchiwać.
• Potwierdź dodanie.
• Ważne: Po utworzeniu webhooka, Trimoji automatycznie wygeneruje unikalny Secret (Token). Musisz odebrać ten token, aby zabezpieczyć swój endpoint.

Bezpieczeństwo i Uwierzytelnianie

Przy każdym wysyłaniu danych Trimoji używa wygenerowanego secretu do podpisania i uwierzytelnienia żądania. Musisz zweryfikować tę informację po stronie serwera, aby upewnić się, że wywołanie pochodzi od naszych usług.

Token jest przesyłany na dwa sposoby w każdym wywołaniu:

• W nagłówku HTTP: Authorization: TWÓJ_WYGENEROWANY_TOKEN
• W treści JSON: { "_token": "TWÓJ_WYGENEROWANY_TOKEN", ... }

Struktura ładunku (Payload)

Wszystkie żądania wysyłane przez Trimoji mają standardowy format JSON, który umożliwia szybką identyfikację akcji.

{
  "_token": "token_wygenerowany_przez_trimoji",
  "_timestamp": "2026-02-11T16:00:00.000Z",
  "_event": "QUIZZ_COMPLETED",

  // Dane dynamiczne w zależności od zdarzenia
  "id": 12345,
  "data": { ... }
}

Lista dostępnych zdarzeń

Możesz subskrybować różne typy akcji w zależności od potrzeb automatyzacji:

Specyfikacje Techniczne

• User-Agent: Żądania są wysyłane z identyfikatorem trimoji/1.0.0.
• Oczekiwana odpowiedź: Twój serwer powinien zwrócić kod 200 OK. W przypadku błędu po Twojej stronie, Trimoji zarejestruje niepowodzenie w logach Twojego konta.
• Format: Treść żądania jest zawsze w formacie JSON.