Com webhooks, a Racoo envia automaticamente uma notificação para um endereço (endpoint) seu sempre que algo acontece — como uma venda aprovada. É a forma de integrar a plataforma com seus próprios sistemas.
Onde configurar
No menu, abra Integrações › Webhooks.
Crie um webhook
- Clique para adicionar um novo webhook.
- Informe o Nome (ex.: "Notificação principal").
- Informe a URL do endpoint (ex.:
https://api.seusite.com/webhook). - Deixe a opção Ativo ligada.
- Selecione os Eventos que você quer receber.
- Salve.
Eventos e disparos
Cada webhook é assinado em uma lista de Eventos. Em Endpoints configurados, você acompanha os disparos e os últimos disparos de cada um, útil para depurar a integração.
Segurança (verificação de assinatura)
Cada webhook tem um Secret (HMAC-SHA256). Para garantir que a notificação veio mesmo da Racoo, compare o header X-Webhook-Signature com o HMAC-SHA256 do corpo da requisição usando o seu secret.
Em caso de falha de entrega, há reenvio automático: até 3 tentativas com espera crescente (5s, 30s, 5min).
Documentação
Na própria tela há a Documentação da API de Webhooks, com a descrição de cada evento e do formato das notificações. Consulte-a ao desenvolver sua integração.
Dica
Comece assinando apenas os eventos que você realmente vai usar (por exemplo, venda aprovada). Isso simplifica o tratamento no seu sistema e facilita o diagnóstico.