#Testes e quarentena
Há três razões para um aviso não chegar ou chegar marcado como teste. Conhecê-las poupa horas de caça a bug.
#1. is_test: aviso de teste
Alguns avisos trazem is_test: true. Onde ele fica depende do fluxo:
- Pagamento: em
data.object.is_test, sempre presente (trueoufalse). - Assinatura da plataforma: em
data.object.is_test, só quando é teste. - Lead e grupo: no topo do corpo, só quando vale
true; se o campo estiver ausente, não é teste. - Acesso (
access.*): não há o campo. Venda de teste não gera acesso (a KB a recusa com o motivotest_sale).
Nunca trate como venda ou cadastro de verdade: não libere acesso, não lance receita, não dispare mensagem.
Um aviso vira teste quando:
- vem de um teste manual (
delivery.kind: "manual_test", comtest_reason: "manual_test"); - a plataforma marcou como teste;
- o e-mail é de domínio reservado (
example.com,example.org,test...). Por isso, ao testar com dados seus, use algo comocliente-exemplo.com.br.
#2. Quarentena
Antes de enviar a um destino, o Business OS revisa cada aviso. Se algo parecer errado, o aviso fica retido (quarentena) até uma pessoa decidir. Você não recebe nada. Os motivos:
| Motivo | O que é |
|---|---|
test_event | Parece teste. |
unmapped_offer | A oferta da plataforma não tem de-para no catálogo: a automação não saberia o que foi vendido. |
| duplicata | Mesmo aviso repetido dentro de uma janela (padrão 30 minutos). |
| valor fora da faixa | amount abaixo de amount_min ou acima de amount_max configurados para o destino. |
Quem decide é a equipe da KB, que aprova (o aviso sai) ou descarta o aviso retido. Se você espera um aviso e ele não veio, peça para olhar a quarentena antes de achar que seu servidor falhou. É também possível consultar GET /v1/webhooks/outbox (veja API).
#3. Os modos do destino
Cada destino tem um modo, que a equipe configura:
| Modo | Efeito |
|---|---|
automatic | Envia sozinho. |
approval | Retém tudo até alguém aprovar. |
rehearsal | Ensaio: não envia de verdade. |
disabled | Desligado. |
#Trava geral
Existem dois freios do servidor que independem do seu endereço:
- um interruptor geral de saída, que a KB mantém ligado ou desligado;
- uma lista de destinos permitidos: o host da sua URL precisa estar nela. Se o seu host não foi adicionado, nada sai. Peça à KB para incluí-lo (é parte do passo "Peça à KB" do Início rápido).
E regras de segurança do envio: só https, sem endereços de rede interna, sem seguir redirecionamentos.
#Teste manual (hoje)
A equipe pode disparar um aviso de teste para o seu destino. Limites:
- no máximo 1 na fila e 5 por hora por destino;
- sem retry;
- cobre apenas
group.joinedelead.registered; - sempre com
is_test: trueetest_reason: "manual_test"; - não sai se o interruptor global estiver desligado.
Para um teste iniciado por você, veja Teste ao vivo (em breve).
#Dicas para testar bem
- Confira primeiro a assinatura com o seu código e o exemplo do evento (a página de cada evento em Webhooks traz o corpo completo).
- Responda 200 e confira se o seu registro de ids funciona rejeitando uma repetição.
- Teste também o caminho de falha: responda 500 de propósito e veja o retry chegar com
x-kb-attempt: 2.