Checklist antes de conectar la API de WhatsApp: portafolio, nombre y pago
Lo que debes tener listo antes de conectar la API de WhatsApp: portafolio verificado, nombre para mostrar aprobado, método de pago y número limpio.
En este artículo
La mayoría de los problemas "de la API" que llegan a soporte no son de la API. Son de lo que había (o no había) antes de conectar. Un canal creado dentro de un portafolio de Meta recién abierto y sin verificar no envía nada; un método de pago que falla deja la cuenta bloqueada; un nombre para mostrar sin aprobar te condena al nivel más bajo de mensajes. Este checklist antes de conectar la API de WhatsApp existe para que ninguna de esas tres cosas te pase el día del lanzamiento.
Está armado a partir de casos reales: negocios que conectaron un viernes, mandaron la primera campaña y vieron cómo cada mensaje pasaba de "enviado" a "fallido" sin explicación. En todos, la causa estaba en la lista de abajo y se resolvía en el portafolio, no en la plataforma.
Por qué el portafolio es lo primero
En la Cloud API el número no pertenece a un teléfono; pertenece a un portafolio empresarial de Meta (antes "Business Manager"). Ese portafolio es la identidad legal que Meta evalúa. Si es nuevo, sin historial y sin verificar, Meta lo trata con la máxima desconfianza: puede bloquear la cuenta de WhatsApp Business desde el primer minuto, y el error que verás es el 131031 (Business Account locked) en el estado de los mensajes.
Tienes dos caminos:
- Verificar el portafolio antes de conectar. Requiere documentos de la empresa (registro, RUC/RFC/NIT o equivalente, comprobante de domicilio) y que el nombre coincida con el sitio web y el dominio de correo.
- Usar un portafolio que ya esté verificado. Si tu empresa ya tiene uno para anuncios de Facebook o Instagram, crea el canal ahí. Es la vía más rápida y la que menos sorpresas da.
Crear un portafolio nuevo "solo para WhatsApp" el mismo día del lanzamiento es el error más común y el más caro.
El checklist completo
Recorre estos ocho puntos en orden. Ninguno toma más de un rato, y juntos evitan casi todos los tropiezos del primer mes.
- Portafolio de Meta verificado (o acceso a uno que ya lo esté). Confirma en la configuración del portafolio que la verificación de empresa aparece como completada.
- Nombre para mostrar coherente con la marca. Debe corresponder al nombre real del negocio, tal como aparece en tu web y redes, sin descripciones tipo "Ofertas Zapatos 2x1". Si Meta no lo aprueba, el número queda en el nivel de 250 conversaciones iniciadas por la empresa cada 24 horas.
- Método de pago válido en el portafolio. Una tarjeta que rechaza el primer cargo bloquea la cuenta (error 141006). Usa una tarjeta empresarial con cupo y avisa a tu banco.
- Número sin bloqueos previos. Un número que estuvo restringido en la app arrastra historial. Si tienes dudas, empieza con uno limpio o con el número que menos incidentes haya tenido.
- Verificación en dos pasos (2FA) del número. Necesitas el PIN de seis dígitos para registrar el número en la API; si lo olvidaste, recupéralo antes, no durante la conexión.
- Decidir coexistencia o migración. Coexistencia: el número sigue en la app del celular y en la API a la vez, con hasta seis meses de historial importado. Migración: el número pasa al 100 % a la API y deja de usarse en la app (obligatorio si quieres llamadas de WhatsApp dentro de la plataforma). Si vas a coexistencia, ten el celular con la app a mano para escanear el QR que muestra Meta.
- Acceso de administrador al portafolio para la persona que va a conectar. Los permisos parciales producen errores confusos a mitad del flujo.
- Sitio web y correo con el dominio de la empresa. No son obligatorios para conectar, pero aceleran la verificación y la aprobación del nombre.
Síntoma, causa y solución
Cuando algo falla después de conectar, esta tabla resuelve la mayoría de los casos en minutos.
| Síntoma | Causa habitual | Solución |
|---|---|---|
| Los mensajes pasan de "enviado" a "fallido" con 131031 | Portafolio nuevo sin verificar o cuenta bloqueada por política | Verificar el portafolio o mover el canal a uno verificado; revisar avisos en el portafolio |
| Error 141006 al enviar | Método de pago rechazado o ausente | Agregar una tarjeta válida al portafolio y reintentar |
| Error 141010 | Empresa sin verificar en Meta | Completar la verificación de empresa |
| No puedo iniciar más de 250 conversaciones al día | Nombre para mostrar no aprobado | Corregir el nombre según la marca real y volver a solicitar |
| Error 190 en todos los envíos | Token expirado o permisos revocados | Reconectar el canal desde la plataforma |
| Error 131009 en una plantilla | Parámetros que no coinciden con la plantilla aprobada | Revisar variables y formato |
| El QR de coexistencia no se completa | Sin 2FA o app desactualizada en el celular | Actualizar la app, tener el PIN listo, repetir el pareo |
Para el resto de códigos, y para entender por qué el 131031 llega en el webhook de estado y no en la respuesta del envío, tienes la guía de errores de la API de WhatsApp: 131031, 131047 y 130429.
El nombre para mostrar: el punto que más se subestima
Meta aprueba el nombre para mostrar comparándolo con la identidad del portafolio y con lo que un cliente esperaría ver. Lo rechaza cuando:
- Incluye términos promocionales o genéricos ("Promos", "Ofertas", "Ventas").
- No coincide con el nombre del sitio web ni con el del portafolio.
- Usa mayúsculas, emojis o signos de puntuación decorativos.
- Corresponde a una marca de la que no puedes demostrar uso.
Mientras el nombre no esté aprobado, el número funciona pero queda en 250 conversaciones iniciadas por la empresa cada 24 horas. Para una tienda que quiere mandar su primera campaña a 2.000 contactos, ese techo se siente el primer día. Cómo se sube de nivel y cómo planificar en función de esos límites lo tratamos en límites de mensajes de marketing en WhatsApp 2026.
Un primer mensaje que no debería fallar
Cuando la lista está completa, la prueba más útil es enviar una plantilla de utilidad a un número propio y ver el estado cambiar a "entregado" y "leído". Algo tan simple como esto:
Hola {{1}}, tu pedido {{2}} fue confirmado y sale hoy desde nuestra bodega.
Te avisamos por aquí cuando esté en camino. Gracias por comprar en Casa Verde.
Si ese mensaje se entrega, el portafolio, el pago, el token y el número están bien. Si se queda en "enviado" y luego pasa a "fallido", vuelve a la tabla: la causa está ahí.
Qué revisar el primer día después de conectar
Con el canal activo, dedica media hora a estas comprobaciones:
- Que la salud del canal en la plataforma muestre calidad, estado del número y nivel de mensajería sin alertas.
- Que el equipo tenga usuarios propios y la asignación automática esté configurada; no repitas el modelo de "todos en el mismo celular".
- Que el agente de IA, si lo activaste, responda desde tu base de conocimiento y traspase a un asesor cuando corresponde.
- Que la primera plantilla de utilidad esté aprobada antes de que la necesites (confirmación de pedido o recordatorio de cita).
Con Omnifox estos datos aparecen en la pantalla de salud del canal, y como Omnifox es socio tecnológico de Meta, el flujo de conexión es el mismo que Meta muestra en sus propias pantallas.
Preguntas frecuentes
¿Puedo conectar la API sin verificar el portafolio de Meta?
Técnicamente puedes crear el canal, pero un portafolio nuevo sin verificar suele quedar bloqueado desde el inicio y los mensajes fallan con el error 131031. Verifica antes o usa un portafolio ya verificado.
¿Qué pasa si mi nombre para mostrar no es aprobado?
El número funciona, pero queda limitado a 250 conversaciones iniciadas por la empresa cada 24 horas. Corrige el nombre para que coincida con tu marca real y vuelve a solicitar la aprobación.
¿Necesito una tarjeta de crédito para conectar la API?
Necesitas un método de pago válido en el portafolio para que Meta cobre las conversaciones. Si el cargo es rechazado, la cuenta se bloquea (error 141006) hasta que corrijas el pago.
¿Debo elegir coexistencia o migración antes de conectar?
Sí, porque el flujo es distinto. Coexistencia conserva la app del celular e importa hasta seis meses de historial; migración deja el número solo en la API y es necesaria para atender llamadas de WhatsApp dentro de la plataforma.
Media hora de preparación, un mes sin sorpresas
Verificar el portafolio, cuidar el nombre para mostrar, poner una tarjeta que no falle y llegar con el número limpio y su PIN a mano: eso es todo. Con esa base, conectar el número toma minutos y la primera campaña sale como debe. Revisa la página de WhatsApp Business API o empieza ya con la prueba gratis de 7 días de Omnifox.
¿Listo para probarlo en tu negocio?
Reúne WhatsApp, Instagram, Messenger, email y llamadas en una sola bandeja, y deja que la IA dé la primera respuesta. Configúralo hoy mismo.
7 días gratis. Sin tarjeta de crédito.
Leer más
-

Convertí una conversación en tarjeta de tablero automáticamente
-

Agendar videollamadas con un agente de IA desde WhatsApp: cómo funciona
-

Qué es el ticket medio y 8 formas prácticas de aumentarlo
-
Protección de datos personales en Argentina y WhatsApp: qué debe cumplir tu empresa
-

Cómo darle personalidad y tono a un agente de IA
-
Cobranzas por WhatsApp en Chile: recuperar cartera sin romper la relación con el cliente
-
Software de WhatsApp para pymes en Guatemala: qué necesitas y qué no
-

Qué es un CTA (llamada a la acción) y cómo escribir uno que convierta
Comentarios (0)
Todavía no hay comentarios. Sé el primero en compartir tu opinión.
Deja un comentario
Tu email nunca se publica. Los comentarios se moderan antes de aparecer.