Pular para o conteúdo
Moviie

Solução de problemas

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.

Atualizado em 23 de outubro de 20265 min de leitura

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

EstadoO que significaO que fazer
RecebidoA entrega chegou e aguarda processamento.Atualize a página depois de alguns instantes.
ProcessadoO evento foi validado e normalizado.Se a venda não aparece, confira atribuição, tipo do evento e período.
Sem atribuiçãoO 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 rejeitadaO segredo recebido não confere com a integração.Copie novamente Hottok, Secret Key ou segredo do webhook.
Evento não suportadoO status enviado não corresponde a um evento conhecido.Ajuste os eventos no checkout ou o mapa de eventos.
FalhouO conteúdo da entrega não pôde ser processado.Abra o erro exibido e revise valores, moeda e mapeamento.
IgnoradoA entrega chegou enquanto a integração estava pausada.Reative a integração antes de enviar outro teste ou evento.

Se nenhum postback aparece

  1. Confirme que a integração está ativa.
  2. Compare a URL configurada no checkout com a URL exibida na Moviie.
  3. Verifique se o evento de compra aprovada está selecionado na plataforma.
  4. Use o teste do checkout, não apenas o botão Testar da Moviie.
  5. 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.

No mapeamento anterior, 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.

O conteúdo das entregas pode ser retido por até 180 dias. Esse prazo não torna toda entrega elegível para reprocessamento. Nas integrações antigas, entre em contato com support@moviie.ai para avaliar o histórico elegível depois de corrigir o mapeamento.

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.

Diagnosticar uma integração universal

Receber a requisição, interpretar os campos e atribuir a venda são resultados diferentes. Uma resposta de recebimento com receiptId confirma a entrega, não uma venda no funil. Confira o resultado em Saúde. Uma prévia que encontra a chave também não comprova uma venda real.

  • Erro na interpretação: revise os campos obrigatórios, caminhos, unidade do valor, moeda e tradução do evento. Carregue outra amostra se ela expirou.
  • Teste processado: a entrega foi tratada como teste e não criou receita. Uma venda real precisa chegar sem a marcação de teste.
  • Notificação repetida ou Atualização antiga ignorada: reenviar não cria outra venda nem substitui dados mais recentes.
  • Dados conflitantes: confira pedido, moeda, chave, data da origem e total de reversões. Não altere o identificador do pedido para contornar a proteção contra duplicatas.
  • Aguardando compra original: envie a compra correspondente. A reversão será reavaliada automaticamente enquanto o conteúdo estiver retido.

Publicar uma correção não reinterpreta silenciosamente as entregas anteriores. Quando uma entrega com falha for elegível, abra sua prévia em Saúde, confira o resultado e confirme o reprocessamento. Ele pode registrar uma venda real. Entregas de teste, já normalizadas, truncadas, expiradas ou sem conteúdo retido não são elegíveis. A retenção de até 180 dias é um limite, não uma garantia de reprocessamento de qualquer evento.

Se houver conflito de versão, recarregue a configuração antes de tentar novamente. Para suporte, informe o identificador da entrega, o horário e o estado. Não envie payloads com dados pessoais, chaves ou URLs de recebimento.

Continue aprendendo

Continue por aqui

Guias que ajudam no próximo passo.

SUPORTE HUMANO

Ainda precisa de ajuda?

Conte o que está acontecendo. Nossa equipe ajuda você a encontrar o próximo passo.