Saltar al contenido principal
WhatsApp Business

API de WhatsApp Business: qué es y cómo conectarla

Francesco Sganga ·

Fecha de actualización:

La API de WhatsApp Business, cuyo nombre oficial es WhatsApp Business Platform, es la interfaz que conecta el número de WhatsApp de una empresa con un software: bandeja compartida, CRM, tienda online o asistente de IA. La puede usar cualquier empresa con una cuenta de Meta Business y un número dedicado, y en la práctica casi siempre se activa a través de un proveedor oficial. En esta guía vemos qué es, qué necesitas para conectarla, qué cambia respecto a la app y cómo elegir proveedor.

Manos escribiendo código en un portátil

Si aún dudas de si la necesitas, empieza por cómo funciona WhatsApp Business.

Qué es la API de WhatsApp Business

Cuando se habla de “api de whatsapp” se hace referencia al conjunto de herramientas que Meta ofrece a las empresas para enviar y recibir mensajes de forma programática. El nombre oficial es WhatsApp Business Platform y la forma de acceder es la Cloud API: una API basada en la Graph API y el protocolo HTTP, alojada por Meta, por lo que no tienes que gestionar servidores de WhatsApp.

La API no tiene interfaz propia. Es un canal: los mensajes de tus clientes llegan a tu software mediante webhooks y tu software responde llamando a la API. Por eso siempre hay algo encima: una plataforma de bandeja de entrada, un CRM o un asistente virtual.

Qué cambia respecto a la app WhatsApp Business

La app está pensada para quien responde a mano desde un móvil. La API, para quien quiere integrar WhatsApp en sus procesos.

Aspecto App WhatsApp Business API de WhatsApp Business
Interfaz App en el móvil Ninguna: necesitas un software conectado
Agentes en el mismo número Pocos dispositivos vinculados Los que admita tu software
Integraciones (CRM, tienda, IA) No Sí
Mensajes automáticos Saludos y respuestas rápidas básicas Flujos y asistentes personalizados
Mensajes fuera de una conversación abierta Manuales Solo plantillas aprobadas por Meta
Puesta en marcha Se descarga y se configura Requiere cuenta de Meta Business y número dedicado

Según la documentación de Meta, un número registrado en la Cloud API no puede usarse además en la app WhatsApp Messenger, y si ya está activo en WhatsApp hay que eliminarlo antes. Existe un modo de coexistencia que permite usar el mismo número en la app WhatsApp Business y en la API, pero solo a través de partners habilitados y con limitaciones, por ejemplo, los grupos no están disponibles en la API.

Quién puede usarla y qué necesitas

No hay tamaño mínimo. Según la documentación oficial de Meta, para empezar necesitas:

  1. Un portafolio comercial de Meta (la cuenta de Meta Business), el contenedor de tus activos, entre ellos la cuenta de WhatsApp Business (WABA).
  2. Un número de teléfono dedicado, real o virtual, verificado con un código por SMS o llamada de voz. No puede estar ya en uso en WhatsApp.
  3. Un nombre visible, que Meta puede revisar.
  4. Un método de pago asociado para los mensajes de pago.
  5. Plantillas aprobadas para los mensajes que envías tú primero.
  6. Opt-in de los clientes: debes contar con su permiso para escribirles, conforme a las leyes que te apliquen.

La verificación de la empresa no es obligatoria para empezar, pero Meta la relaciona con límites y funciones superiores. Por ejemplo, los mensajes enviados fuera de una conversación abierta parten con un tope de 250 destinatarios únicos en 24 horas, y la verificación es una de las vías para llegar a 2.000.

Plantillas, ventana de 24 horas y opt-in

Tres reglas explican casi todo el comportamiento de la API.

La ventana de atención al cliente. Cuando un cliente te escribe se abre una ventana de 24 horas en la que puedes responder con mensajes libres. Cuando se cierra, solo puedes escribir con plantillas.

Plantillas. Son mensajes predefinidos que Meta aprueba antes de usarlos, normalmente en menos de 24 horas, y pertenecen a una categoría: autenticación, marketing o utilidad. No se pueden enviar hasta que su estado sea APPROVED. Para saber qué cuesta cada categoría, consulta la guía sobre cuánto cuesta enviar mensajes de WhatsApp automáticos.

Opt-in. La política de WhatsApp Business exige que tengas el permiso del destinatario para escribirle, y la responsabilidad del método para obtenerlo es tuya. Si los usuarios te bloquean o te denuncian, Meta puede limitar los mensajes que envías.

El papel de los Business Solution Provider (BSP)

Un proveedor de la API de WhatsApp Business (BSP, Business Solution Provider) es un partner de Meta que da acceso a la API a otras empresas, normalmente con una plataforma ya lista. Meta distingue dos roles: los Solution Partners, que pueden facturar directamente a sus clientes el uso de la API, y los Tech Providers, cuyos clientes añaden su propio método de pago, de modo que Meta factura el uso de la API y el proveedor factura sus servicios.

El proveedor suele ofrecer el Embedded Signup: un flujo guiado, lanzado desde su web, que crea tus activos de WhatsApp, registra el número y autoriza la app del proveedor a usarlos. Conectas el número en pocos pasos, sin tokens ni webhooks. Algunas funciones, como la coexistencia, solo están disponibles a través de estos partners.

También puedes conectarte directamente a la Cloud API con un desarrollador propio. Es posible, pero tendrás que construir y mantener bandeja, plantillas y webhooks, algo que solo tiene sentido si ya cuentas con un equipo técnico.

Cómo elegir proveedor: criterios concretos

Pregunta esto y compruébalo en una demo:

  • Propiedad de la cuenta. ¿La WABA y el número se quedan en tu portafolio comercial? Si cambias de proveedor, ¿puedes llevártelos?
  • Estado de partner. ¿Es Solution Partner o Tech Provider de Meta? Debería poder demostrarlo.
  • Qué hay encima de la API. Bandeja compartida, asignación a agentes, plantillas, historial del cliente. Sin esto, la API sola no le sirve a un equipo.
  • Otros canales. Si también recibes correo, llamadas o redes, una sola bandeja evita saltar entre herramientas.
  • Claridad económica. Entiende qué pagas al proveedor y qué pagas a Meta, y dónde ves el consumo.

Casos de uso típicos en una pyme

Errores comunes

  1. Usar un número personal o ya activo en WhatsApp sin saber que primero hay que liberarlo.
  2. Escribir sin opt-in documentado: abre la puerta a bloqueos, denuncias y límites de envío.
  3. Elegir un proveedor que mantiene tu número en su cuenta, lo que dificulta irte.

Para ver cómo se refleja esto en una cuenta, lee también qué significa tener una cuenta de empresa en WhatsApp.

Cómo te da acceso a la API Humassistant

Humassistant es una plataforma SaaS italiana, partner oficial de Meta Business, que reúne WhatsApp y tus demás canales en una sola bandeja. Gestiona la activación de la API por ti: tú conectas tu número y nosotros nos ocupamos de la integración técnica. Desde la misma bandeja tu equipo atiende a los clientes, y un asistente de IA entrenado con tus documentos puede responder automáticamente y pasar la conversación a una persona cuando haga falta. Primero centralizas y, cuando quieras, automatizas.

Preguntas frecuentes sobre la API de WhatsApp Business

¿La API de WhatsApp Business es lo mismo que la WhatsApp Business Platform?

Sí, en el lenguaje cotidiano “API” se refiere a la WhatsApp Business Platform de Meta. Hoy se accede a través de la Cloud API, alojada por Meta, ya sea mediante un proveedor o directamente con un desarrollador.

¿Necesito un proveedor para usar la API?

No. Puedes conectarte directamente a la Cloud API si tienes conocimientos técnicos para gestionar tokens, webhooks, plantillas y una bandeja. Para una pyme sin desarrolladores, un proveedor oficial reduce mucho el trabajo inicial y el de mantenimiento.

¿Puedo usar el mismo número en la app y en la API?

Por lo general no: un número registrado en la API no puede usarse en la app WhatsApp Messenger, y uno ya activo en WhatsApp debe eliminarse antes. El modo de coexistencia permite usar un mismo número en la app WhatsApp Business y en la API, pero solo a través de partners habilitados y con algunas limitaciones.

¿Es obligatoria la verificación de la empresa?

No para empezar, pero Meta la relaciona con límites y funciones superiores. Por ejemplo, es una de las vías para pasar de 250 a 2.000 destinatarios únicos en 24 horas en los mensajes enviados fuera de una conversación abierta.

¿Puedo escribir a cualquiera que tenga mi número?

No. Necesitas el opt-in del destinatario y, fuera de la ventana de 24 horas, solo puedes enviar plantillas aprobadas. Si los usuarios te bloquean o te denuncian, Meta puede reducir el número de mensajes que puedes enviar.

¿Cuánto tarda la activación?

Con un proveedor que usa Embedded Signup, conectar el número lleva unos pocos pasos guiados. El tiempo total depende de la verificación del número, la revisión del nombre visible y la aprobación de las plantillas, que Meta indica que suele tardar hasta 24 horas.

Newsletter

¿Te ha resultado útil? Recibe las próximas guías

Un email al mes con nuestras nuevas guías sobre WhatsApp, IA y atención al cliente, y las novedades de Humassistant. Puedes darte de baja con un clic.

La newsletter llega igualmente. Este consentimiento se retira desde el enlace al pie de cada email, sin darse de baja.

Francesco Sganga

Escrito por

Francesco Sganga

Francesco Sganga es uno de los fundadores de Humassistant, la plataforma italiana que centraliza email, WhatsApp, teléfono, chat y redes sociales en una única bandeja de entrada. Escribe sobre inteligencia artificial aplicada a la comunicación empresarial, la atención al cliente y la automatización, siempre atento a las necesidades reales de las pymes.

Crea tu cuenta gratis.

Centraliza las comunicaciones de tu empresa en 5 minutos. Sin tarjeta de crédito.

Empieza gratis

¿Prefieres hablarlo antes? Reserva 15 minutos con nosotros →