Caixa de teste do Lefia e encadeamento numa entrada
Teste um destino webhook sem parceiro: o Lefia recebe, guarda e mostra o que e como chegou. Ou encadeie numa entrada do próprio Lefia.
O que é
A caixa de teste do Lefia é uma ferramenta de teste: o Lefia faz o papel do parceiro. Ela não é o destino de produção — em produção, o destino webhook recebe a URL do seu parceiro.
Como usar
- Na integração, edite o destino com protocolo Webhook.
- Clique em Usar a caixa de teste do Lefia (selo Teste). A URL é preenchida:
https://lefia.ai/api/edi-hub/caixa-de-teste/<token>. - Salve. Os envios passam a chegar na caixa.
O token é um por empresa e ambiente. Ali mesmo, no destino, você escolhe a resposta simulada (200, 202, 429 com Retry-After, 500 ou timeout) — útil para ver a nova tentativa do Lefia agir — e pode revogar o token (a URL passa a responder 404).
Em PRD
A caixa funciona em todos os ambientes, mas em PRD o Lefia mostra um aviso forte e pede a sua confirmação explícita: com a caixa, nada chega ao parceiro. A integração fica marcada como PRD na caixa de teste na lista, no painel e no monitor até você trocar o destino pela URL do parceiro.
Recebidos (teste)
Na tela da integração, a aba Recebidos (teste) aparece quando o destino é a caixa. Cada chamada mostra:
- o corpo exato (e a leitura por formato: EDIFACT por segmento, JSON, XML), tamanho, content-type e sha256;
- os cabeçalhos, com Authorization, cookie, assinatura, chaves e os cabeçalhos extras guardados como segredo nos destinos como
***; - a assinatura conferida com o segredo do destino (válida, inválida ou não conferida e por quê);
- a resposta devolvida e a latência;
- a mensagem de origem, a tentativa e se foi reenvio;
- a validação pelo validador interno do formato e, se o fluxo tem par de ouro, a diferença para o arquivo validado.
Filtros: todas, desta integração, reenvios, respostas de erro, assinatura inválida.
Limites e privacidade
- Corpo até 1 MiB e 60 chamadas por minuto por token; acima disso a caixa responde 413 ou 429 sem gravar. Há também teto de chamadas na rota inteira, cota de armazenamento por empresa e por caixa e limite de caixas novas por dia.
- As chamadas ficam guardadas por 7 dias e são apagadas.
- O IP de origem é guardado só como prefixo de rede (ex.:
203.0.113.0/24).
Encadear numa entrada do Lefia
No mesmo destino webhook, Encadear numa entrada do Lefia lista as integrações de entrada por webhook da mesma empresa e do mesmo ambiente. Escolhida, a URL passa a ser a da entrada e a assinatura v2 usa o segredo daquela entrada, por referência: o segredo é resolvido só no servidor, a cada envio, e nunca aparece na tela.
- Se a URL mudar, o encadeamento é desfeito (nada é enviado com o segredo da entrada).
- Entrada de outra empresa ou outro ambiente não vale.
- A cadeia não pode voltar a uma integração já percorrida (laço) e tem limite de saltos.
Na mensagem que chegou pela entrada, o monitor mostra como chegou: o corpo e os cabeçalhos originais (mascarados) e a assinatura conferida.
Histórico de versões
- 1.1.0
"Recuperar integração" (menu da lista, integração em erro com destino webhook) passa a trocar o destino pela caixa de teste do Lefia da empresa e do ambiente — cria uma se não houver ativa, ou reaproveita a existente — no lugar de gerar uma URL nova no webhook.site (serviço público de terceiro, com cota e expiração, pra onde o dado saía do Lefia). Em PRD, a ação não troca o destino sozinha: como não tem como pedir o mesmo aviso e a mesma confirmação explícita que a caixa exige na tela da conexão, ela só avisa e orienta a usar "Usar a caixa de teste do Lefia" ali. Continua agindo só na conexão da integração escolhida.
9/27/2026 · updated
- 1.0.0
Caixa de teste do Lefia: no destino webhook da integração, "Usar a caixa de teste do Lefia" (selo Teste) cria uma URL real no lefia.ai por empresa e ambiente, no lugar do webhook.site. Cada chamada fica na aba "Recebidos (teste)" da integração exatamente como chegou (corpo, cabeçalhos mascarados, assinatura conferida, resposta e latência), ligada à mensagem de saída e à tentativa (mostra reenvio), com o validador interno e a diferença para o par de ouro. A resposta é configurável (200, 202, 429, 500, timeout) para testar a nova tentativa; o token é revogado no próprio destino. Em PRD, aviso forte e confirmação explícita, e a integração aparece como "PRD na caixa de teste" na lista, no painel e no monitor. Encadear numa entrada do Lefia: o destino entrega no webhook de entrada de outra integração da mesma empresa e ambiente, assinado com o segredo daquela entrada por referência (resolvido só no servidor; URL trocada desfaz; sem laço). Na mensagem de entrada, "como chegou" mostra a assinatura conferida.
9/27/2026 · new