Webhooks

Webhooks gör det möjligt för Trimoji att skicka realtidsmeddelanden till din applikation så snart en händelse inträffar (test slutfört, kampanj skapad, etc.). Det är den mest effektiva metoden för att synkronisera dina data utan att onödigt belasta API:et.

Hur det fungerar: När en händelse inträffar gör Trimoji ett HTTP POST-anrop till en URL som du har konfigurerat, och bifogar motsvarande data.

Konfiguration av Webhook

Hanteringen av webhooks sker i ditt kundgränssnitt: Mitt Trimoji-konto.

Konfigurationssteg:

• Ange din servers destination-URL (t.ex. https://din-sida.com/api/webhook).
• Välj de händelser du vill lyssna på.
• Bekräfta tillägget.
• Viktigt: När webhooken är skapad genererar Trimoji automatiskt en unik hemlighet (token). Du måste hämta denna token för att säkra din endpoint.

Säkerhet och autentisering

Vid varje sändning använder Trimoji den genererade hemligheten för att signera och autentisera förfrågan. Du måste verifiera denna information på serversidan för att säkerställa att anropet verkligen kommer från våra tjänster.

Token skickas på två sätt i varje anrop:

• I HTTP-huvudet: Authorization: DIN_GENERERADE_TOKEN
• I JSON-kroppen: { "_token": "DIN_GENERERADE_TOKEN", ... }

Struktur för nyttolast (Payload)

Alla förfrågningar som Trimoji skickar följer ett standardiserat JSON-format som möjliggör snabb identifiering av åtgärden.

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

  // Dynamisk data beroende på händelse
  "id": 12345,
  "data": { ... }
}

Lista över tillgängliga händelser

Du kan prenumerera på olika typer av åtgärder beroende på dina automatiseringsbehov:

Tekniska specifikationer

• User-Agent: Förfrågningar skickas med identifieraren trimoji/1.0.0.
• Förväntat svar: Din server bör returnera en 200 OK-kod. Om det finns ett fel från din sida loggas felet i ditt konto.
• Format: Begäransmottagningen är alltid i JSON.