# 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.

- Canonical: https://moviie.ai/help/pt-br/problemas/resolver-erros-de-postback-e-atribuicao
- Language: pt-BR
- Category: Solução de problemas
- Published: 2026-08-11
- Updated: 2026-08-11

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.

## Continue aprendendo

Como conectar um checkout e configurar postbacks

Como acompanhar o funil de vendas por vídeo