Docs / Webhooks
v1.0.7

Webhooks

Receba notificações HTTP em tempo real quando ocorrerem eventos na plataforma Hellena.

Configuração

  1. Crie um endpoint HTTPS público no seu serviço.
  2. Registe a URL de destino nas configurações de Webhooks da sua aplicação.
  3. Escolha os eventos que pretende receber e guarde a configuração.
  4. Responda com um código HTTP 2xx para confirmar a receção.

Utilize HTTPS em produção e processe os eventos de forma idempotente, porque um evento pode ser entregue mais de uma vez.

Eventos

product.createdUm produto foi criado.
product.updatedOs dados de um produto foram atualizados.
order.createdUm pedido novo foi registado.
order.updatedO estado ou os dados de um pedido mudaram.
payment.updatedO estado de um pagamento foi alterado.

A disponibilidade de eventos depende dos recursos ativados para a sua aplicação.

Formato do payload

JSON · exemplo ilustrativo
{
  "id": "evt_example",
  "type": "product.created",
  "created_at": "2026-10-12T12:00:00Z",
  "data": {
    "id": "123"
  }
}

Segurança e boas práticas

  • Valide a assinatura do webhook se a plataforma fornecer um segredo de assinatura.
  • Não exponha segredos nem credenciais nos logs.
  • Responda rapidamente e delegue o processamento pesado para uma fila.
  • Registe o identificador do evento para evitar processamento duplicado.