API oficial de WhatsApp Business API Cloud desde $39/canalAPI de negocios
Conecta tu número de negocio a WhatsApp Cloud API con 1MSG: mensajería, webhooks y plantillas sin construir la pila.
Mismo mensajero. Tres productos diferentes.
WhatsApp Business API no es otra aplicación de WhatsApp. Es la infraestructura que los desarrolladores utilizan para conectar WhatsApp con software. La aplicación Business es un producto que usas. La Business API es la infraestructura con la que construyes. Si una o dos personas responden a un número reducido de clientes manualmente, la aplicación Business es suficiente. Los envoltorios y emuladores no oficiales no son la Business API: arriesgan baneos de números, caídas de sesiones y son una mala opción para cualquier cosa que no te atrevas a perder.
| Comparado con | Aplicación de WhatsApp para negocios | WhatsApp Business API |
|---|---|---|
| Diseñado para | Pequeñas empresas | Mensajería empresarial escalable y software |
| Interfaz | App | API |
| Respuestas manuales | Principalmente | Opcional |
| Automatización | Básico | Completo |
| Integración de backend | Limitado | Sí |
| CRM / mesa de ayuda | Limitado | Sí |
| Desarrolladores requeridos | No | Usualmente |
| Escala | Pequeños equipos | Aplicaciones y negocios |
Hoy se le llama API de Nube
Las personas buscan WhatsApp Business API y se refieren a Cloud API en la Business Platform. Esa fórmula es lo suficientemente cercana para navegar la documentación — con una salvedad: la plataforma es más amplia que un solo punto de mensajería. Una vez que los nombres se estabilicen, la verdadera pregunta es por qué abandonar una aplicación gratuita.
- Plataforma de Negocios de WhatsApp
El nombre de Meta para toda la pila de negocios en WhatsApp — números, cuentas, plantillas, mensajería y el resto.
- API de Nube
Cómo hablas con esa plataforma hoy: Meta la aloja, envías solicitudes y recibes webhooks. No administras un servidor de WhatsApp.
- API On-Premises
La generación anterior, autohospedada. El envío de mensajes a través de ella se ha descontinuado. Si un tutorial todavía te aconseja instalar On-Premises, está describiendo un stack que no deberías construir.
¿Por qué utilizar la WhatsApp Business API?
Mantén la app cuando cambies, deja que tu backend vea qué anuncio inició el chat, y ejecuta el número desde software — no desde un teléfono. La automatización, los enlaces de CRM y la escalabilidad aparecerán más adelante en esta página. Este bloque es la parte que la mayoría de los artículos aún interpretan mal — o nunca mencionan.
| Lo que la gente extraña | Lo que la API realmente agrega | En la práctica |
|---|---|---|
| Cambiar no se lleva la aplicación | El mismo número puede funcionar en la app y en el API al mismo tiempo: las personas siguen respondiendo donde ya trabajan, y el software envía notificaciones y maneja entradas por un lado. Estás agregando el API. No estás confiscando el chat que tu equipo ya utiliza. | La coexistencia tiene límites — qué funciones de la app permanecen disponibles, cómo se sincroniza el historial. Revisa la Documentación de Meta para la lista actual antes de depender de una específica. |
| Tu backend ve qué anuncio inició el chat | Un anuncio de Click-to-WhatsApp en Facebook o Instagram puede abrir un chat con la Business App. El producto del anuncio no es exclusivo de la API. Lo que la API añade es el evento: el webhook que entrega el primer mensaje también lleva qué anuncio y qué fuente iniciaron el hilo. | Atribuye la conversación y respóndela o redirígela en el software, en lugar de emparejar anuncios con chats manualmente. |
| El número vive en el software | La aplicación de negocios vive en un teléfono. La API no. El número es un objeto en tus sistemas: no es necesario que ningún teléfono esté en línea, varias aplicaciones y varios agentes pueden usarlo al mismo tiempo, y el canal no depende de quién esté sosteniendo el dispositivo hoy. | El canal no depende de que un teléfono permanezca en línea. |
Lo que puedes construir
Si ya conoces el trabajo, el resto de esta página es implementación. Estos son los trabajos que los equipos realmente entregan en la WhatsApp Business API. Explora todos los casos de uso en /use-cases.
Cómo funciona
Dos direcciones, un modelo. Si solo implementas salidas, has construido la mitad de un canal. Cliente ↔ WhatsApp ↔ WhatsApp Cloud API ↔ tu backend — y desde el backend: CRM, IA, Soporte.
- 1 · Saliente
Tu aplicación envía solicitudes a la API. Saliente es una llamada HTTP: un mensaje, una plantilla, una carga de medios. WhatsApp no está sondeando tu servidor.
- 2 · Entrega
WhatsApp entrega el mensaje. La infraestructura de Meta lo coloca en el teléfono del usuario. Tú no operas ese camino.
- 3 · Webhooks
Los webhooks envían eventos de regreso. Los mensajes entrantes, y los estados que indican si un mensaje fue enviado, entregado, leído o fallido, llegan como callbacks. Tu aplicación reacciona. No pregunta «¿algo nuevo?»
Lo que puedes construir
Si ya conoces el trabajo, el resto de esta página es implementación. Estos son los trabajos que los equipos realmente envían en WhatsApp Business API.
| Grupo | Para qué es | Lo que realmente obtienes |
|---|---|---|
| Mensajería | Envía y recibe mensajes de WhatsApp. | El texto es el inicio, no el producto. La misma API envía y recibe imágenes, video, audio y documentos — tú subes y descargas medios en lugar de adjuntarlos desde un teléfono — además de ubicación, contactos, reacciones y adhesivos. |
| Experiencias interactivas | Convierte una conversación en una interfaz. | Los botones de respuesta, listas, llamadas a la acción y respuestas estructuradas recogen una elección sin interpretar texto libre. Los Flows de WhatsApp son formularios mini nativos dentro del hilo: reserva, aplicaciones, encuestas, registro, onboarding — el usuario no sale de WhatsApp para enviar un formulario. |
| Plantillas y mensajes salientes | Inicia conversaciones que el canal realmente entregará. | Un negocio que crea mensajes iniciales utiliza plantillas que Meta ha revisado: Utilidad, Autenticación, Marketing. Las plantillas existen porque WhatsApp es un canal autorizado. La revisión ocurre antes del primer mensaje saliente, no después de una queja. Los mensajes de sesión y los mensajes de plantilla no son intercambiables en tu código. |
| Eventos y webhooks | Reacciona mientras la conversación está sucediendo. | Los webhooks entregan mensajes entrantes; estados de enviado, entregado, leído y fallido; errores; respuestas a mensajes interactivos; pedidos; eventos de llamadas; eventos de cuentas; y el contexto de clic cuando una conversación comenzó desde un anuncio. La aplicación que ignora los webhooks puede enviar. No puede operar. |
| Comercio | Pon un catálogo en el hilo. | Los catálogos de productos, mensajes de un solo producto y múltiples productos, carruseles, pedidos y configuraciones comerciales permiten que alguien navegue y compre sin ser enviado a una tienda aleatoria. El catálogo es un objeto comercial, no un PDF que adjuntas. |
| Llamando | Pon la voz de WhatsApp en el mismo backend que el chat. | Recibe y realiza llamadas de WhatsApp desde tu aplicación. Conecta una central telefónica o un centro de contacto — incluso a través de SIP — cuando la parte de voz debería pertenecer al mismo registro de cliente que el hilo. |
| Gestión empresarial | Administra la cuenta de WhatsApp como software, no como una configuración de teléfono. | Los números de teléfono, perfiles comerciales, cuentas de WhatsApp Business, plantillas, códigos QR y configuración de cuentas son objetos de la API. Registro incorporado es la ventana nativa de Meta para conectar el WhatsApp de un cliente o de una sucursal sin un hilo de ticket. |
| Escala y operaciones | Conoce lo que el canal permitirá antes de prometer una fecha de lanzamiento. | Los límites de mensajería, la calificación de calidad y el rendimiento —incluidos los aumentos automáticos de capacidad— determinan cuánto puedes enviar. Los estados de entrega y los errores te indican lo que realmente sucedió. Los números actuales se encuentran en la documentación de Meta porque cambian. |
No puedes simplemente enviar mensajes a todos
WhatsApp no es una lista que subas. Si la integración asume que una hoja de cálculo de números es suficiente para iniciar, estará equivocada desde el primer día — en código, no solo en política. Una conversación no tiene que comenzar en la bandeja de entrada: un anuncio de Click-to-WhatsApp, un código QR o un botón en tu sitio sigue siendo el usuario iniciando el hilo. Algunos de esos puntos de entrada utilizan una ventana de atención diferente. La idea es estable; los temporizadores no lo son — usa la documentación de Meta, no un número de esta página.
- Iniciado por el cliente
La persona escribió primero. Dentro de la ventana de atención al cliente puedes responder libremente. Cuando la ventana se cierra, vuelves a la plantilla.
- Iniciado por el negocio
Tú escribes primero solo con una plantilla aprobada, por una razón que la persona puede esperar razonablemente.
- Aceptación
Acordaron escuchar de ti, y esperan el tipo de mensaje que estás enviando. La opción de suscripción no es una forma de evadir las plantillas.
Lo que cuesta
No hay un solo «precio de WhatsApp Business API». Hay una estructura de costos. Las tarifas cambian; esta forma no. Tu costo total = cargos de mensajería de WhatsApp + cargos de la plataforma o tu propia infraestructura. Los precios de 1MSG están en el encabezado y pie de página del sitio. No se repiten aquí.
| Capa | Lo que pagas | Lo que eso significa |
|---|---|---|
| Meta | Tú pagas por los mensajes de WhatsApp. | La cantidad depende del tipo de mensaje, del mercado y del modelo de precios actual de Meta — el cual ya ha cambiado y volverá a cambiar. Esta página no cita tarifas. |
| Una plataforma | Suscripción, margen, cuota por número, configuración — a menudo una mezcla. | Compara la factura completa, no una línea en una tabla de precios. |
| Directo a la API de Nube | No hay factura del proveedor. | Todavía hay una factura: hospedaje, una base de datos, almacenamiento de medios, colas, monitoreo y el tiempo de ingeniería para mantener ese conjunto correcto cuando la API se mueve. |
Constrúyelo tú mismo o usa una plataforma
Una API te da capacidades. No te da un producto. Si te conectas directamente a WhatsApp Cloud API, obtienes los elementos básicos para construir tu propio producto de WhatsApp. Tú decides cómo se almacenan, muestran, enrutan y conectan los mensajes al resto de tu stack. Twilio, 1MSG, respond.io y el resto existen porque esa segunda parte es trabajo real — no porque WhatsApp sea diferente dependiendo del proveedor. La diferencia se muestra como el tiempo hasta la producción, lo que pagas para mantener las luces encendidas, y quién está despierto cuando los webhooks fallan a las 2 a.m. Cloud API no es peor. Es incompleta como producto. La forma en que obtienes acceso es una pregunta separada de cómo almacenas los mensajes: tu propia aplicación de Meta, un BSP, o un Proveedor de Tecnología. Un BSP no es obligatorio. A través de un Proveedor de Tecnología, el WABA y el número pueden seguir siendo tuyos, con Embedded Signup como el flujo de conexión.
| Capa | WhatsApp Business API te brinda | Una plataforma agrega |
|---|---|---|
| El canal | Mensajes, webhooks, plantillas, medios, Flujos, llamadas, objetos de negocio. | Una bandeja de entrada, historial de conversaciones, herramientas para agentes, integraciones de CRM, automatización, análisis, registros, reintentos, gestión de usuarios, ganchos de IA, facturación y herramientas para desarrolladores. |
¿Por qué 1MSG?
WhatsApp proporciona la red de comunicación. 1MSG proporciona la infraestructura para desarrolladores a su alrededor. Usa 1MSG cuando quieras el canal y una capa de producción a su alrededor — no un número alquilado y no un año escribiendo en colas.
- Tu WABA, no una línea alquilada
Conéctate con Registro Incrustado. La cuenta de WhatsApp Business y el número de teléfono son tuyos. El acceso directo es cómo se construyó la plataforma, no un plan secundario.
- Historia que puedes consultar
La API de Cloud entrega mensajes. No te proporciona un archivo de conversaciones. 1MSG mantiene el historial disponible a través de la API, así no tienes que configurar una base de datos para recordar el hilo de ayer.
- Media que sobrevive al webhook
Las URL de medios de WhatsApp son de corta duración. Los archivos permanecen en la plataforma, así que no tienes que preocuparte por el enlace o manejar tu propio almacenamiento.
- Webhooks que reintentan
Una llamada perdida es una entrada si nadie la pone en cola. 1MSG pone en cola la entrega del webhook y reintenta para que el tráfico de producción no sea un POST de mejor esfuerzo.
- Envía antes de que el número esté listo
Número de prueba, sandbox, API, SDK y Documentación incluyen conectar, webhooks y el primer mensaje.
- Opera el canal en un solo lugar
Plantillas, varios números y cuentas, facturación y soporte — el trabajo que Cloud API deja de tu lado del cable.
Todo lo que necesitas para construir en WhatsApp
La versión burocrática de esta historia es un mes de tickets de Meta antes de un Hola Mundo. La versión funcional es una breve lista de verificación y luego un primer mensaje. Lo que necesitas: un portafolio de negocios de Meta, una Cuenta de WhatsApp Business, un número de teléfono comercial, verificación del número, verificación del negocio cuando Meta lo requiera — no en todos los casos, un token de acceso y un endpoint de webhook. Un número de prueba y un sandbox conectan, webhooks y el primer mensaje sin tu propia línea. La lista de verificación es lo que se ve en producción, no el costo de intentarlo. Mover un número de la Aplicación de Negocios: mantienes el número. El historial de conversaciones en la aplicación no se convierte automáticamente en un historial completo que tu API puede consultar — confirma eso en la Documentación de Meta para tu configuración.
| Paso | Qué hacer | Notas |
|---|---|---|
| 1 | Crea o conecta una cuenta de WhatsApp Business | WABA está bajo tu portafolio empresarial de Meta. |
| 2 | Agrega tu número de teléfono comercial | Un número que aún está activo en WhatsApp para consumidores típicamente tiene que ser migrado o liberado primero. |
| 3 | Conecta la API | Embedded Signup es el flujo de conexión nativo. |
| 4 | Configurar webhooks | Las entradas y los estados llegan como callbacks. La recepción no es un producto separado. |
| 5 | Enviar tu primer mensaje | Comienza desde el quickstart: https://help.1msg.io/platform-1msg/getting-start/quick-start |
| 6 | Crea tu integración | Plantillas, enrutamiento, CRM, agentes, bots — el producto alrededor del canal. |
Los desarrolladores necesitan más que API de Cloud
WhatsApp Cloud API de Meta te brinda los elementos básicos para enviar y recibir mensajes. 1MSG lo amplía con la infraestructura alrededor de WhatsApp Business API, para que puedas concentrarte en tu producto y lanzar en horas, no en semanas.
| Capacidad | WABA | Con 1MSG |
|---|---|---|
| Historial de mensajes | Tú lo construyes | API para el historial de mensajes |
| Almacenamiento de medios | Almacenado por 30 días | Sin límite de tiempo |
| Registro de entrega | Tú lo construyes | Incluido |
| Plantillas | Configuración manual | Plantilla de auto-inclusión |
| Soporte | Autoatención | Incluido |
| Observabilidad | Tú lo construyes | Pronto |
| Despliegue de la app | Tú lo alojas | Pronto |
| ¿Puedo ejecutar anuncios de Click-to-WhatsApp con la API? | Sí. Los anuncios que abren un chat de WhatsApp funcionan con la App de Negocios y con la API. Con la API, el primer webhook entrante puede incluir qué anuncio y qué fuente iniciaron la conversación, para que puedas atribuirlo y manejarlo en código. | Anuncios |
| ¿Qué tan rápido puedo enviar mensajes? | El rendimiento sigue los límites de mensajería y la calificación de calidad, no es un canal ilimitado. La capacidad puede aumentar automáticamente a medida que el número se mantenga en buen estado. Los límites actuales están en la documentación de Meta; no se imprimen aquí porque cambian. | Límites |
| ¿Necesito un Facebook Business Manager verificado? | Necesitas un portafolio de negocios de Meta. Se requiere verificación de número. La verificación de negocio es necesaria en algunos casos, no como un primer paso universal. Si Meta la solicita en tu cuenta, no puedes omitirla; si no lo hace, no bloquees tu proyecto por un rumor de que todos deben verificarlo el primer día. | Acceder |
| ¿Cuánto tiempo se tarda en obtener acceso? | Conectar un número y enviar un primer mensaje puede ser rápido, especialmente con un número de prueba. La verificación de negocio, la revisión de la plantilla y mover una línea de producción tardan más cuando Meta está involucrado. No hay un SLA honesto de tamaño único. | Acceder |
| ¿Cómo obtengo el tilde verde (cuenta oficial de negocio)? | La marca de verificación verde es el estado de Cuenta Oficial de Negocios. Meta lo otorga a las marcas que cumplen con sus criterios; conectar la API no lo produce, ni tampoco elegir un proveedor en particular. Se trata del negocio que Meta ve, no del método de integración. | Marca |
| ¿Puedo enviar mensajes a cualquier persona? | No. No puedes cargar una base de datos y enviarle un mensaje. O la persona inició la conversación (y estás dentro del período de atención) o envías una plantilla aprobada que tienen una razón para recibir, con la opción de aceptación para ese tipo de mensaje. | Reglas |
| ¿Puede la API de WhatsApp recibir mensajes? | Sí. Los mensajes entrantes llegan a los webhooks, junto con los estados de entrega y lectura. La recepción no es un producto separado. | Capacidades |
| ¿Puedo usar la API de WhatsApp para soporte al cliente? | Sí. Inbound, routing, agents, bots e history son un uso estándar de la API. El soporte es algo que se construye, no un modo que actives en WhatsApp. | Casos de uso |
| ¿Puedo conectar la API de WhatsApp a un CRM? | Sí. Esa es una razón principal para usar la API en lugar de la aplicación: las conversaciones se convierten en registros en el sistema que ya utilizas. | Casos de uso |
| ¿La API de WhatsApp soporta chatbots de IA? | La API entrega mensajes y eventos. Puedes adjuntar el modelo o agente que desees. WhatsApp no aloja tu asistente; simplemente transporta la conversación. | Casos de uso |
| ¿Puede la API de WhatsApp hacer llamadas? | Sí. Las capacidades de llamadas de la plataforma WhatsApp Business permiten a las aplicaciones recibir y hacer llamadas de voz por WhatsApp, incluyendo hacia un PBX o centro de contacto. | Capacidades |
| ¿La API de WhatsApp soporta pagos? | Soporta catálogos, mensajes de productos y pedidos. Los pagos nativos en el chat dependen de lo que Meta ha habilitado en un mercado determinado. No prometas un proceso de compra global desde esta página. | Capacidades |
| ¿Es segura la WhatsApp Business API y cumple con el GDPR? | Los mensajes de WhatsApp están cifrados de extremo a extremo en el mensajero. Tu integración todavía almacena lo que decides conservar — historial, medios, registros — y ese procesamiento es tu responsabilidad (y la de tu proveedor) bajo el GDPR. El cifrado en tránsito en WhatsApp no reemplaza un DPA, las reglas de retención o el control de acceso sobre los sistemas alrededor de la API. | Seguridad |
| ¿Qué pasó con el API de WhatsApp On-Premises? | On-Premises fue la generación anterior autoalojada. El envío de mensajes a través de ella ha sido descontinuado. El nuevo trabajo pasa por Cloud API. | Nombramiento |
| ¿Necesito un BSP para usar la API de WhatsApp? | No. Puedes usar tu propia aplicación de Meta, un BSP o un Proveedor de Tecnología. Un BSP es un camino, no un requisito. Con un Proveedor de Tecnología, el WABA y el número pueden seguir siendo tuyos. | Acceder |
| ¿Puedo mover mi número a otro proveedor? | Si posees la Cuenta de WhatsApp Business y el número, generalmente puedes llevarlos a otro proveedor. Si el número es alquilado de un BSP, estás en el proceso de ese BSP. La propiedad es la pregunta que debes resolver antes de integrarte, no después de que estés en vivo. | Acceder |
