Webhooks

Webhooks ermöglichen es Trimoji, Echtzeitbenachrichtigungen an Ihre Anwendung zu senden, sobald ein Ereignis eintritt (z. B. Abschluss eines Tests, Erstellung einer Kampagne usw.). Dies ist die effizienteste Methode, um Ihre Daten zu synchronisieren, ohne die API unnötig zu belasten.

Funktionsweise: Wenn ein Ereignis auftritt, führt Trimoji einen HTTP POST-Aufruf an eine von Ihnen konfigurierte URL durch und übermittelt die entsprechenden Daten.

Webhook-Konfiguration

Die Verwaltung von Webhooks erfolgt in Ihrem Kundenbereich: Trimoji Mein Konto.

Konfigurationsschritte:

• Geben Sie die Ziel-URL Ihres Servers ein (z. B. https://ihre-seite.com/api/webhook).
• Wählen Sie die Ereignisse aus, die Sie verfolgen möchten.
• Bestätigen Sie das Hinzufügen.
• Wichtig: Sobald der Webhook erstellt ist, generiert Trimoji automatisch ein eindeutiges Secret (Token). Sie müssen dieses Token abrufen, um Ihren Endpunkt zu sichern.

Sicherheit und Authentifizierung

Bei jeder Übertragung verwendet Trimoji das generierte Secret, um die Anfrage zu signieren und zu authentifizieren. Sie müssen diese Information serverseitig überprüfen, um sicherzustellen, dass der Aufruf von unseren Diensten stammt.

Das Token wird bei jedem Aufruf auf zwei Arten übermittelt:

• Im HTTP-Header: Authorization: IHR_GENERIERTER_TOKEN
• Im JSON-Body: { "_token": "IHR_GENERIERTER_TOKEN", ... }

Struktur der Nutzlast (Payload)

Alle von Trimoji gesendeten Anfragen folgen einem standardisierten JSON-Format, das eine schnelle Identifizierung der Aktion ermöglicht.

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

  // Dynamische Daten abhängig vom Ereignis
  "id": 12345,
  "data": { ... }
}

Verfügbare Ereignisse

Sie können sich je nach Ihren Automatisierungsbedürfnissen für verschiedene Arten von Aktionen anmelden:

Technische Spezifikationen

• User-Agent: Anfragen werden mit der Kennung trimoji/1.0.0 gesendet.
• Erwartete Antwort: Ihr Server sollte einen 200 OK-Code zurückgeben. Bei Fehlern auf Ihrer Seite protokolliert Trimoji den Fehlschlag in den Protokollen Ihres Kontos.
• Format: Der Anfragetext ist immer in JSON.