Cómo configurar la API de WhatsApp Business paso a paso
Cómo configurar la API de WhatsApp Business paso a paso: portfolio de Meta, verificación, número, nombre visible, Embedded Signup, plantillas y puesta en marcha.
Por OmniChannels.ai Editorial Team · Revisado por BroadNet Messaging Solutions Team
Respuesta breve
Para configurar la API de WhatsApp Business, cree o utilice un portfolio comercial de Meta, complete la verificación de la empresa, elija un número que pueda recibir un SMS o una llamada de voz y que no esté activo en WhatsApp, escoja un nombre visible acorde con su marca, conéctese mediante el registro integrado (Embedded Signup) de su proveedor, añada un método de pago, registre el número con un PIN de verificación en dos pasos y envíe a aprobación sus primeras plantillas de mensaje antes de salir en producción.
En esta página
Puntos clave
- Según Meta, el número de teléfono de empresa para la API debe ser de su propiedad, incluir prefijo de país y de zona, y poder recibir un SMS o una llamada de voz; no se admiten códigos cortos.
- Los números que ya se usan en WhatsApp deben eliminarse de la app antes del registro, salvo que se utilice la opción de coexistencia de Meta para números elegibles de la app Business.
- Embedded Signup permite crear o seleccionar un portfolio comercial, una cuenta de WhatsApp Business y un número de teléfono dentro de la plataforma de un proveedor.
- La verificación de la empresa aumenta el número de teléfonos que puede registrar y es una de las vías para alcanzar límites de mensajería más altos.
- La aprobación de plantillas, un método de pago válido y un PIN de verificación en dos pasos son los bloqueos habituales antes de salir en producción.
Esta guía está dirigida al responsable de marketing, de experiencia de cliente o de TI que debe poner en marcha una empresa en la API de WhatsApp Business. Recorre en orden cada paso de la activación, explica qué comprueba Meta en cada etapa y termina con una lista de verificación previa a la puesta en marcha y los errores que más se repiten.
¿Qué necesita antes de empezar?
Tenga preparados cuatro elementos: acceso de administrador al portfolio comercial de Meta de su compañía, los documentos de su empresa, un número de teléfono dedicado y un nombre de marca que los clientes reconozcan. La mayoría de los retrasos se deben a que falta alguno de ellos.
| Elemento | Requisito | Por qué importa |
|---|---|---|
| Portfolio empresarial de Meta | Acceso de administrador; razón social y dirección completadas | Es el propietario de la cuenta de WhatsApp Business (WABA) |
| Documentos de la empresa | Licencia comercial o registro mercantil, justificante de domicilio | Necesarios para la verificación de la empresa |
| Sitio web | En un dominio que usted controle y que muestre el nombre de su empresa | Respalda la verificación y la revisión del nombre visible |
| Número de teléfono | De su propiedad, con prefijo de país y de zona, capaz de recibir un SMS o una llamada de voz | Necesario para el registro; no se admiten números cortos |
| Nombre visible | Coincide con su marca y su sitio web | Aparece en su perfil de WhatsApp; lo revisa Meta |
| Método de pago | Tarjeta o línea de crédito del proveedor | Necesario para enviar plantillas de pago |
| Proceso de consentimiento (opt-in) | Consentimiento claro de los clientes para recibir mensajes de WhatsApp | Exigido por la política de WhatsApp |
¿Cómo se configura la API de WhatsApp Business paso a paso?
Siga estos pasos en orden. Si se activa a través de un proveedor, los pasos 3 a 6 suelen realizarse dentro de su flujo de Embedded Signup.
Paso 1: prepare su portfolio comercial de Meta
Inicie sesión en Meta Business Suite con una cuenta personal de Facebook que sea administradora del portfolio comercial de la compañía, o cree un portfolio. Use exactamente la razón social y la dirección que figuran en sus documentos. Añada al menos dos administradores para no perder el acceso si una persona se va.
Paso 2: inicie la verificación de la empresa
En el Centro de seguridad de su portfolio comercial, inicie la verificación de la empresa. Meta pide documentos que confirmen la razón social, la dirección y el teléfono o el email, y puede verificar mediante un código o una comprobación del dominio. Los requisitos difieren según el país y cambian con el tiempo, así que siga las indicaciones en pantalla.
Puede comenzar la activación antes de que termine la verificación, pero Meta aplica límites más bajos hasta entonces: los portfolios nuevos empiezan con dos números de teléfono registrados y un límite de mensajería de 250 usuarios únicos fuera de la ventana de atención al cliente, según la documentación de Meta.
Paso 3: elija el número de teléfono
Elija un número que vaya a seguir con la empresa durante años, como una línea fija o una línea móvil dedicada. Meta exige que el número:
- sea de su propiedad e incluya prefijo de país y de zona;
- pueda recibir un SMS o una llamada de voz para la verificación;
- no sea un código corto;
- no esté registrado actualmente en WhatsApp, salvo que utilice la opción de coexistencia de Meta para un número elegible de la app WhatsApp Business.
Si el número está en WhatsApp o en la app WhatsApp Business y no quiere usar la coexistencia, haga una copia de lo que necesite y elimine primero la cuenta de la app.
Paso 4: elija su nombre visible
El nombre visible aparece en su perfil de WhatsApp. Use la marca que conocen sus clientes, de forma coherente con su sitio web y los documentos de su empresa. Evite nombres genéricos («Best Deals»), mayúsculas inusuales o añadir eslóganes. Meta revisa el nombre; su estado aparece en WhatsApp Manager como pendiente, aprobado o rechazado.
Paso 5: conéctese mediante Embedded Signup
Embedded Signup es el flujo de Meta que los proveedores integran en su plataforma. Usted inicia sesión con Facebook, selecciona o crea el portfolio comercial, crea o selecciona una cuenta de WhatsApp Business, introduce el número de teléfono y el nombre visible, y verifica el número con un código recibido por SMS o llamada de voz. Al final, el proveedor recibe permiso para gestionar la WABA en su nombre, mientras que su portfolio conserva la propiedad.
Paso 6: registre el número y defina un PIN en dos pasos
El número debe registrarse para la API Cloud con un PIN de verificación en dos pasos de seis dígitos. Su proveedor suele hacerlo como parte de la activación. Guarde el PIN de forma segura: se necesita para cambiarlo o para eliminar el número más adelante.
Paso 7: añada un método de pago
Meta cobra por cada plantilla de mensaje entregada, según la categoría y el país del destinatario. Añada una tarjeta a la WABA en WhatsApp Manager o confirme que la línea de crédito de su proveedor cubre su cuenta. Sin una facturación válida, los envíos de plantillas fallan.
Paso 8: cree sus primeras plantillas
Fuera de la ventana de atención al cliente de 24 horas, solo puede enviar plantillas aprobadas. Empiece con tres a cinco que necesite desde el primer día:
- Una plantilla de utilidad para la confirmación de pedido o reserva.
- Una plantilla de utilidad para una actualización de estado, como una entrega o un recordatorio.
- Una plantilla de autenticación si envía contraseñas de un solo uso.
- Una plantilla de marketing para su primera campaña con clientes que han dado su consentimiento.
Use variables para los nombres y los números de pedido, mantenga el lenguaje promocional fuera de las plantillas de utilidad y cree versiones en árabe e inglés como idiomas distintos de la misma plantilla si atiende a clientes del Golfo.
Ejemplo práctico: un instituto de formación de Doha sale en producción
«Al Fanar Academy» (ejemplo ficticio) quiere usar WhatsApp para consultas sobre cursos y recordatorios de clases.
- Semana 1: la responsable de operaciones confirma el acceso de administrador al portfolio comercial, sube el registro mercantil e inicia la verificación. La academia elige su línea fija principal, que puede recibir una llamada de voz.
- Activación: mediante el Embedded Signup del proveedor, crea una WABA, introduce el nombre visible «Al Fanar Academy» y verifica el número por llamada de voz.
- Plantillas: envía un recordatorio de clase (utilidad), una confirmación de matrícula (utilidad) y un anuncio del nuevo trimestre (marketing), en árabe e inglés. La plantilla de marketing se rechaza por una llamada a la acción vaga y se aprueba tras reescribirla.
- Puesta en marcha: envía recordatorios a los estudiantes que dieron su consentimiento en el formulario de matrícula y enruta las respuestas a la bandeja del equipo de admisiones.
El paso más largo fue la verificación, no la configuración técnica.
Lista de verificación previa a la puesta en marcha
Marque cada punto antes de su primera campaña.
- Verificación de la empresa enviada o aprobada.
- Nombre visible aprobado.
- Número de teléfono registrado y PIN en dos pasos guardado de forma segura.
- Método de pago válido y con fondos.
- Plantillas necesarias aprobadas en todos los idiomas que precise.
- Consentimiento registrado para cada contacto al que vaya a escribir.
- Bandeja configurada, con agentes asignados para responder a los mensajes entrantes.
- Mensajes de prueba enviados a números internos y revisados en Android e iOS.
- Informes de entrega revisados para los envíos de prueba.
- Volumen de envío planificado dentro de su límite de mensajería actual.
¿Cuáles son los errores de configuración más habituales?
La mayoría de los errores siguen unos pocos patrones. La documentación de Meta sobre códigos de error los enumera; estos son los que más ven los equipos de activación.
| Código de error | Significado (según Meta) | Solución habitual |
|---|---|---|
| 133010 | Número de teléfono no registrado | Completar el registro con el PIN en dos pasos |
| 131047 | Ventana de atención al cliente cerrada | Enviar una plantilla aprobada en lugar de texto libre |
| 132001 | La plantilla no existe en ese idioma o no está aprobada | Comprobar el nombre de la plantilla, el código de idioma y el estado de aprobación |
| 132012 | Los valores de las variables no coinciden con el formato de la plantilla | Ajustar el número y el formato de las variables |
| 131042 | Problema con el método de pago | Corregir la tarjeta o la línea de crédito de la WABA |
| 131026 | Mensaje no entregable | Puede que el destinatario no use WhatsApp o tenga una app desactualizada; usar otro canal |
| 131049 | Mensaje retenido por la salud del ecosistema | A menudo por frecuencia de marketing; esperar antes de reenviar y revisar la segmentación |
| 368 | Cuenta restringida por infracción de la política | Revisar los avisos de política en WhatsApp Manager y apelar si procede |
Otros problemas frecuentes no son códigos de error: un número todavía activo en la app de WhatsApp, un nombre visible que no coincide con el sitio web y administradores sin control total del portfolio.
Cómo ayuda OmniChannels.ai
OmniChannels.ai, con la tecnología de BroadNet Technologies, activa los números de la API de WhatsApp Business mediante el registro integrado de Meta (Embedded Signup), de modo que su portfolio comercial conserva la propiedad de la WABA. Puede crear plantillas de marketing, utilidad y autenticación, incluidas contraseñas OTP de un toque, de cero toques y de copiar código, con variables, archivos multimedia y botones, y revisarlas en una vista previa en teléfono y seguir su aprobación. Una vez en marcha, las campañas admiten carga de Excel/CSV, vista previa, programación y filtrado de duplicados, con informes de entrega de cada envío. Se admiten árabe e inglés. Consulte la página de la API de WhatsApp Business y las campañas, o reserve una demostración.
Preguntas frecuentes
¿Puedo usar mi número de WhatsApp actual para la API?
Sí, con condiciones. Meta indica que los números que ya se usan en WhatsApp deben eliminarse de la app antes de registrarlos en la API. Para los números elegibles de la app WhatsApp Business, Meta ofrece además durante el Embedded Signup una opción de coexistencia que mantiene la app funcionando con el mismo número. Compruebe la elegibilidad en su mercado antes de decidir.
¿Es obligatoria la verificación de empresa de Meta?
Puede empezar a enviar antes de verificar, pero con límites más bajos. Según Meta, los portfolios nuevos empiezan con dos números registrados y un límite de mensajería de 250 usuarios únicos fuera de la ventana de servicio; verificar la empresa es una forma de elevar el tope de números y de optar a un límite de mensajería mayor. La mayoría de las empresas en crecimiento deberían verificar pronto.
¿Qué documentos necesito para la verificación de empresa?
Meta suele pedir documentos que acrediten la razón social, la dirección y el teléfono de la empresa, como una licencia comercial, un registro mercantil o una factura de suministros, además de un sitio web en un dominio que usted controle. Los requisitos varían según el país y cambian con el tiempo, así que siga las indicaciones del Centro de seguridad de Meta Business Suite para su portfolio.
¿Por qué rechazaron mi nombre visible?
Los nombres visibles se rechazan normalmente cuando no guardan una relación clara con la empresa, usan solo términos genéricos, abusan de mayúsculas o signos de puntuación, o no pueden vincularse con su sitio web o con la empresa verificada. Use la marca que conocen sus clientes, asegúrese de que su sitio web la muestre y vuelva a enviarlo con una imagen de marca coherente.
¿Necesito un desarrollador para configurar la API de WhatsApp Business?
No, cuando un proveedor ofrece Embedded Signup y una plataforma lista para usar con bandeja de entrada, plantillas y campañas. Hace falta un desarrollador si quiere llamar a la API directamente, recibir webhooks en sus propios sistemas o integrar WhatsApp con su CRM o con su plataforma de pedidos.
Fuentes
Siga leyendo
Más guíasWhatsApp
Enlaces click-to-chat y códigos QR de WhatsApp: guía práctica
Cómo crear enlaces wa.me con mensaje prefijado, generar códigos QR de WhatsApp para impresos, embalajes y tiendas, y saber qué ubicación inició cada chat.
8 min de lectura
WhatsApp
Botones y listas de WhatsApp: qué mensaje interactivo usar
Botones de respuesta, listas, botones CTA URL, carruseles y mensajes de producto en WhatsApp: cuándo usar cada uno, límites de Meta, buenas prácticas y casos.
8 min de lectura
Marketing
WhatsApp para ecommerce: pedidos, carritos y contra reembolso
Guía de WhatsApp para ecommerce: avisos de pedido, carrito abandonado, vuelta a stock, catálogos y confirmación contra reembolso, con plantillas y categorías.
8 min de lectura
