Webhooks

I Webhooks consentono a Trimoji di inviare notifiche in tempo reale alla Vostra applicazione non appena si verifica un evento (fine di un test, creazione di una campagna, ecc.). Questo è il metodo più efficiente per sincronizzare i dati senza sovraccaricare inutilmente l'API.

Funzionamento: Quando si verifica un evento, Trimoji effettua una chiamata HTTP POST a un URL da Lei configurato, includendo i dati corrispondenti.

Fase 1

Configurazione del Webhook

La gestione dei webhooks si effettua nella Vostra interfaccia cliente: Il Mio Account Trimoji.

Passaggi di configurazione:

Inserisca l'URL di destinazione del Suo server (es: https://il-vostro-sito.com/api/webhook).
Selezioni gli eventi che desidera ascoltare.
Confermi l'aggiunta.
Importante: Una volta creato il webhook, Trimoji genera automaticamente un Segreto (Token) unico. Lei deve recuperare questo token per mettere in sicurezza il Suo endpoint.

Fase 2

Sicurezza e Autenticazione

Per ogni invio, Trimoji utilizza il segreto generato per firmare e autenticare la richiesta. Lei deve verificare questa informazione lato server per assicurarsi che la chiamata provenga dai nostri servizi.

Il token viene trasmesso in due modi in ogni chiamata:

Nell'intestazione HTTP: Authorization: IL_TUO_TOKEN_GENERATO
Nel corpo JSON: { "_token": "IL_TUO_TOKEN_GENERATO", ... }

Fase 3

Struttura del payload

Tutte le richieste inviate da Trimoji seguono un formato JSON standardizzato che consente una rapida identificazione dell'azione.

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

  // Dati dinamici in base all'evento
  "id": 12345,
  "data": { ... }
}

Fase 4

Elenco degli eventi disponibili

Può abbonarsi a diversi tipi di azioni in base alle Sue esigenze di automazione:

Test e Valutazioni

QUIZZ_SENT
QUIZZ_COMPLETED

Candidati e Profili

PROFILE_UPDATED
PROFILE_DELETED
PROFILE_RESTORED

Campagne e Personi

CAMPAIGN_CREATED / UPDATED
PERSONI_CREATED

Sicurezza e Flussi

AUTH_LOGIN
TRANSFER_INCOMING

Fase 5

Specifiche Tecniche

User-Agent: Le richieste vengono inviate con l'identificativo trimoji/1.0.0.
Risposta attesa: Il Suo server deve restituire un codice 200 OK. In caso di errore da parte Sua, Trimoji registra l'inconveniente nei log del Suo account.
Formato: Il corpo della richiesta è sempre in JSON.