Configurar webhooks

Criar um endpoint

1. 1Acesse Integrações → Webhooks e clique em "+ Novo webhook".
2. 2Cole a URL do seu servidor que receberá as notificações.
3. 3Selecione os eventos que deseja receber.
4. 4Clique em "Salvar". O Umbra Bot enviará um evento de teste imediatamente.

Eventos disponíveis

• •lead.created — novo lead captado.
• •payment.approved — pagamento confirmado.
• •payment.refunded — reembolso processado.
• •bot.disconnected — bot saiu do ar.

Exemplo de payload

{
  "event":      "payment.approved",
  "created_at": "2026-05-18T14:32:00Z",
  "data": {
    "order_id":  "ord_abc123",
    "amount":    9700,
    "currency":  "BRL",
    "customer": {
      "telegram_id": 123456789,
      "first_name":  "Maria"
    }
  }
}