Aponte seus webhooks para uma Propriedade

Se suas integrações de webhook já estavam funcionando, elas continuam funcionando. A atualização executa uma migração de configuração que vincula cada origem existente à Propriedade 1, exatamente como ela se comportava antes. Nenhuma ação é necessária da sua parte. Nenhuma venda deixa de ser registrada por causa dessa mudança.

Você só precisa mexer nisto se quiser redirecionar uma origem para outra Propriedade — por exemplo, quando um mesmo Node atende mais de um cliente e cada um tem a própria Propriedade.

O que mudou

Cada origem de webhook — Hotmart, WooCommerce, Kiwify, Yampi — agora carrega uma vinculação explícita a uma Propriedade. Toda entrega recebida por aquela origem é atribuída àquela Propriedade.

Uma origem se vincula a exatamente uma Propriedade. Não é possível dividir uma mesma origem entre várias Propriedades por pedido, por produto ou por qualquer outro critério: se você precisa separar dois clientes, precisa de duas origens configuradas, uma para cada Propriedade.

Onde fica o seletor

No Console, abra Integrações, escolha a origem e vá em Configure. O campo é:

Propriedade que recebe estes eventos Toda entrega desta origem será atribuída a esta Propriedade.

Escolha a Propriedade e salve. A vinculação passa a valer para as entregas seguintes.

Quando o Node tem apenas uma Propriedade, o seletor já vem preenchido com ela. A vinculação continua sendo gravada de forma explícita — é só um clique a menos.

Se o Node ainda não tiver nenhuma Propriedade, crie uma antes: sem Propriedade não há para onde apontar. Veja Crie sua primeira Propriedade.

webhook_unbound — o que é e como resolver

webhook_unbound significa que a origem recebeu uma entrega que não pôde ser atribuída a nenhuma Propriedade. Nesse caso a entrega é recusada e nenhum evento é gravado — não existe um evento parcial, sem dono, aguardando conserto.

No Console, a origem aparece marcada com SEM PROPRIEDADE, e o diagnóstico registrado descreve a mesma situação. Do outro lado, a plataforma que enviou o webhook registra a recusa no próprio log de entregas dela, como um HTTP 422.

Para resolver:

1. Abra Integrações → a origem → Configure.
2. Escolha a Propriedade em Propriedade que recebe estes eventos.
3. Salve.

A partir daí as entregas voltam a ser aceitas normalmente. As entregas recusadas enquanto a origem estava sem vínculo não são recuperadas pelo Supreme; reenviar (ou não) o histórico é uma decisão de cada plataforma, com as regras dela.

Desativar uma Propriedade que ainda recebe webhooks

Uma origem vinculada a uma Propriedade que é desativada fica sem vínculo e volta a recusar entregas — o mesmo webhook_unbound acima.

Para evitar isso, o Console impede a desativação de uma Propriedade que ainda tem origens vinculadas, e nomeia quais são:

Esta Propriedade ainda recebe entregas de Hotmart, Kiwify. Redirecione essas origens antes de desativá-la.

Redirecione cada origem citada para outra Propriedade e só então desative.

Resumindo

• Já funcionava? Continua funcionando, na Propriedade 1.
• Uma origem → uma Propriedade.
• Sem vínculo → entrega recusada, nada gravado, 422 no log da plataforma.
• Desativar uma Propriedade com origens vinculadas é bloqueado até você redirecioná-las.