API de WhatsApp Business #

Conecte su empresa a WhatsApp a través de la API oficial de WhatsApp Business. Este canal es la opción recomendada para empresas que necesitan mensajería de WhatsApp confiable y de alto volumen con plantillas de mensajes preaprobadas y seguimiento de entrega.

No se necesita una cuenta de Twilio independiente. Twilio es el servicio de telefonía y mensajería que entrega sus mensajes de WhatsApp en segundo plano. La plataforma crea una cuenta de Twilio administrada para usted internamente, por lo que no necesita registrarse en Twilio usted mismo ni conectarlo a Meta manualmente. La compra de un número o la conexión de uno existente se realiza completamente dentro de la aplicación. Si necesita específicamente traer su propia cuenta de Twilio (por ejemplo, si ya tiene números con historial y plantillas aprobadas allí), abra la tarjeta Cuenta de Twilio en la página Canales y cambie a su propia cuenta, luego adjunte su remitente existente; ambos pasos se encuentran en Proveedor de SMS (Traiga su propio Twilio). La mayoría de los usuarios deberían mantener la configuración administrada.

Requisitos previos #

Antes de comenzar, asegúrese de tener lo siguiente:

• Una cuenta de Meta Business (business.facebook.com) — la verificación de la empresa es opcional: las empresas no verificadas pueden activar un número, obtener la aprobación de plantillas y enviar difusiones, comenzando con el límite de 250 contactos únicos por cada 24 horas (consulte Límites de mensajería a continuación)
• Una cuenta con créditos suficientes
• Un número de teléfono que no esté registrado ya en WhatsApp (aplicación personal o Business), y que no sea ya un número de Twilio de otra cuenta

Agregue primero el nombre y la dirección de su empresa. Antes de poder comprar su primer número, complete el nombre y la dirección de su empresa en Configuración → Empresa (grupo del Espacio de trabajo). El operador valida esta dirección, así que asegúrese de que sea precisa y completa; la compra no se realizará hasta que esté configurada.

Paso 1: Comprar un número de teléfono #

1. En la barra lateral izquierda, haz clic en Settings (Configuración) cerca de la parte inferior.
2. En el menú lateral izquierdo de Settings, bajo Channels (Canales), haz clic en Channels.
3. Busca la tarjeta WhatsApp Business API y haz clic en el botón verde Connect WhatsApp (Conectar WhatsApp).
4. Elige Get a new number from us (Obtener un número nuevo de nuestra parte), y luego Managed by us (Gestionado por nosotros).

4. Se abrirá una ventana emergente de Comprar número de teléfono. Elija un país (los números y los precios en tiempo real provienen directamente de nuestro operador para ese país) y, opcionalmente, filtre por Contiene dígitos.

5. Explora la lista de available numbers (números disponibles) que aparece, cada uno con su costo de compra única y su costo mensual mostrados al lado.

6. Haga clic en un número y rellene su Nombre para mostrar: el nombre de la empresa que verán las personas en WhatsApp. Debe contener letras; un número de teléfono solo será rechazado. Luego, confirme el costo mostrado y complete la compra.

Un número comprado aquí es para WhatsApp, no para SMS. Los números adquiridos a través de la plataforma se utilizan para WhatsApp Business. No son números de SMS ni tampoco números para realizar llamadas: una llamada entrante llega a una grabadora automática (que está ahí para responder a la llamada de verificación de WhatsApp durante la configuración), no hay un buzón de voz para escuchar mensajes y no se puede llamar desde el número. Los SMS funcionan en su propia cuenta de Twilio; consulte SMS. No les diga a los clientes que un número comprado puede hacer ambas cosas; no puede.

Los créditos se deducen de su cuenta por la compra. Cada número tiene entonces un alquiler mensual para mantenerlo activo: al menos 50 créditos al mes, y los números premium cuestan más, en línea con lo que cobra el operador. La tarjeta del número en Configuración → Canales siempre muestra su precio mensual exacto, y el cuadro de diálogo de compra lo muestra antes de que usted confirme.

Ese alquiler es la única tarifa mensual del número; incluye la conexión a WhatsApp, por lo que no hay nada extra que pagar para mantener el número en WhatsApp. Si ya alquila números aquí, estos pasarán a esta tarifa en su próximo ciclo de facturación. Consulte Números de teléfono.

México y Argentina: solo se ofrecen números móviles para estos países. WhatsApp trata los números de allí como números móviles, y solo un número móvil puede recibir el código de verificación de WhatsApp; los números de tipo fijo no pueden, por lo que no aparecen en la lista. Esto también significa que el prefijo de la ciudad puede diferir del de su propia ciudad; eso no afecta el funcionamiento de su WhatsApp.

Paso 2: Conectar el número a Meta #

Un número comprado aún debe activarse con Meta antes de poder enviar y recibir:

1. En la página Channels, la tarjeta de la API de WhatsApp Business muestra tu nuevo número en su lista.
2. Haz clic en la acción de conexión propia del número (Finish setup o Finalizar configuración): se abrirá una ventana emergente de Meta donde finalizarás la conexión con la cuenta de Meta propietaria de tu cuenta de WhatsApp Business, siguiendo las indicaciones de Meta.
3. Cuando Meta confirme la conexión, el número se activará automáticamente; no hay un paso de “anuncio” por separado. Su estado cambiará a Active (Activo) por sí solo una vez que la conexión esté en línea.

Se le pedirá que inicie sesión en su cuenta de Meta Business y otorgue permiso a la plataforma para enviar y recibir mensajes de WhatsApp en su nombre.

La activación suele ser automática. Tarda unos minutos y, en la mayoría de los casos, no necesitará una llamada o código de verificación. Ocasionalmente, Meta mantiene el número como “Pendiente”; si eso sucede, siga las instrucciones en pantalla para verificar mediante una llamada telefónica. Si un número falla repetidamente al registrarse, es posible que WhatsApp lo esté limitando temporalmente; espere 24 horas y vuelva a intentarlo, o comuníquese con el soporte técnico.

¿Ya tiene su propio número de la API de Meta Cloud? #

No tienes que comprar a través de la plataforma. En la tarjeta de la API de WhatsApp Business, haz clic en Connect WhatsApp, elige Use a number you already have (Usar un número que ya tienes) y luego Managed by us (Gestionado por nosotros) para abrir el modal Connect WhatsApp Business API:

1. Introduzca el número de teléfono en formato internacional (p. ej., +1 555 123 4567).
2. Opcionalmente, escriba un nombre para mostrar: el nombre que verán las personas a las que envíe mensajes en WhatsApp.
3. Haga clic en Continuar a WhatsApp para finalizar la conexión en la propia ventana de Meta.

Recomendamos encarecidamente NO conectar su número personal activo de WhatsApp Business; conectarlo aquí puede interrumpir su aplicación de WhatsApp existente. Utilice un número nuevo.

En la ventana de Meta, añada y verifique su propio número. No elija el número de prueba gratuito de Meta (empieza por +1 555); solo puede enviar mensajes a un puñado de contactos de prueba que añada manualmente, por lo que nunca podrá llegar a clientes reales. Si introduce o selecciona el número de prueba de Meta, la conexión será rechazada.

Mover un número que actualmente está en la aplicación de WhatsApp #

Un número que esté registrado activamente en la aplicación de WhatsApp o WhatsApp Business no puede conectarse a la API; primero debe liberarlo de la aplicación. Hágalo en este orden:

1. Guarde primero todo lo que necesite de la aplicación. El historial de chats no se transfiere a la API y eliminar la cuenta es permanente; exporte o haga una copia de seguridad de las conversaciones importantes antes de continuar.
2. Desactive la verificación en dos pasos en la aplicación (Ajustes → Cuenta → Verificación en dos pasos), para que el PIN antiguo no interfiera con el registro en la API.
3. Elimine la cuenta en la aplicación: Ajustes → Cuenta → Eliminar mi cuenta. Esto libera el número; un número solo puede estar en la aplicación o en la API, nunca en ambas al mismo tiempo.
4. Espere unos minutos a que la liberación se propague y, a continuación, siga los pasos de conexión anteriores para conectar el número.

¿Quiere su propia cuenta de WhatsApp Business sin la configuración de desarrollador? #

Through our Meta app (A través de nuestra aplicación de Meta) es otra respuesta a la segunda pregunta del mismo botón Connect WhatsApp. Mantienes tu propia cuenta de WhatsApp Business, pero no creas nada en el sitio para desarrolladores de Meta; utilizas nuestra aplicación de Meta. Meta factura las conversaciones directamente a tu propia cuenta de WhatsApp Business. Si traes tu propio número: 50 créditos al mes de nuestra parte por la conexión. Si alquilas tu número aquí: nada adicional, porque el alquiler del número ya cubre la conexión. Consulta Connect Through Our Meta App.

¿Prefiere ejecutar WhatsApp en su propia aplicación de Meta? #

Existe una opción adicional para usuarios técnicos y agencias: crear su propia aplicación en el sitio de desarrolladores de Meta y conectarla directamente. Meta le factura según sus propias tarifas, no hay tarifas por mensaje de nuestra parte y sus clientes solo verán el nombre de su empresa. La guía completa se encuentra en Conectar su propia aplicación Meta.

En cualquier conexión que utilice tu propia cuenta de WhatsApp Business, Meta factura los mensajes, no nosotros. Esto incluye conectar tu propio número mediante Managed by us (Gestionado por nosotros) arriba, Through our Meta app (A través de nuestra aplicación de Meta) y tu propia aplicación de Meta. Meta realiza el cargo al método de pago vinculado a esa cuenta de WhatsApp Business y, si no hay uno activo, Meta bloqueará las difusiones, campañas y mensajes de plantilla hasta que añadas uno. Lee WhatsApp Costs & the October 2026 Change antes de tu primer envío; también cubre el cambio de precios que entrará en vigor el 1 de octubre de 2026.

Problemas comunes de conexión #

Algunos problemas suelen afectar a la mayoría de los usuarios nuevos durante el flujo de conexión con Meta. Lea esto antes de comenzar la activación.

Elija su propio número, no el número de prueba de Meta #

Durante el flujo de conexión de Meta, Meta le ofrecerá un número de teléfono de prueba (un número de muestra en el rango +1 555) junto con la opción de usar el suyo propio. Utilice siempre el suyo propio. El número de prueba de Meta puede recibir mensajes, pero solo puede enviar a un puñado de números que usted añada manualmente dentro de Meta, por lo que nunca enviará mensajes a clientes reales; cada respuesta fallará silenciosamente al enviarse. La aplicación bloquea esto: si introduce o selecciona el número de prueba de Meta, la conexión es rechazada y se le pedirá que utilice un número real en su lugar.

Su número debe terminar dentro de la cuenta de WhatsApp Business #

Esta es la razón más común por la que una conexión falla justo en el último paso. Elegir el número de prueba de Meta, o saltarse el paso del número de teléfono, deja la cuenta de WhatsApp Business que seleccionó sin su número en ella, y por lo tanto no hay nada que podamos conectar.

En el paso del número de teléfono en la ventana de Meta:

1. Elija añadir un nuevo número.
2. Introduzca su número.
3. Verifíquelo con el código que Meta le envía por SMS o llamada.

Cuando se hace correctamente, su número aparece bajo Números de teléfono en esa cuenta en WhatsApp Manager, marcado como verificado. Si la conexión falla, la aplicación le indica exactamente cuál de estos problemas ocurrió.

Si falla, no elimine ni vuelva a crear elementos #

Cuando una conexión falla, es tentador eliminar la cuenta de WhatsApp Business y empezar de nuevo. No lo haga. Eliminar una cuenta a la que está vinculado su número suele hacer que el problema sea más difícil de solucionar, y los intentos de conexión repetidos pueden hacer que WhatsApp bloquee temporalmente un número, lo cual puede volverse permanente. Lea el mensaje de error: nombra el problema específico y el siguiente paso. Si sigue sin conectarse, contacte con el soporte técnico indicando el número de teléfono y el error.

Cada cuenta necesita su propia cuenta de WhatsApp Business #

Una cuenta de WhatsApp Business solo puede estar vinculada a una cuenta de mensajería a la vez, por lo que no puede conectar un segundo número a través de la misma cuenta de WhatsApp Business desde una cuenta diferente aquí; esto ocurre con mayor frecuencia en agencias y una de sus subcuentas, o en dos subcuentas, todas apuntando a la misma cuenta de Business. Meta sigue mostrando la conexión como exitosa, porque el número está realmente verificado y activo en esa cuenta de Business, pero la activación se detiene aquí con un mensaje que nombra la cuenta que ya lo está utilizando.

Dos formas de proceder:

• Conecte el número en la cuenta que ya utiliza esa cuenta de WhatsApp Business. Agregar más números allí funciona normalmente.
• Asigne a esta cuenta su propia cuenta de WhatsApp Business. Inicie la conexión nuevamente y elija crear una nueva cuenta de WhatsApp Business en lugar de seleccionar la existente. Primero, elimine el número de la antigua cuenta de Business en Meta Business Manager, ya que un número solo puede pertenecer a una de ellas.

No elimine la cuenta de WhatsApp Business existente para liberarla; el número que ya funciona en ella dejaría de funcionar.

No reutilice una cuenta de WhatsApp Business ya vinculada a otro BSP #

Si su cuenta de WhatsApp Business (WABA) ya está vinculada a otro BSP (Business Service Provider, otro proveedor de servicios empresariales que se conectó a ella anteriormente), la conexión aquí fallará y no se podrá solucionar intentándolo de nuevo; la activación se detiene con un mensaje que indica que la cuenta de Business ya está vinculada en otro lugar. Para evitar esto, cree una cuenta de WhatsApp Business nueva en Meta Business Manager para esta conexión, en lugar de reutilizar una que haya sido configurada en otro lugar.

Paso 3: Configure su perfil de WhatsApp Business #

Su perfil de WhatsApp Business es lo que los clientes ven cuando interactúan con su empresa.

1. En la página Canales, busque su número activo en WhatsApp y abra su editor de perfil.
2. Rellene:

3. Guarde para actualizar su perfil.

Un agente por número #

Si su cuenta tiene más de un número de WhatsApp Business API, cada uno puede ser atendido por un agente de IA diferente. El panel Quién responde a las nuevas conversaciones en la página de Agentes de IA muestra un bloque por número para WhatsApp con un selector para cada número conectado: Igual que WhatsApp sigue al agente del canal; elegir otro agente (o Nadie responde) se aplica solo a ese número. Las respuestas siempre se envían desde el número al que el cliente envió el mensaje. Detalles: Puntos de entrada → Un agente por número de WhatsApp.

Comprender los límites de mensajería #

WhatsApp impone límites de mensajería para proteger a los usuarios del spam. Estos límites determinan a cuántos contactos únicos puede enviar mensajes dentro de un período continuo de 24 horas.

Sistema de niveles #

Cómo aumentar sus límites #

• Verifique su empresa en Meta Business Manager para superar el límite inicial de 250 contactos y llegar a 2.000.
• Mantenga una alta calidad de los mensajes: evite ser reportado o bloqueado por los destinatarios.
• Envíe mensajes de forma constante: WhatsApp aumenta automáticamente su nivel cuando alcanza aproximadamente la mitad de su límite actual con buenas calificaciones de calidad, generalmente dentro de las 6 horas posteriores al cumplimiento de los criterios.

Tipos de mensajes #

Mensajes de sesión (formato libre) #

Texto normal, imágenes, vídeos, documentos y otros medios que puede enviar dentro de una ventana de conversación activa.

• Puede incluir cualquier contenido
• Solo se puede enviar dentro de la ventana de mensajería de 24 horas (ver más abajo)
• No requiere aprobación previa

Mensajes de plantilla #

Formatos de mensaje preaprobados que le permiten iniciar conversaciones con clientes fuera de la ventana de 24 horas.

• Deben enviarse a Meta para su aprobación antes de su uso
• Admiten variables para personalización (p. ej., nombre del cliente, número de pedido)
• Necesarios para iniciar nuevas conversaciones o volver a interactuar después de 24 horas
• Disponibles en varios idiomas

Las plantillas ahora tienen su propia página; consulte Plantillas de mensajes de WhatsApp para ver el tutorial completo.

La ventana de mensajería de 24 horas #

WhatsApp aplica una ventana de conversación de 24 horas para proteger a los usuarios:

• Cuando un cliente le envía un mensaje, se abre una ventana de 24 horas. Durante esta ventana, puede enviar cualquier tipo de mensaje (mensajes de sesión) libremente.
• Después de 24 horas de inactividad (sin mensajes del cliente), la ventana se cierra. Solo puede volver a interactuar utilizando una plantilla de mensaje aprobada.
• Cuando envía una plantilla de mensaje, se abre una nueva ventana de 24 horas una vez que el cliente responde.

Las respuestas dentro de esta ventana dejarán de ser gratuitas el 1 de octubre de 2026. Meta ha anunciado que, a partir de esa fecha, cobrará por las respuestas de formato libre que una empresa envíe dentro de la ventana de 24 horas, por mensaje y según la tarifa de cada mercado: la misma tarifa que ya tienen las plantillas de utilidad y autenticación. Han sido gratuitas desde noviembre de 2024. Cada número de teléfono recibe primero 1000 mensajes de servicio gratuitos al mes, y solo se cobra a partir del mensaje 1001; la tarifa es la tarifa de utilidad del mercado, que ya figura en la lista de precios de Meta. Lo que esto significa para usted y lo que debe verificar antes de esa fecha se encuentra en Costos de WhatsApp y el cambio de octubre de 2026.

Prueba de su configuración #

Antes de empezar a trabajar con clientes, verifique que todo funcione:

1. Envíe un mensaje de prueba. Abra el agente de IA o la Difusión asignada a este número y utilice su panel Probar para enviarse un mensaje de prueba, o envíelo directamente desde Chats.
2. Pruebe los mensajes entrantes. Envíe un mensaje de WhatsApp desde su teléfono personal a su número de empresa y confirme que aparece en Chats.
3. Pruebe las respuestas de la IA. Confirme que el agente responde dentro del plazo esperado y que sus respuestas se ajustan a sus instrucciones y a la Base de conocimientos.
4. Pruebe las plantillas de mensajes. Cree y apruebe una plantilla sencilla, envíela a su número de prueba y confirme que llega con todas las variables completadas.

Solución de problemas #

El número no aparece como activo #

• Asegúrese de haber completado el proceso de activación completo, incluido el inicio de sesión en su cuenta de Meta Business y la concesión de permisos.
• Compruebe que su cuenta de Meta Business esté en buen estado.
• Espere unos minutos y actualice la página; la activación puede llevar tiempo.

Los mensajes no se envían #

• Verifique que tiene suficientes créditos en su cuenta.
• Compruebe si ha alcanzado su límite de mensajes.
• Asegúrese de que el número de teléfono del destinatario tiene el formato internacional correcto (por ejemplo, +1234567890).
• Si envía mensajes fuera de la ventana de 24 horas, asegúrese de utilizar una plantilla aprobada.

Difusiones y plantillas bloqueadas, pero las respuestas siguen funcionando #

Este patrón —en el que puede responder a las personas que le escriben primero, pero no sale nada que usted inicie— casi siempre significa que la cuenta de WhatsApp Business asociada al número no tiene un método de pago válido, y solo se aplica a las conexiones que funcionan con su propia cuenta de WhatsApp Business. Meta bloquea las conversaciones iniciadas por la empresa (difusiones, campañas, cualquier plantilla) hasta que haya un método de pago válido en la cuenta, e informa del error en WhatsApp Manager.

La aplicación ahora detiene una difusión o campaña antes de enviarla en esta situación y le indica que añada un método de pago, en lugar de permitir que cada mensaje falle. Añada o corrija el método de pago en WhatsApp Manager y vuelva a enviar; volver a conectar el número aquí no solucionará el problema. Consulte Costes de WhatsApp y el cambio de octubre de 2026.

Plantilla rechazada #

• Revise las directrices de plantillas de Meta: las plantillas no pueden contener contenido promocional en ciertas categorías.
• Compruebe si hay problemas de formato, como marcadores de posición que no coinciden.
• Lea el motivo de rechazo que proporcionó Meta, revise y vuelva a enviar; consulte Plantillas de mensajes de WhatsApp.

Calificación de calidad de mensaje baja #

• Revise el contenido de sus mensajes para garantizar que sea relevante y valioso para los destinatarios.
• Evite enviar mensajes a contactos que no hayan dado su consentimiento.
• Reduzca la frecuencia de los mensajes si los destinatarios le están denunciando o bloqueando.

Error “Número de teléfono no encontrado” #

• Es posible que el número de teléfono no esté vinculado correctamente a su cuenta de Meta Business.
• Intente reactivar el número de teléfono a través del flujo de conexión de WhatsApp.
• Póngase en contacto con el servicio de asistencia si el problema persiste.

Mejores prácticas #

• Obtenga siempre el consentimiento antes de enviar mensajes a los clientes por WhatsApp.
• Responda rápidamente a los mensajes de los clientes para aprovechar al máximo el plazo de 24 horas.
• Mantenga las plantillas concisas y valiosas: las plantillas de alta calidad se aprueban más rápido y tienen un mejor rendimiento.
• Supervise su calificación de calidad en Meta Business Manager para evitar descensos de nivel.
• Deje que un agente de IA gestione las respuestas para garantizar una capacidad de respuesta 24/7 dentro del plazo de mensajería; consulte Agentes de IA.