# Webhooks Use Webhooks para receber eventos de tarefa e cobrança sem sondagem. Tripo envia cargas úteis JSON para seu endpoint HTTPS quando ocorrem eventos assinados. ## Configuração 1. Abra Configurações e depois Webhooks. 2. Adicione um terminal HTTPS, como `https://api.yourapp.com/tripo-webhook`. 3. Selecione os tipos de eventos que deseja receber. 4. Salve o ponto final. 5. Copie o segredo de assinatura e armazene-o com segurança. É mostrado apenas uma vez. ## Tipos de eventos | Evento | Descrição | | --- | --- | | `task.completed` | Uma tarefa concluída com sucesso. | | `task.failed` | Uma tarefa falhou ou foi cancelada. | | `balance.low` | O saldo da conta caiu abaixo do limite de alerta de crédito configurado. | ## Solicitar cabeçalhos | Cabeçalho | Descrição | | --- | --- | | `Tripo-Webhook-Id` | Ponto de extremidade Webhook ID. | | `Tripo-Webhook-Delivery` | Entrega exclusiva ID. Use-o para idempotência. | | `Tripo-Webhook-Event` | Tipo de evento, como `task.completed`. | | `Tripo-Webhook-Signature` | Assinatura HMAC-SHA256 sobre `{timestamp}.{raw_body}`. | | `Content-Type` | Sempre `application/json`. | ## Verificação 1. Analise `t` e `v1` de `Tripo-Webhook-Signature`. 2. Calcule HMAC-SHA256 com o segredo de assinatura sobre `t + "." + rawBody`. 3. Compare o resumo hexadecimal calculado com `v1` usando uma comparação de tempo constante. 4. Opcionalmente, rejeite carimbos de data/hora com mais de cinco minutos. ## Melhores Práticas - Retorne uma resposta `2xx` rapidamente e processe o trabalho pesado de forma assíncrona. - Verifique cada carga útil antes de alterar o estado do aplicativo. - Desduplicar eventos usando `Tripo-Webhook-Delivery`. - Use `balance.low` para alertar os usuários antes que a criação da tarefa falhe devido a créditos insuficientes.