API oficial de WhatsApp Business API Cloud desde $39/canalAPI de negocios

WhatsApp Business API es la interfaz programática de la plataforma WhatsApp Business. Permite a las aplicaciones enviar y recibir mensajes, reaccionar ante eventos, automatizar conversaciones, gestionar plantillas y crear experiencias interactivas.

curl -X POST "$WHATSAPP_API/messages" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15550001234",
    "type": "text",
    "text": { "body": "Your order is on the way." }
  }'

Ve el quickstart

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 de negocio es un producto que tú usas. La API de negocio es la infraestructura con la que tú construyes.

Si una o dos personas responden a un grupo de clientes a mano, la App de Negocios es suficiente.

Los envoltorios y emuladores no oficiales no son la API de Negocios: ponen en riesgo la prohibición de números, provocan caídas de sesiones y no son adecuados para nada que no puedas permitirte perder.

Los nombres alrededor de la API son un lío por sí mismos. WhatsApp Business API, Cloud API y On-Premises se utilizan como si fueran una sola cosa. No lo son — y la siguiente sección es la última vez que esta página se detiene en la nomenclatura.

Hoy se llama Cloud API

WhatsApp Business Platform es el nombre que le da Meta a toda la pila de negocios en WhatsApp: números, cuentas, plantillas, mensajería y el resto.

La API en la nube es cómo te comunicas con esa plataforma hoy: Meta la hospeda, envías solicitudes y recibes webhooks. No administras un servidor de WhatsApp.

La API local fue la generación anterior, autoalojada. El envío de mensajes a través de ella se ha discontinuado. Si un tutorial todavía te dice que instales la API local, está describiendo una pila que no deberías construir.

Las personas buscan la WhatsApp Business API y se refieren a la API de Nube en la Business Platform. Esa fórmula es lo suficientemente cercana para navegar por la Documentación — con una salvedad: la plataforma es más amplia que un solo punto final de mensajería.

Una vez que se establezcan los nombres, la verdadera pregunta es por qué dejar una aplicación gratuita.

¿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 el software — no desde un teléfono.

La automatización, los ganchos de CRM y la escalabilidad aparecen más adelante en esta página. Esta parte es algo que muchos artículos omiten.

Cambiar no quita la aplicación.

Los equipos retrasan la API porque piensan que la aplicación de WhatsApp Business tiene que desaparecer. No es así. El mismo número puede operar en la aplicación y en la API al mismo tiempo: las personas siguen respondiendo donde ya trabajan, y el software envía notificaciones y maneja los mensajes entrantes por el lado. Tú estás agregando la API. No estás confiscando el chat que tu equipo ya utiliza.

La coexistencia tiene límites — qué funciones de la aplicación permanecen disponibles, cómo se sincroniza el historial. Consulta la documentación de Meta para ver la lista actual antes de depender de una en específico. El movimiento en sí se encuentra en Get started.

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 publicitario no es exclusivo de la API. Lo que añade la API es el evento: el webhook que entrega el primer mensaje también lleva qué anuncio y qué fuente iniciaron el hilo. Eso es suficiente para atribuir la conversación y responder o dirigirla en 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: ningún dispositivo tiene que estar 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.

Cómo funciona

Dos direcciones, un modelo. Si solo implementas la salida, has construido la mitad de un canal.

Customer ↔ WhatsApp ↔ WhatsApp Cloud API ↔ Your backend — desde el backend: CRM, AI, Support.

1. Tu aplicación envía solicitudes a la API. Outbound es una llamada HTTP: un mensaje, una plantilla, una carga de medios. WhatsApp no está consultando tu servidor.

2. WhatsApp entrega el mensaje. La infraestructura de Meta lo coloca en el teléfono del usuario. Tú no operas ese camino.

3. Los webhooks envían eventos de regreso. Los mensajes entrantes, y los estados que te indican si un mensaje fue enviado, entregado, leído o falló, llegan como callbacks. Tu aplicación reacciona. No pregunta «¿algo nuevo?»

Capacidades de API

La API de WhatsApp Business no es un endpoint de «enviar mensaje» con extras. Esta es la superficie que realmente estás integrando.

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 stickers.

Experiencias interactivas

Transforma una conversación en una interfaz.

Los botones de respuesta, listas, llamadas a la acción y respuestas estructuradas recolectan una elección sin necesidad de interpretar texto libre. Los Flows de WhatsApp son mini-formularios nativos dentro del hilo: reserva, solicitudes, encuestas, registro, onboarding — el usuario no sale de WhatsApp para enviar un formulario.

Plantillas y mensajería saliente

Inicia conversaciones que el canal realmente entregará.

Un negocio que escribe primero utiliza plantillas que Meta ha revisado: Utilidad, Autenticación, Marketing. Las plantillas existen porque WhatsApp es un canal con permisos. La revisión ocurre antes del primer mensaje saliente, no después de una queja. Esa es una fricción intencionada — y es por eso que 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.

Webhooks deliver inbound messages; sent, delivered, read and failed statuses; errors; replies to interactive messages; orders; call events; account events; and the click context when a conversation started from an ad. The application that ignores webhooks can send. It cannot operate.

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 de comercio permiten que alguien navegue y compre sin ser enviado a una tienda aleatoria. El catálogo es un objeto de negocio, no un PDF que adjuntas.

Llamando

Coloca la voz de WhatsApp en el mismo backend que el chat.

Recibe y realiza llamadas de WhatsApp desde tu aplicación. Conecta un PBX o un centro de contacto —incluyendo a través de SIP— cuando la parte de voz deba pertenecer al mismo registro de cliente que la conversación.

Gestión empresarial

Administra la cuenta de WhatsApp como un software, no como una configuración del teléfono.

Los números de teléfono, los perfiles de negocio, las Cuentas de WhatsApp Business, las plantillas, los códigos QR y la configuración de la cuenta son objetos de la API. Embedded Signup es la ventana nativa de Meta para conectar el WhatsApp de un cliente o una sucursal sin un hilo de ticket. Ese camino es importante si conectas WhatsApp para otros negocios, no solo para ti.

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— deciden cuánto puedes enviar. Los estados de entrega y los errores te indican lo que realmente sucedió. La mecánica pertenece a esta página; los números actuales se encuentran en la documentación de Meta porque cambian.

No puedes simplemente enviar un mensaje a todos

WhatsApp no es una lista que subes. Si la integración asume que una hoja de cálculo de números es suficiente para escribir primero, estará equivocada desde el primer día — en código, no solo en política.

• Iniciado por el cliente. La persona escribió primero. Dentro de la ventana de atención al cliente puedes responder en forma libre. Cuando la ventana se cierra, vuelves a las plantillas.

• Iniciado por el negocio. Tú escribes primero solo con una plantilla aprobada, por una razón que la persona puede esperar razonablemente.

• Opt-in. They agreed to hear from you, and they expect the kind of message you are sending. Opt-in is not a loophole around templates.

Una conversación no tiene que empezar en la bandeja de entrada. Un anuncio de Click-to-WhatsApp, un código QR o un botón en tu sitio siguen 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.

Lo que cuesta

No hay un único «precio de la API de WhatsApp Business». Existe 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

• Meta. Tú pagas por los mensajes de WhatsApp. La cantidad depende del tipo de mensaje, del mercado y del actual modelo de precios de Meta — que ya ha cambiado y volverá a cambiar. Esta página no cotiza tarifas.

• Una plataforma. Los proveedores cobran una suscripción, un recargo por mensajes, una tarifa por número, a veces una tarifa de instalación — a menudo una mezcla. Compara la factura completa, no solo una línea en una tabla de precios.

• Directo a la Nube API. No hay factura de proveedor. Aún hay una factura: hosting, una base de datos, almacenamiento de medios, colas, monitoreo y el tiempo de ingeniería para mantener correcto ese conjunto cuando se mueve la API.

Los precios de 1MSG están en el encabezado y pie de página del sitio. No se repiten aquí.

Constrúyelo tú mismo o utiliza una plataforma

Una API te brinda capacidades. No te da un producto.

Si te conectas directamente a la API de WhatsApp Nube, obtienes los primitivas para construir tu propio producto de WhatsApp. Tú decides cómo se almacenan, muestran, enrutan y conectan los mensajes al resto de tu infraestructura. Twilio, 1MSG, respond.io y el resto existen porque esa segunda parte es un trabajo real — no porque WhatsApp sea diferente dependiendo del proveedor.

WhatsApp Business API te ofrece: Mensajes, webhooks, plantillas, medios, Flujos, llamadas, objetos de negocio.

Una plataforma añade: Una bandeja de entrada, historial de conversaciones, herramientas para agentes, integraciones de CRM, automatización, analítica, registros, reintentos, gestión de usuarios, ganchos de IA, facturación y herramientas para desarrolladores.

La diferencia se nota en 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 incompleto como producto.

Cómo accedes es una pregunta separada de cómo almacenas los mensajes. Tres caminos: tu propia aplicación de Meta, un BSP, o un Proveedor de Tecnología. Lo que cambia es quién posee la cuenta de WhatsApp Business y el número, si se requiere un BSP, y si puedes llevar el número a otro lugar. Un BSP no es obligatorio. A través de un Proveedor de Tecnología, la WABA y el número pueden seguir siendo tuyos, con Embedded Signup como el flujo de conexión. Los detalles se encuentran en las FAQ — esta página no es un contrato.

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 práctica es una lista de verificación corta, 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 de negocio

• Verificación de número

• Verificación empresarial cuando Meta lo requiere — no en todos los casos

• Un token de acceso

• Un endpoint de webhook

Un número de prueba y una conexión de sandbox, un webhook y el primer mensaje en la misma línea. La lista de verificación muestra cómo se ve la producción.

Pasos

1. Crea o conecta una cuenta de WhatsApp Business

2. Agrega tu número de teléfono de negocio

3. Conecta la API

4. Configurar webhooks

5. Envía tu primer mensaje

6. Construye tu integración

Empieza a construir · Lee el rápido inicio · Leer Documentación

Mover un número de la Aplicación Empresarial

El número puede moverse de la Aplicación de Negocios de WhatsApp a la API. Tú conservas el número. Ese es el miedo habitual, y es la parte que tiene una respuesta clara.

La historia de la conversación en la app no se convierte automáticamente en una historia completa que tu API puede consultar. Considera la historia del chat como un detalle de migración a confirmar en la Documentación de Meta para tu configuración: coexistencia, un traslado completo o un nuevo número no son el mismo caso. No planees un cambio esperando que cada hilo viejo esté esperando en el software.

FAQ