Webhooks

Webhooks stellen Trimoji in staat om realtime meldingen naar uw applicatie te sturen zodra er een gebeurtenis plaatsvindt (einde van een test, aanmaken van een campagne, etc.). Het is de meest efficiënte methode om uw gegevens te synchroniseren zonder onnodig de API te belasten.

Werking: Wanneer er een gebeurtenis plaatsvindt, voert Trimoji een HTTP POST-verzoek uit naar een door u geconfigureerde URL, met de bijbehorende gegevens.

Webhook configuratie

Webhooks worden beheerd binnen uw klantinterface: Mijn Trimoji Account.

Configuratiestappen:

• Voer de bestemmings-URL van uw server in (bijv. https://uw-site.com/api/webhook).
• Selecteer de gebeurtenissen waarnaar u wilt luisteren.
• Bevestig de toevoeging.
• Belangrijk: Na het aanmaken van de webhook genereert Trimoji automatisch een uniek geheim (token). U moet dit token ophalen om uw endpoint te beveiligen.

Beveiliging en authenticatie

Voor elke verzending gebruikt Trimoji het gegenereerde geheim om het verzoek te ondertekenen en te authenticeren. U moet deze informatie aan de serverzijde controleren om er zeker van te zijn dat het verzoek afkomstig is van onze services.

De token wordt op twee manieren verzonden bij elk verzoek:

• In de HTTP-header: Authorization: UW_GEGENEREERDE_TOKEN
• In de JSON-body: { "_token": "UW_GEGENEREERDE_TOKEN", ... }

Payload Structuur

Alle verzoeken die Trimoji verzendt, volgen een gestandaardiseerd JSON-formaat voor snelle identificatie van de actie.

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

  // Dynamische gegevens afhankelijk van de gebeurtenis
  "id": 12345,
  "data": { ... }
}

Lijst van beschikbare gebeurtenissen

U kunt zich abonneren op verschillende soorten acties, afhankelijk van uw automatiseringsbehoeften:

Technische Specificaties

• User-Agent: Verzoeken worden verzonden met de identificatie trimoji/1.0.0.
• Verwachte reactie: Uw server moet een 200 OK code retourneren. Bij een fout aan uw zijde, registreert Trimoji de mislukking in de logs van uw account.
• Formaat: De request body is altijd in JSON.