meta-whatsapp-cloud-api

¿Qué hace meta-whatsapp-cloud-api?

Este procedimiento se ejecutó por última vez en Meta Business Suite real y la consola de desarrollador el 2026-11-08. Meta cambia estas pantallas, nombres de campos y flujos de asistentes con frecuencia y sin previo aviso; si algún paso a continuación no coincide con lo que ves, abre un issue en este repositorio en lugar de adivinar, y envía un PR con la corrección si la encuentras.

Nunca

• Vuelvas a enviar una verificación rechazada el mismo día en que fue rechazada. Soluciona el problema real, espera 24 horas y luego envía. Los reintentos del mismo día tienden a ser marcados para una revisión aún más larga.
• Adivines o "limpies" el nombre legal, la dirección o el número de teléfono ingresados en la información empresarial. Cópialos carácter por carácter del documento que se cargará para probarlos.
• Trates un estado pending de larga duración como "Meta solo es lento" sin volver a verificar el campo de estado real (consulta la §2). Puede convertirse silenciosamente en "necesita más información" y el correo de notificación tiende a llegar a una bandeja de entrada que nadie revisa activamente.
• Ofrezcas un certificado de registro fiscal de autónomo como prueba del nombre legal o la dirección, si el equivalente de la jurisdicción local no está en la lista de documentos aceptados de Meta para ese propósito; consulta el ejemplo práctico en la §1. Meta indica claramente cuándo un documento "no es un tipo aceptado"; lee ese mensaje en lugar de asumir que un documento local conocido será aceptado porque es oficial.
• Envíes con el nombre legal de la empresa ausente de la página de inicio real del sitio web. Meta obtiene /, no una página "Acerca de" o "Términos", y falla la verificación específicamente por esto si el nombre no está allí.
• Añadas colaboradores externos como usuarios completos del portafolio solo para obtener ayuda con una tarea. Esa es una razón de rechazo explícita en la propia lista de Meta; en su lugar, usa un nivel de acceso de socio/colaborador más restringido.
• Escribas un código de verificación, un PIN de dos pasos o cualquier contraseña en algo que no sea la propia consola de Meta, escrito por el titular de la cuenta.

1. Verificación empresarial

Qué es y qué no es la verificación

La verificación empresarial en Meta Business Suite es algo diferente de la suscripción paga de Meta Verified y no produce una insignia verificada. Meta lo indica directamente: "Verificar tu empresa en Meta Business Suite es diferente de Meta Verified para empresas y no te dará una insignia verificada." (Centro de ayuda de Meta Business, "Cómo verificar tu empresa en Meta Business Suite", https://www.facebook.com/business/help/2058515294227817, consultado el 2026-11-09 — la misma frase se repite en https://www.facebook.com/business/help/2342133782492969, consultado el 2026-11-09). La insignia verificada es específicamente un beneficio de Meta Verified: "Meta Verified para empresas es una suscripción paga que proporciona herramientas para ayudarte a generar más confianza con nuevas audiencias y proteger tu marca. Esta suscripción viene con beneficios como la insignia verificada, soporte mejorado, protección contra suplantación y más." (https://www.facebook.com/business/help/308979828303560, consultado el 2026-11-09). Meta Verified se factura periódicamente y es una compra separada del procedimiento de verificación gratuito que cubre esta habilidad.

Lo que la verificación empresarial realmente desbloquea, en palabras de Meta: "Se requiere la verificación empresarial para acceder a ciertas funciones de publicidad, desarrollador, facturación y gasto." (https://www.facebook.com/business/help/2058515294227817, consultado el 2026-11-09). Ampliado en https://www.facebook.com/business/help/1095661473946872 (consultado el 2026-11-09): el límite de gasto diario, las funciones elegibles para desarrolladores, el acceso a Meta Business Partners, el índice de Páginas de Noticias, la Plataforma WhatsApp Business, la transparencia de Páginas, las agencias con sede en China y el estado de anunciante de servicios financieros. Para la Plataforma WhatsApp Business específicamente, la misma página dice: "Es posible que las empresas que utilizan la Plataforma WhatsApp Business deban completar la verificación para acceder a ciertas funciones." En el lado del desarrollador: "El Acceso Avanzado ahora requiere la Verificación Empresarial... Las aplicaciones que solicitan acceso avanzado para permisos y las aplicaciones que permiten que otras empresas accedan a sus propios datos deben estar conectadas a una empresa que haya completado la Verificación Empresarial." (https://developers.facebook.com/docs/development/release/business-verification/, consultado el 2026-11-09).

Verificado y no encontrado en ninguna de las páginas anteriores, ni en la página de escalado de cuentas de WhatsApp de Meta (https://www.facebook.com/business/help/595597942906808, consultado el 2026-11-09): cualquier declaración de Meta sobre cuántas veces volver a enviar antes de detenerse, o consejos para corregir documentos desde la raíz en lugar de volver a enviar. Ese consejo es común en los blogs de agencias externas, pero Meta no lo dice en ningún lugar verificado para esta habilidad, por lo que no se repite aquí como un hecho. La lista de "Nunca" a continuación se limita a lo que las páginas propias de Meta respaldan: una regla de tiempo, no un conteo.

Elegir el conjunto de documentos correcto

Las categorías de documentos aceptados por Meta (leídas directamente de su cuadro de diálogo "Detalles y próximos pasos", que solo aparece una vez que se ha ejecutado un intento de verificación):

Prueba	Tipos aceptados
Nombre legal de la empresa	Certificado/Estatutos de Constitución, una licencia o permiso comercial, un extracto bancario o una carta bancaria
Dirección	Los mismos cuatro, más una factura de servicios públicos: agua, gas, electricidad o teléfono

Para una empresa registrada, el certificado de constitución suele ser el documento único más limpio. Para un autónomo sin registro de empresa, a menudo no existe un equivalente exacto; no asumas que el certificado de registro fiscal genérico para pequeñas empresas de una jurisdicción cuenta, aunque parezca el documento obvio. Ejemplo práctico (Israel): el certificado עוסק פטור/עוסק מורשה de un autónomo israelí es rechazado explícitamente por Meta ("no es un tipo aceptado"), aunque sea la prueba estándar del estado comercial legal en Israel. Lo que funcionó en su lugar fue una carta de titularidad de cuenta bancaria para el nombre legal (la mayoría de los bancos pueden emitir una a petición, específicamente para verificación empresarial) más una factura de servicios públicos para la dirección: un documento de cada una de las dos categorías aceptadas, cada uno imprimiendo el nombre o la dirección exactamente como se ingresó en la información empresarial.

Reglas generales que se aplican independientemente de la jurisdicción:

• Un solo documento que contenga tanto el nombre como la dirección en su totalidad, de forma clara, satisface ambos requisitos en una sola carga.
• El hebreo, o cualquier escritura que no sea inglés, se acepta tal cual (no se requiere traducción), pero elige un idioma para el nombre/dirección y úsalo de manera consistente en la información empresarial, la página de inicio del sitio web y los propios documentos.
• Rechaza, sin intentarlo: contratos de arrendamiento, una factura personal (no comercial), una captura de pantalla de una página de portal, cualquier cosa recortada, anotada o editada de otro modo, y cualquier documento de más de unos 90 días, excepto los documentos de registro formales.
• Una representación fiel de página completa de un formato de archivo a otro (por ejemplo, PDF a PNG de alta resolución) está bien; recortar o volver a escribir cualquier parte no lo está.

Preparar el portafolio antes de enviar

• Los campos de información empresarial deben reflejar exactamente el documento cargado, incluidos la puntuación y los sufijos legales (un sufijo de empresa como "Ltda." aparece en ambos lugares o en ninguno). Decide qué idioma estandarizar y úsalo en todas partes.
• El sitio web debe ser accesible, servir HTTPS, no mostrar ningún error o estado "en construcción" en ninguna página y (esto se verifica por separado y falla independientemente de la accesibilidad) mostrar el nombre legal exacto en la página de inicio específicamente. Un dominio registrado muy recientemente también tiene más probabilidades de generar sospechas; un dominio con cierta antigüedad funciona mejor.
• El correo electrónico de la empresa debe estar en el mismo dominio que el sitio web. Un dominio de correo electrónico de consumo gratuito aumenta mediblemente la tasa de rechazo y ralentiza la revisión cuando no lo hace.
• Elige una categoría de listado que coincida honestamente con la empresa: una categoría sensible (finanzas, salud, juegos de azar, alcohol) invita a un escrutinio adicional y documentos requeridos adicionales.
• Dos administradores en el portafolio con autenticación de dos factores habilitada en ambos tiende a reducir la fricción; un administrador solitario sin protección es en sí mismo un desencadenante de rechazo.
• Cualquier activo que necesite verificación (generalmente una WABA) ya debe estar adjunto al portafolio antes de comenzar; de lo contrario, el punto de entrada de verificación en sí mismo aparece atenuado como "no elegible".

Si el sitio web sigue fallando su propia verificación incluso después de solucionar lo anterior, Meta documenta dos formas alternativas de confirmar la identidad de la empresa en lugar de un sitio web funcional: un correo electrónico de confirmación en un dominio diferente genuinamente asociado con la empresa, o confirmar mediante el número de teléfono de la empresa.

El canal de confirmación cambia qué documentos necesitas

El canal de confirmación elegido durante el asistente cambia lo que realmente solicita el paso de carga:

• Llamada telefónica, SMS o mensaje de WhatsApp como canal → el asistente entonces solicita documentos que prueben el nombre legal y un número de teléfono.
• Correo electrónico como canal → el asistente solicita documentos que prueben el nombre legal y una dirección o número de teléfono.

Así que elige el canal para que coincida con los documentos que realmente son más fáciles de obtener, no al revés: si una carta bancaria y una factura de servicios públicos están disponibles, elige correo electrónico.

Envío

Ve al punto de entrada de verificación (Centro de seguridad, en el diseño actual de Meta), elige el caso de uso que coincida con lo que se está verificando (generalmente hay una opción separada específicamente para configurar una cuenta de WhatsApp Business; prefiere esa sobre una opción genérica de "permisos de aplicación" si ambas existen), y recorre el asistente: país, tipo de empresa (un autónomo no registrado suele ser "Autónomo" y, a menudo, se responde como "Registrado" si la autoridad fiscal local le ha emitido algún número de registro, incluso sin una empresa formal), detalles de la empresa, un CAPTCHA (siempre completado por un humano, nunca por un agente automatizado), un paso de coincidencia de registros públicos, el canal de confirmación, la carga de documentos y una revisión/envío final.

Dos trampas que vale la pena esperar en ese paso de registros públicos y el paso de carga:

• Meta puede ofrecer una coincidencia de registros públicos que parezca plausible pero que pertenezca a una entidad diferente y no relacionada con un nombre similar. Verifica cada detalle de identificación (dirección, dominio, cualquier número de impuesto o registro mostrado) antes de aceptar una coincidencia: reclamar el registro comercial de otra persona es una violación de la política que puede restringir todo el portafolio, no solo fallar esta verificación. En caso de duda, elige "mi empresa no está listada".
• Algunos pasos de carga de documentos tienen un interruptor fácil de pasar por alto ("¿su documento incluía su número de teléfono o dirección?") predeterminado en "No", lo que luego exige un segundo documento completamente separado que la mayoría de los solicitantes no tienen a mano. Si el documento único ya cargado contiene ambas piezas de información, cambia ese interruptor a "Sí" y el paso adicional desaparece.

Después de enviar, espera aproximadamente de 1 a 2 días hábiles para un envío verificado por canal y de 3 a 7 (hasta 14 durante las ventanas de actualización periódica de políticas de Meta) para uno basado en documentos. No toques el envío mientras esté "pendiente": no agregues administradores, no cambies la configuración ni abras un hilo de soporte por capricho; nada de eso acelera una revisión en cola y cualquier cosa que cree una discrepancia con lo que se envió solo puede perjudicar.

Vigilar "necesita más información" sin depender del correo electrónico

La notificación de Meta sobre un cambio de estado se envía a la dirección de correo electrónico configurada como contacto de administrador del portafolio, que muy a menudo no es la bandeja de entrada que alguien revisa a diario. La única forma confiable y sin navegador de verificarlo es una llamada directa a la API una vez que exista algún acceso a la API:

curl -s "https://graph.facebook.com/v21.0/$WABA_ID?fields=business_verification_status" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Valores vistos en la práctica: pending (turno de Meta, no hay nada que hacer más que esperar), pending_need_more_info (tu turno: ve a leer exactamente lo que se solicita en la consola, que este campo solo no dice), y verified. Consulta esto periódicamente en lugar de esperar a que te lo digan: la brecha entre que un estado cambie silenciosamente a "necesita más información" y que alguien realmente lo note ha costado envíos reales un ciclo de revisión completo.

2. Activación de la Cloud API (funciona incluso antes de que llegue la verificación)

Cada paso a continuación funciona en un portafolio no verificado; la verificación solo cambia el límite de volumen de mensajes, no si la API en sí funciona. Actívalos en paralelo en lugar de esperar a uno antes de comenzar el otro. Ya debe existir un portafolio empresarial (creado en business.facebook.com) antes del paso 1: el paso a continuación adjunta una nueva aplicación a ese portafolio existente, no crea uno nuevo.

1. Crea la aplicación. En la consola de desarrollador, crea una aplicación usando el caso de uso centrado en WhatsApp ("conéctate con los clientes a través de WhatsApp", o el equivalente en la consola actual) y adjúntala al portafolio empresarial existente; nunca crees un nuevo portafolio para esto, lo que reiniciaría la verificación desde cero.
2. Adjunta o crea una Cuenta de WhatsApp Business (WABA). El panel de configuración de WhatsApp de la aplicación se conecta a una WABA existente o crea una. Registra el ID de la WABA y el ID del número de teléfono de prueba en algún lugar duradero.
3. Prueba primero el número de prueba emitido por Meta. Es gratuito durante un período de prueba limitado, admite un puñado de números de destinatarios preaprobados (cada uno necesita un código único para incluirlos en la lista blanca) y es la forma más rápida de probar que el webhook y el código de envío de mensajes funcionan antes de que un SIM real esté involucrado.
4. Genera un token de acceso de usuario del sistema, no un token de usuario temporal. Un usuario del sistema con el rol adecuado, asignado a la aplicación con acceso de gestión, puede generar un token sin caducidad; los permisos necesarios son generalmente los ámbitos de mensajería y gestión de WABA; también se necesita un ámbito de gestión empresarial más amplio si la integración alguna vez leerá el estado de verificación o eliminará una WABA a través de la API en lugar de la consola. Los tokens temporales de inicio rápido...

... [truncado para traducción]