Códigos de error de Meta
Si recibiste un código de error al enviar un mensaje desde la plataforma o vía API, búscalo abajo para entender qué pasa y qué hacer. Cubre WhatsApp Cloud API, Messenger Send API e Instagram Login.
76 de 76 códigos
Excepción de autenticación
Meta no pudo autenticar al usuario de la app. El token está inválido o el usuario revocó el acceso.
Causas probables
- Access token revocado o invalidado
- Usuario removió permisos a la app
- Token de un System User que ya no existe
Acción recomendada
Generar un nuevo access token de System User y actualizarlo en el canal. Verificar que el usuario no haya revocado permisos en Business Manager.
Permisos faltantes en el token
El token no tiene los scopes necesarios para esta operación.
Causas probables
- Falta scope whatsapp_business_messaging / pages_messaging
- Falta whatsapp_business_management / instagram_basic
- Token generado para una app distinta
Acción recomendada
Re-generar el token con los scopes requeridos desde el Access Token Debugger y actualizarlo en el canal.
Permiso denegado
El permiso requerido no está concedido o fue removido para esta acción.
Causas probables
- Número no agregado al allowlist de la app
- Permisos revocados por el admin
- App en modo development con número no autorizado
Acción recomendada
Revisar permisos del token y asegurar que el recurso (número/página/cuenta IG) está vinculado al Business correcto.
Parámetro inválido o mal escrito
La request incluyó parámetros no soportados o con nombre incorrecto. Subcode 33 indica recurso eliminado; subcode 200 indica forbidden.
Causas probables
- Typo en el nombre de un campo
- ID no pertenece al recurso del token
- Valor excede longitud máxima permitida
Acción recomendada
Revisar el payload contra la documentación de Meta. Si subcode 33, el recurso fue eliminado y hay que re-vincularlo.
Access token expirado
El access token caducó. Suele pasar con tokens de usuario (60 días) en vez de System User.
Causas probables
- Token de usuario (no System User) que expiró
- Contraseña de Facebook cambiada
- Sesión invalidada por Meta
Acción recomendada
Re-conectar el canal vía Embedded Sign Up para emitir un nuevo token de System User (no expiran).
Sesión invalidada (password cambiado)
El token se invalidó porque el usuario cambió su contraseña o Facebook revocó la sesión por seguridad.
Causas probables
- Cambio de contraseña del admin
- Logout forzado por Facebook
- Usuario revocó el acceso de la app
Acción recomendada
El admin debe reconectar la cuenta haciendo de nuevo el flow de OAuth (Embedded Sign Up).
API permission denegada (403)
El permiso fue removido o nunca se concedió. Devuelve HTTP 403 Forbidden.
Causas probables
- Usuario removió la app de su Business Manager
- WABA/Página desvinculada de la app
- Cambio de roles en Business Manager
Acción recomendada
Re-asociar la app al recurso en Business Manager y regenerar el token.
Page Publishing Authorization requerida
Páginas con audiencia grande requieren que un admin complete la verificación de identidad y autorización de publicación.
Causas probables
- Página alcanzó umbral de audiencia que dispara PPA
- Admin nunca completó la verificación
Acción recomendada
Pide al admin que complete el flujo de Page Publishing Authorization desde Facebook.
Cuenta bloqueada por violación de políticas
La cuenta está temporalmente bloqueada por violar políticas de WhatsApp/Meta (mensajería, comercio o términos).
Causas probables
- Alta tasa de bloqueos por usuarios
- Contenido prohibido (regulado, ilegal)
- Spam reportado masivamente
- Violación de Commerce Policy
Acción recomendada
Revisar el detalle en Business Support Home y apelar. Bloqueos típicos son 1-30 días; reincidencias resultan en deshabilitación permanente.
Límite de llamadas de la app alcanzado
La app excedió su rate limit horario del Graph API.
Causas probables
- Default 200 calls/hora/app/WABA superado
- Polling agresivo sin caché
- App nueva sin recurso activo (tope bajo)
Acción recomendada
Implementar exponential backoff. Apps con recurso activo escalan a 5000 calls/hora.
Límite de requests por usuario alcanzado
El user-level rate limit del Graph API se agotó. Es el sibling de 4 pero por usuario en vez de por app.
Causas probables
- Demasiadas llamadas concentradas en pocos minutos
- Múltiples workers compartiendo el mismo token
Acción recomendada
Distribuir la carga en el tiempo y reintentar con backoff. Considerar sharding por recurso.
WABA alcanzó su rate limit
La WhatsApp Business Account excedió su límite de requests. Devuelve HTTP 400.
Causas probables
- Default 200 calls/hora por WABA superado
- Bursts de mensajería sin throttling
Acción recomendada
Aplicar throttling y reintentar pasado el ciclo. Si la WABA está activa con phone registrado, el límite sube a 5000/hora.
Business-level rate limit alcanzado
Rate limit al nivel del Business Manager (no la WABA individual). Aplica cuando un mismo Business agrupa múltiples WABAs.
Causas probables
- Volumen agregado de múltiples WABAs del mismo Business
- Llamadas compartidas a endpoints de Business
Acción recomendada
Reducir la concurrencia agregada del Business o distribuir en distintos Business Managers si la escala lo justifica.
Throughput de Cloud API alcanzado
Se superó el techo de mensajes por segundo del Cloud API. Default 80 mps; cuentas elegibles llegan a 1000 mps.
Causas probables
- Broadcast masivo sin pacing
- Worker enviando sin queue throttling
Acción recomendada
Throttlear el worker. Pedir upgrade de throughput tier si el negocio lo requiere.
Usuario excluido por experimento de Meta
El destinatario está en un grupo experimental (~1%) que excluye mensajes de marketing sin conversación previa.
Causas probables
- Usuario en experiment group sin conversación reciente
- Marketing message sin engagement previo del cliente
Acción recomendada
No hay bypass directo. Esperar a que el usuario inicie conversación, enviar utility/auth template, o que llegue vía click-to-WhatsApp ad.
Restricción de país para mensajería
La cuenta no está autorizada a enviar mensajes a usuarios en este país (típicamente Brasil o Indonesia).
Causas probables
- WABA en tier inicial intentando mensajería cross-border
- País restringido por regulación local
Acción recomendada
Completar el scaling path hasta tier de 2000 destinatarios. Brasil e Indonesia pueden mantenerse restringidos.
Cuenta bloqueada
La cuenta o el phone number quedó bloqueado por violación de políticas o fallo de verificación de datos.
Causas probables
- PIN de 2FA incorrecto repetido
- Verificación de identidad fallida
- Violación de políticas
Acción recomendada
Deshabilitar 2FA, re-registrar el número y volver a habilitar 2FA con un PIN conocido. Si persiste, abrir caso con soporte.
Problema de elegibilidad por pago
La cuenta tiene un problema con el método de pago, el crédito, o la configuración fiscal.
Causas probables
- Sin payment method vinculado
- Credit limit excedido o credit line inactiva
- Falta timezone/currency/Tax Info en Business Manager
- Factura impaga
Acción recomendada
Vincular un método de pago válido en Business Manager, agregar Tax Info y verificar timezone/currency de la WABA.
Cuenta en modo mantenimiento
La WABA está temporalmente en mantenimiento, típicamente durante un upgrade de throughput.
Causas probables
- Upgrade de tier en progreso
- Mantenimiento programado de Meta
Acción recomendada
Reintentar pasados unos minutos. Si excede 1 hora, abrir caso con soporte.
Suscripción de webhook inválida
La app no está suscrita correctamente a los webhooks de la WABA.
Causas probables
- App nunca llamó al endpoint subscribed_apps de la WABA
- Suscripción removida manualmente
Acción recomendada
Llamar POST /{waba-id}/subscribed_apps para re-suscribir la app a los webhooks de la WABA.
Error interno de WhatsApp ("Something went wrong")
Error genérico interno del servicio de mensajería de Meta. Suele ser transitorio pero a veces requiere recrear la app.
Causas probables
- Falla temporal del backend de Meta
- Estado inconsistente del Phone Number en sistemas de Meta
- GraphQL request interna falló del lado de Meta
- Signature calculation falló internamente
Acción recomendada
Reintentar en 5-10 minutos. Si persiste, recrear la app en Developer Console y re-asociar phone numbers, templates, token y webhook.
Acceso denegado al recurso
Permiso no concedido o removido para el recurso específico de WhatsApp.
Causas probables
- Token sin whatsapp_business_messaging
- Phone number no pertenece a la WABA del token
Acción recomendada
Verificar scopes del token vía Access Token Debugger y confirmar que el phone_number_id pertenece a la WABA.
Parámetro requerido faltante
La request omitió un campo obligatorio del payload.
Causas probables
- Bug en el código que arma el payload
- Variante de mensaje que requiere campos extra (ej. template sin components)
Acción recomendada
Revisar el endpoint en la documentación y agregar el campo faltante. Si el error apunta a un nested field, validar la estructura completa.
Valor de parámetro inválido
Uno o más valores del payload tienen formato incorrecto o no corresponden al recurso.
Causas probables
- Formato de teléfono inválido (debe ser E.164 sin +)
- Phone number no agregado a la WABA
- Tipo de media no soportado
- Variable de template con tipo incorrecto
Acción recomendada
Validar el formato del payload contra la doc. Confirmar que el destinatario es E.164 sin '+' y que todos los IDs pertenecen al canal correcto.
Servicio temporalmente no disponible
Un servicio interno de WhatsApp está caído o en mantenimiento.
Causas probables
- Mantenimiento planificado
- Outage regional
- Degradación del backend
Acción recomendada
Revisar la WhatsApp Business Platform Status page y reintentar con backoff.
Remitente y destinatario son iguales
El phone number del sender y del recipient coinciden. WhatsApp no permite enviarse a sí mismo.
Causas probables
- Test apuntando al mismo número del canal
- Bug en lookup de contacto
Acción recomendada
Usar un número de prueba distinto al del canal. Validar en código que sender !== recipient antes de enviar.
Mensaje no entregable
WhatsApp no pudo entregar el mensaje al destinatario por una razón de identidad o disponibilidad.
Causas probables
- El número no usa WhatsApp
- Usuario no aceptó los Terms of Service de WhatsApp
- Versión de WhatsApp del usuario muy antigua
- Auth template enviado a India sin permiso (regulación local)
Acción recomendada
Confirmar con el destinatario que tiene WhatsApp activo y actualizado, y que aceptó los ToS. Mantener tasa de error <1%.
Display name no aprobado
El phone number necesita un display name aprobado antes de poder enviar mensajes (típico de números de prueba de Meta).
Causas probables
- Display name nunca configurado
- Display name pending review
- Display name rechazado
Acción recomendada
Configurar y enviar a aprobación el display name desde WhatsApp Manager o Facebook Business Help Center.
Error de registro del phone number
El phone number no fue registrado correctamente o tiene un certificado inválido. Para Cloud API esto típicamente indica que el número nunca completó register.
Causas probables
- Phone number no llamó al endpoint /register
- Certificado migrado mal desde On-Premises
- PIN incorrecto durante registro
Acción recomendada
Llamar POST /{phone-number-id}/register con el PIN correcto. Si viene de On-Premises, completar el flow de migración.
Ventana de 24 horas cerrada
Pasaron más de 24 horas desde el último mensaje del destinatario, por lo que sólo se pueden enviar templates aprobados.
Causas probables
- Conversación inactiva desde hace más de 24h
- Intento de session message a un usuario que sólo recibió templates
Acción recomendada
Enviar un template aprobado (utility, marketing o auth) para re-abrir la ventana. Mantener la tasa de este error <1%.
Spam rate limit
El phone number tiene restricciones por baja calidad o reportes de spam.
Causas probables
- Quality rating bajo (yellow/red)
- Tasa alta de bloqueos por usuarios
- Reportes de spam recurrentes
Acción recomendada
Mejorar la calidad del contenido, reducir frecuencia y opt-in correctamente. Esperar a que el quality rating se recupere.
Mensaje filtrado por pacing de ecosistema
Meta decidió no entregar el mensaje para mantener un ecosistema sano. El usuario excedió su cap de mensajes de marketing por businesses.
Causas probables
- Cap per-user de marketing messages alcanzado
- Usuario inactivo con baja propensión a engagement
Acción recomendada
Esperar 24-48h antes de reintentar al mismo destinatario. Usar utility messages cuando aplique. No tiene efecto en EEA, UK, Japón y Corea del Sur.
Tipo de mensaje no soportado
El tipo declarado en el payload no es soportado por la Cloud API.
Causas probables
- Typo en el campo type
- Uso de tipo sólo soportado en On-Premises
- Combinación de campos no permitida
Acción recomendada
Revisar la lista de tipos soportados (text, image, video, audio, document, template, interactive, location, contacts, sticker, reaction).
Error descargando media entrante
WhatsApp no pudo descargar el media que envió el usuario.
Causas probables
- Media corrupto del lado del usuario
- Falla transitoria del CDN de WhatsApp
- Tamaño excede límites
Acción recomendada
Pedirle al usuario que reenvíe el archivo. Si es recurrente, sugerir formato/tamaño alternativos.
Error subiendo media saliente
WhatsApp no pudo subir el media que se intentó enviar.
Causas probables
- MIME type no soportado
- Archivo corrupto
- Tamaño excede el límite (5MB imagen, 16MB video/audio, 100MB doc)
- URL pública del media inaccesible
Acción recomendada
Validar MIME y tamaño antes de subir. Si se usa link, confirmar que la URL es pública y devuelve Content-Type correcto.
Pair rate limit (sender ↔ recipient)
Demasiados mensajes en poco tiempo entre el mismo par sender/recipient.
Causas probables
- Burst de mensajes al mismo contacto
- Bot en loop respondiendo demasiado rápido
Acción recomendada
Espaciar mensajes al mismo destinatario. Otros destinatarios siguen funcionando. Implementar throttling por par.
Cantidad de parámetros no coincide con el template
El número de variables enviadas no coincide con el del template aprobado.
Causas probables
- Template editado en Meta sin actualizar el código
- Components mal estructurados (header/body/buttons)
- Variables faltantes en algún component
Acción recomendada
Sincronizar el conteo de variables del template aprobado con el payload. Validar la estructura components → parameters.
Template no existe en el idioma indicado
El template no existe, no está aprobado, o no tiene la traducción solicitada.
Causas probables
- Nombre con typo
- Idioma incorrecto (ej. 'es' vs 'es_AR')
- Template todavía en review
- Template eliminado
Acción recomendada
Confirmar nombre y código de idioma en WhatsApp Manager y esperar a que esté aprobado antes de enviar.
Texto hidratado del template demasiado largo
Al sustituir variables, el texto resultante supera el límite de caracteres.
Causas probables
- Variables muy largas
- Body del template ya cerca del límite
Acción recomendada
Acortar la plantilla base o limitar el largo de las variables en el código antes de enviar.
Template viola políticas de WhatsApp
El contenido del template fue rechazado por violar las políticas de contenido.
Causas probables
- Lenguaje promocional excesivo
- Contenido prohibido (tabaco, alcohol, regulados)
- Solicitud de datos sensibles
Acción recomendada
Revisar el motivo de rechazo en Business Support Home, ajustar el copy y reenviar a aprobación.
Formato de parámetro no coincide con el template
El tipo de un parámetro no coincide con el tipo esperado (ej. se mandó texto donde el template espera imagen).
Causas probables
- Header de imagen enviado como texto
- Currency/date_time con estructura incorrecta
- URL en lugar de media id, o viceversa
Acción recomendada
Alinear los tipos de parámetros con la definición aprobada del template (text, image, document, currency, date_time, etc.).
Template pausado por baja calidad
El template fue pausado automáticamente por feedback negativo o baja engagement.
Causas probables
- Usuarios bloqueando tras recibir el template
- Reportes de spam
- Tasa de read/reply muy baja
Acción recomendada
Revisar quality score en WhatsApp Manager. Pausa 1: 3h, Pausa 2: 6h, Pausa 3: permanente (132016).
Template deshabilitado permanentemente
Tras múltiples pausas por baja calidad (3 veces), el template quedó permanentemente inhabilitado.
Causas probables
- Reincidencia en quality issues
- Contenido percibido como spam
Acción recomendada
Crear un template nuevo con mejor contenido y opt-in más claro. El template viejo no se puede reactivar.
WhatsApp Flow bloqueado
El Flow está en estado bloqueado por violaciones de política o reportes de usuarios.
Causas probables
- Reportes de usuarios contra el Flow
- Endpoint del Flow respondiendo errores
- Configuración inválida del Flow
Acción recomendada
Revisar el Flow en WhatsApp Manager, corregir endpoint y configuración, y solicitar revisión.
WhatsApp Flow throttleado
El Flow está limitado a 10 mensajes/hora porque sus métricas de salud son malas.
Causas probables
- Tasa alta de drop-off
- Endpoint del Flow lento o con errores
- Navegación con loops
Acción recomendada
Mejorar performance del endpoint y la UX del Flow. Mantenerse bajo el cap mientras métricas se recuperan.
Deregistration anterior incompleta
Hay una deregistration pendiente que bloquea registrar el número de nuevo.
Causas probables
- Deregister llamado pero no completó
- Estado inconsistente tras error de red
Acción recomendada
Completar la deregistration manualmente o esperar a que se asiente, luego re-intentar register.
Servidor temporalmente no disponible (registration)
El servidor de registración está temporalmente caído.
Causas probables
- Mantenimiento del endpoint de register
- Outage transitorio
Acción recomendada
Reintentar pasados unos minutos con backoff.
PIN de 2FA incorrecto
El PIN de verificación en dos pasos no coincide con el configurado en la WABA.
Causas probables
- PIN escrito mal
- PIN cambiado y no actualizado en el secret store
Acción recomendada
Confirmar el PIN actual en WhatsApp Manager. Si está bloqueado, usar el flujo de reset.
Re-verificación requerida antes de registrar
El phone number debe completar verificación antes de poder ser registrado.
Causas probables
- Cambio de WABA owner
- Cuenta nueva sin verificación previa
Acción recomendada
Completar el flujo de verificación (SMS o voz) y reintentar register.
Demasiados intentos de PIN — cuenta lockeada
Se superó el límite de intentos incorrectos del PIN de 2FA, hay un timeout.
Causas probables
- Brute-force accidental por bug
- Múltiples reintentos automáticos sin sleep
Acción recomendada
Esperar el lockout indicado en el error (suele ser horas) antes de reintentar. No automatizar reintentos sin backoff exponencial.
PIN ingresado demasiado rápido
Meta detectó intentos de PIN demasiado seguidos y aplicó un cooldown.
Causas probables
- Worker reintentando sin delay
- Múltiples instancias compitiendo
Acción recomendada
Esperar el tiempo indicado en el error y reintentar más lentamente.
Phone number no registrado
Se intentó usar el phone number antes de haberlo registrado en la Cloud API.
Causas probables
- Falta llamar /register tras Embedded Sign Up
- Número eliminado y no re-registrado
Acción recomendada
Llamar POST /{phone-number-id}/register con el PIN correcto antes de enviar mensajes.
Cooldown post-deletion
El número fue eliminado recientemente y la deletion todavía no se asentó. Hay que esperar antes de re-registrar.
Causas probables
- Deletion en progreso
- Re-register inmediato tras delete
Acción recomendada
Esperar 5+ minutos y reintentar el register.
Rate limit de registración
Se hicieron demasiados intentos de register/deregister para este número en las últimas 72 horas (máx 10).
Causas probables
- Loop accidental de register
- Migración mal automatizada
Acción recomendada
Esperar a que pasen 72 horas desde el último intento antes de reintentar.
Error genérico del usuario (parámetros)
Meta retiene el detalle por seguridad: hay algo mal con los parámetros del mensaje, frecuentemente relacionado al template.
Causas probables
- Template en estado inconsistente
- Phone number en estado inconsistente
- Combinación inválida que Meta no expone
Acción recomendada
Workaround: eliminar y recrear los templates afectados. Si persiste, eliminar el phone number de la WABA y re-agregarlo.
Mensaje fuera de la ventana de 24h
Messenger sólo permite responder dentro de las 24h posteriores al último mensaje del usuario. La ventana ya se cerró para este hilo.
Causas probables
- El usuario no escribe hace más de 24h
- Se intentó enviar mensaje promocional sin message_tag válido
- El tag usado no aplica (ej. ACCOUNT_UPDATE para marketing)
Acción recomendada
Espera a que el usuario responda o usa un message_tag soportado (HUMAN_AGENT, CONFIRMED_EVENT_UPDATE, POST_PURCHASE_UPDATE, ACCOUNT_UPDATE).
Mensaje rechazado por política post-24h
Variante del cierre de ventana cuando se intenta usar un message_tag que no aplica. La política de Messenger prohíbe el envío sin un tag válido pasadas las 24h.
Causas probables
- Tag inválido para mensajes fuera de ventana
- Mensaje promocional disfrazado con tag transaccional
Acción recomendada
Reemplaza por un mensaje conversacional dentro de ventana o usa HUMAN_AGENT (requiere permiso human_agent aprobado).
Tag de mensaje no soportado
El message_tag enviado no está en la lista permitida por Meta o tu app no tiene aprobado el permiso necesario para usarlo.
Causas probables
- Uso de tag deprecado (ej. NON_PROMOTIONAL_SUBSCRIPTION)
- App sin permiso pages_messaging_subscriptions
- Tag mal escrito o en mayúsculas/minúsculas incorrectas
Acción recomendada
Revisa la lista vigente de message tags y solicita el permiso correspondiente en App Review.
Bloqueado por regulación europea (ePrivacy)
Restricción para usuarios del EEE: ciertas funciones (Personas, attachments en algunos contextos) están deshabilitadas por la directiva ePrivacy desde el 21/12/2020.
Causas probables
- Destinatario está en la EEA
- Mensaje incluye Personas API
- Adjunto multimedia en hilo restringido
Acción recomendada
Desactiva Personas para usuarios EEA, envía la URL del recurso en vez del attachment, o responde nativamente desde Facebook.
El usuario bloqueó mensajes desde apps
El destinatario desactivó la plataforma de apps en su cuenta o bloqueó la página, por lo que la Send API no puede entregar mensajes.
Causas probables
- Usuario deshabilitó 'Apps, websites and games'
- Usuario bloqueó la página
- Usuario nunca habilitó integración con apps de terceros
Acción recomendada
Responde nativamente desde Facebook Messenger; no hay forma programática de recuperar el envío para este usuario.
Esta persona no está disponible ahora
Mensaje genérico cuando el receptor cerró el chat, bloqueó la página, eliminó su cuenta, o tiene permisos restrictivos que impiden responder vía API.
Causas probables
- Cuenta del usuario desactivada o eliminada
- Usuario bloqueó la página
- Usuario activó 'Solo amigos pueden contactarme'
- Hilo cerrado por el usuario
Acción recomendada
Marca el hilo como inactivo y responde desde la app nativa si necesitas continuar. No reintentes el envío vía API.
Receptor no alcanzable (variante 1545042)
Variante del code 551 con causa equivalente. Documentación oficial es esquiva; se infiere del comportamiento observado.
Causas probables
- Estados transitorios del backend de Messenger
- Misma causa raíz que 1545041 pero con flag distinto
Acción recomendada
Trátalo igual que 551/1545041: hilo no entregable, abandonar reintentos.
Página no suscrita a la app
Tu app no está suscrita a los webhooks de la página objetivo, o se perdió la suscripción tras un cambio de configuración.
Causas probables
- Falta llamar POST /{page-id}/subscribed_apps
- subscribed_fields no incluye 'messages'
- Token de página rotado sin re-suscribir
- App quitada de la página manualmente
Acción recomendada
Re-suscribe la página con subscribed_fields=messages,messaging_postbacks,message_deliveries,message_reads.
Rate limit excedido
Superaste el límite de calls por segundo por página: 300/s para texto/links/stickers, 10/s para audio/video.
Causas probables
- Broadcast masivo sin throttling
- Loop de reintentos descontrolado
- Muchos mensajes a un mismo thread
Acción recomendada
Aplica backoff exponencial y espacia los envíos. Para campañas, usa una cola con concurrencia limitada.
Página bloqueada temporalmente
Meta limita temporalmente páginas con alto volumen saliente desde apps de terceros.
Causas probables
- Volumen anómalo en pocos minutos
- Patrón de envío parecido a spam
- Reportes de usuarios marcando como spam
Acción recomendada
Reduce el ritmo de envío, revisa reportes en Business Manager y espera; suele auto-resolverse en horas.
Fallo temporal al enviar (1200)
Error transitorio del backend de Messenger (API_EC_CHAT_SEND_FAILED). Reintenta con backoff.
Causas probables
- Hiccup interno de Meta
- Sobrecarga momentánea
Acción recomendada
Reintenta con backoff exponencial (1s, 2s, 4s, 8s). Si persiste >5min, escala como incidente.
Mensaje fuera de la ventana de 24h (IG)
Instagram aplica la misma regla de 24h que Messenger. El último mensaje del usuario fue hace más de un día y no estás usando HUMAN_AGENT.
Causas probables
- Usuario sin actividad >24h
- Intento de envío proactivo sin HUMAN_AGENT
- Tag inválido para IG (IG sólo soporta HUMAN_AGENT)
Acción recomendada
Usa el tag HUMAN_AGENT (extiende ventana a 7 días) si tu app lo tiene aprobado, o espera la respuesta del usuario.
Conversación archivada o eliminada
El owner del hilo (la cuenta business) archivó o eliminó la conversación desde la app de Instagram; ya no se puede enviar a ese thread.
Causas probables
- Agente humano eliminó el chat desde la app móvil
- Hilo movido a archivados
Acción recomendada
Restaura la conversación desde la inbox de Instagram, o pide al usuario que vuelva a escribir para recrearla.
Restricción genérica de mensajería IG
Variante reportada cuando el destinatario tiene restricciones (cuenta privada que no te sigue, DMs limitados a seguidores, cuenta menor de edad).
Causas probables
- Usuario activó 'Solo seguidores pueden enviarme mensajes'
- Cuenta del usuario es menor (Instagram Teen Accounts)
- Restricciones regionales
Acción recomendada
No reintentes vía API. Si es crítico, intenta contactar nativamente o por otro canal.
Cuenta IG ya no puede responder a este hilo
La página/cuenta business perdió la capacidad de responder a esta conversación (típicamente el thread cambió de owner o el contacto cambió de tipo de cuenta).
Causas probables
- Usuario cambió de business a personal o viceversa
- Cuenta IG desvinculada de la página Facebook
- Cambio de admin del thread
Acción recomendada
Verifica que la cuenta IG sigue siendo business y está vinculada correctamente a una página Facebook. Re-conecta si es necesario.
Sin permiso para mensajear a este usuario
La cuenta business no tiene permitido iniciar/continuar un DM con este usuario específico (config del usuario, edad, o región).
Causas probables
- Configuración de privacidad del receptor
- Usuario es menor (Teen Accounts)
- Restricciones regulatorias por región
Acción recomendada
No reintentes. Documenta el caso; si afecta a muchos hilos, revisa el segmento de audiencia.
Comentario eliminado por el autor
Estás intentando responder a un comentario que ya fue borrado por su autor o por el owner del post.
Causas probables
- Autor eliminó su comentario
- Página borró el comentario
- Post completo eliminado
Acción recomendada
Marca el item como obsoleto en tu UI; no requiere acción.
Media URI inalcanzable
La URL del media (imagen/video) que pasaste no es alcanzable, está vacía, o no devuelve content-type válido.
Causas probables
- URL caducada (CDN firmada)
- URL apunta a host privado/localhost
- Content-Type incorrecto en el response
- Archivo demasiado grande
Acción recomendada
Verifica que la URL sea pública, HTTPS, y devuelva el media en menos de 8MB para imagen o cumpla los límites de video.
Cuenta Instagram restringida
Instagram aplicó restricciones a la cuenta business (warning interno de la app móvil).
Causas probables
- Reportes de spam acumulados
- Violación de community guidelines
- Login sospechoso reciente
Acción recomendada
El owner debe entrar a la app móvil de Instagram, ver el aviso, y completar los pasos para re-habilitar la cuenta.
Actividad marcada como spam
Instagram detectó patrón de spam y bloqueó la acción específica. Restricción temporal.
Causas probables
- Muchos mensajes idénticos en poco tiempo
- Links sospechosos repetidos
- Patrón de comentarios masivos
Acción recomendada
Reduce volumen, varía el contenido, y espera 24-48h antes de reintentar la operación.
Límite diario de publicación alcanzado
Excediste el límite diario de posts/containers de Instagram (50 publicaciones por 24h rolling).
Causas probables
- Volumen de publicación demasiado alto
- Bot creando containers en loop
Acción recomendada
Espera 24h y prioriza qué publicar. Considera repartir entre múltiples cuentas si tu plan lo permite.
¿Qué hago si mi código no está en la lista?
El catálogo cubre los códigos más frecuentes pero Meta a veces devuelve códigos nuevos sin documentar. Si encontrás un caso así, contactanos desde el panel: incluiremos el código completo (con su body raw) en la próxima actualización de esta guía.
Para diagnosticar mientras tanto, mirá el campo error_user_msg del body raw de Meta — suele estar localizado al idioma de tu cuenta y es más explícito que el message genérico.