Webhooks

Os Webhooks permitem que o Trimoji envie notificações em tempo real para sua aplicação assim que um evento ocorrer (fim de um teste, criação de uma campanha, etc.). É a forma mais eficiente de sincronizar seus dados sem sobrecarregar a API desnecessariamente.

Como funciona: Quando um evento ocorre, o Trimoji faz uma chamada HTTP POST para uma URL que você configurou, anexando os dados correspondentes.

Configuração do Webhook

O gerenciamento dos webhooks é feito em sua interface cliente: Minha Conta Trimoji.

Etapas de configuração:

• Insira a URL de destino do seu servidor (ex: https://seu-site.com/api/webhook).
• Selecione os eventos que deseja monitorar.
• Confirme a adição.
• Importante: Após a criação do webhook, o Trimoji gerará automaticamente um Token Secreto único. Você precisará recuperar este token para proteger seu endpoint.

Segurança e Autenticação

Para cada envio, o Trimoji usa o token secreto gerado para assinar e autenticar a requisição. Você deve verificar esta informação no lado do servidor para garantir que a chamada venha de nossos serviços.

O token é transmitido de duas maneiras em cada chamada:

• No cabeçalho HTTP: Authorization: SEU_TOKEN_GERADO
• No corpo JSON: { "_token": "SEU_TOKEN_GERADO", ... }

Estrutura da Carga Útil (Payload)

Todas as requisições enviadas pelo Trimoji seguem um formato JSON padronizado que permite uma identificação rápida da ação.

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

  // Dados dinâmicos dependendo do evento
  "id": 12345,
  "data":  { ... }
}

Lista de eventos disponíveis

Você pode se inscrever em diferentes tipos de ações, de acordo com suas necessidades de automação:

Especificações Técnicas

• User-Agent: As requisições são enviadas com o identificador trimoji/1.0.0.
• Resposta esperada: Seu servidor deve retornar um código 200 OK. Em caso de erro do seu lado, o Trimoji registrará a falha nos logs da sua conta.
• Formato: O corpo da requisição é sempre em JSON.