Cómo resolver errores de postback y atribución

Usa la salud de la integración para saber por qué una entrega falló, fue rechazada o no encontró la sesión del video.

Abre Ventas, encuentra la integración y selecciona Salud. La página muestra la última entrega, la tasa de atribución, las firmas rechazadas y los fallos que requieren revisión.

Entender cada estado

Estado	Qué significa	Qué hacer
Recibido	La entrega llegó y espera ser procesada.	Actualiza la página después de unos instantes.
Procesado	El evento fue validado y normalizado.	Si la venta no aparece, revisa la atribución, el tipo de evento y el período.
Sin atribución	El evento es válido, pero no se vinculó a una sesión.	Revisa el parámetro de atribución y la URL usada para el checkout.
Firma rechazada	El secreto recibido no coincide con la integración.	Copia de nuevo Hottok, Secret Key o el secreto del webhook.
Evento no compatible	El estado enviado no corresponde a un evento conocido.	Ajusta los eventos en el checkout o el mapa de eventos.
Falló	El contenido de la entrega no pudo procesarse.	Abre el error mostrado y revisa valores, moneda y mapeo.
Ignorado	La entrega llegó mientras la integración estaba pausada.	Reactívala antes de enviar otra prueba o evento.

Si no aparece ningún postback

Confirma que la integración está activa.
Compara la URL del checkout con la que muestra Moviie.
Revisa que el evento de compra aprobada esté seleccionado en la plataforma.
Usa la prueba del checkout, no solo la acción Probar de Moviie.
Vuelve a Salud y selecciona Actualizar.

Si giraste la URL, sustituye la dirección en el checkout. La URL anterior funciona durante 48 horas y después deja de recibir eventos.

Si la firma fue rechazada

El secreto guardado en Moviie debe coincidir con el que usa la plataforma para firmar la entrega. No uses la contraseña de tu cuenta ni una clave de API destinada a otra función.

Crea una nueva integración cuando necesites sustituir un secreto que no puede editarse en la pantalla. Prueba la URL nueva antes de eliminar la integración anterior.

Si la venta quedó sin atribución

Un postback puede procesarse y aun así quedar fuera del embudo. Esto ocurre cuando:

el checkout no devolvió el parámetro de atribución;
la clave llegó en un campo distinto del configurado;
la URL de la CTA ya contenía otro valor en el mismo parámetro;
la compra ocurrió más de 30 días después de crear la clave;
la clave pertenece a otra organización o no corresponde a una sesión válida;
la sesión se identificó como robot o el evento se marcó como prueba.

Abre la tarjeta de la integración y revisa el nombre del parámetro. En integraciones propias, revisa también el campo Clave Moviie en Mapeo.

Si el evento no es compatible

Para Webhook genérico, Zapier, Make y n8n, abre Mapeo. Revisa la ruta de Tipo/estado del evento y el Mapa de eventos.

Los destinos aceptados son purchase_approved, payment_pending, purchase_refused, refund, chargeback, subscription_renewed, checkout_abandoned, test y unsupported.

Un estado sin correspondencia sigue visible en Salud, pero no entra en el embudo ni en los ingresos.

Corregir antes de interpretar el embudo

Usa Atribución encontrada como señal de calidad de la conexión. Una tasa baja indica que algunos eventos llegaron sin vínculo con el video. La tasa de venta por reproducción queda incompleta en ese caso.

Los postbacks permanecen disponibles para replay durante 180 días. Después de corregir un mapeo, contacta con support@moviie.ai si necesitas reprocesar el historial elegible.

Al solicitar ayuda, incluye el nombre de la integración, la plataforma, la hora aproximada de la entrega y el estado mostrado. No envíes datos personales del comprador ni el secreto de firma.