Webhooks

Les Webhooks permettent à Trimoji d'envoyer des notifications en temps réel à votre application dès qu'un événement survient (fin d'un test, création d'une campagne, etc.). C'est la méthode la plus efficace pour synchroniser vos données sans solliciter inutilement l'API.

Fonctionnement : Lorsqu'un événement se produit, Trimoji effectue un appel HTTP POST vers une URL que vous avez configurée, en y joignant les données correspondantes.

Configuration du Webhook

La gestion des webhooks s'effectue dans votre interface client : Mon Compte Trimoji.

Étapes de configuration :

• Saisissez l'URL de destination de votre serveur (ex: https://votre-site.com/api/webhook).
• Sélectionnez les événements que vous souhaitez écouter.
• Validez l'ajout.
• Important : Une fois le webhook créé, Trimoji génère automatiquement un Secret (Token) unique. Vous devez récupérer ce token pour sécuriser votre endpoint.

Sécurité et Authentification

Pour chaque envoi, Trimoji utilise le secret généré pour signer et authentifier la requête. Vous devez vérifier cette information côté serveur pour vous assurer que l'appel provient bien de nos services.

Le token est transmis de deux manières dans chaque appel :

• Dans l'en-tête HTTP : Authorization: VOTRE_TOKEN_GENERE
• Dans le corps JSON : { "_token": "VOTRE_TOKEN_GENERE", ... }

Structure de la charge utile (Payload)

Toutes les requêtes envoyées par Trimoji suivent un format JSON standardisé permettant une identification rapide de l'action.

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

  // Données dynamiques selon l'événement
  "id": 12345,
  "data": { ... }
}

Liste des événements disponibles

Vous pouvez vous abonner à différents types d'actions selon vos besoins d'automatisation :

Spécifications Techniques

• User-Agent : Les requêtes sont envoyées avec l'identifiant trimoji/1.0.0.
• Réponse attendue : Votre serveur doit retourner un code 200 OK. En cas d'erreur de votre côté, Trimoji enregistre l'échec dans les logs de votre compte.
• Format : Le corps de la requête est toujours en JSON.