Como resolver erros de postback e atribuição

Use a saúde da integração para descobrir por que uma entrega falhou, foi rejeitada ou não encontrou a sessão do vídeo.

Abra Vendas, localize a integração e selecione Saúde. A página mostra a última entrega, a taxa de atribuição, as assinaturas rejeitadas e as falhas que precisam de revisão.

Entender cada estado

Estado	O que significa	O que fazer
Recebido	A entrega chegou e aguarda processamento.	Atualize a página depois de alguns instantes.
Processado	O evento foi validado e normalizado.	Se a venda não aparece, confira atribuição, tipo do evento e período.
Sem atribuição	O evento é válido, mas não foi ligado a uma sessão.	Confira o parâmetro de atribuição e a URL usada no checkout.
Assinatura rejeitada	O segredo recebido não confere com a integração.	Copie novamente Hottok, Secret Key ou segredo do webhook.
Evento não suportado	O status enviado não corresponde a um evento conhecido.	Ajuste os eventos no checkout ou o mapa de eventos.
Falhou	O conteúdo da entrega não pôde ser processado.	Abra o erro exibido e revise valores, moeda e mapeamento.
Ignorado	A entrega chegou enquanto a integração estava pausada.	Reative a integração antes de enviar outro teste ou evento.

Se nenhum postback aparece

Confirme que a integração está ativa.
Compare a URL configurada no checkout com a URL exibida na Moviie.
Verifique se o evento de compra aprovada está selecionado na plataforma.
Use o teste do checkout, não apenas o botão Testar da Moviie.
Volte a Saúde e selecione Atualizar.

Se você girou a URL, substitua o endereço no checkout. A URL anterior funciona por 48 horas e depois deixa de receber eventos.

Se a assinatura foi rejeitada

O segredo salvo na Moviie deve ser o mesmo usado pela plataforma para assinar a entrega. Não use a senha da conta nem uma chave de API que pertença a outro recurso.

Crie uma nova integração quando precisar substituir um segredo que não pode ser editado na tela. Depois teste a nova URL antes de remover a anterior.

Se a venda ficou sem atribuição

Um postback pode ser processado e ainda assim ficar fora do funil. Isso acontece quando:

o checkout não devolveu o parâmetro de atribuição;
a chave chegou em um campo diferente do configurado;
a URL da CTA já tinha outro valor no mesmo parâmetro;
a compra aconteceu mais de 30 dias depois da criação da chave;
a chave pertence a outra organização ou não corresponde a uma sessão válida;
a sessão foi identificada como robô ou o evento foi marcado como teste.

Abra o cartão da integração e confira o nome do parâmetro. Em integrações próprias, revise também o campo Chave Moviie no mapeamento.

Se o evento não é suportado

Para Webhook genérico, Zapier, Make e n8n, abra Mapeamento. Confira o caminho de Tipo/status do evento e o Mapa de eventos.

Os destinos aceitos são: purchase_approved, payment_pending, purchase_refused, refund, chargeback, subscription_renewed, checkout_abandoned, test e unsupported.

Um status sem correspondência continua visível na saúde, mas não entra no funil ou na receita.

Corrigir antes de interpretar o funil

Use Atribuição encontrada como sinal de qualidade da conexão. Uma taxa baixa indica que parte dos eventos chegou sem vínculo com o vídeo. Nesse cenário, a taxa de venda por play fica incompleta.

Os postbacks ficam disponíveis para replay por 180 dias. Depois de corrigir um mapeamento, entre em contato com support@moviie.ai se precisar reprocessar o histórico elegível.

Ao pedir ajuda, envie o nome da integração, a plataforma, o horário aproximado da entrega e o estado mostrado na tela. Não envie dados pessoais do comprador nem o segredo de assinatura.