API de WhatsApp 2026: Tipos, Acceso, Precios y Límites

Comisión Europea
Regulado por la UE Ley de Mercados Digitales
Nuestra solución se centra exclusivamente en la interoperabilidad de la mensajería, sin almacenamiento de perfiles ni scraping. Los clientes deben cumplir las condiciones de cada proveedor. Más información
Guía de la API de WhatsApp 2026

API de WhatsApp: Tipos, Acceso, Precios y Límites

Todo lo que la plataforma oficial de WhatsApp Business requiere y las partes que no cubre: cómo conectar una cuenta de WhatsApp para uso personal o una aplicación empresarial existente, mediante código QR o código de emparejamiento, sin verificación de Meta Business.
Prueba gratuita de 7 días, sin necesidad de tarjeta de crédito
Cuenta vinculada
Código QR, sin configuración de Meta
conectar-whatsapp.js
// Vincular una cuenta de WhatsApp existente
const cuenta = await cuenta.cliente.conectarWhatsapp();

// account.qrCodeString -> mostrar al usuario
// o pasar un pairing_phone_number en su lugar

const chats = await cliente.chats.list({
  tipo_de_cuenta: 'WHATSAPP'
});
Conectado, en nombre del usuario autenticado
Definición

¿Qué es la API de WhatsApp?

En API de WhatsApp no es un solo producto. Es un término general para tres formas diferentes de enviar y recibir mensajes de WhatsApp desde un software: la plataforma oficial de WhatsApp Business de Meta, un proveedor de soluciones comerciales que revende el acceso a la misma y una API de mensajería unificada que se conecta a una cuenta de WhatsApp que el usuario ya posee.
Los tres operan en última instancia en la propia red de WhatsApp, Meta es propietaria del protocolo, por lo que ninguna opción opera fuera de la infraestructura de Meta. Lo que difiere radicalmente entre ellos es el modelo de accesoya sea que estés configurando un número de empresa completamente nuevo bajo las reglas de Meta, o conectando una cuenta que ya existe.
NombreQué esQuién lo operaRequisitos de acceso
Plataforma de WhatsApp Business (API en la nube)La propia API oficial de Meta para aprovisionar nuevos números de teléfono comerciales y enviar mensajes de plantilla a escalaMetaAplicación de desarrollador de Meta, WABA, número de teléfono comercial, verificación para niveles superiores
Acceso como Proveedor de Soluciones Comerciales (BSP)Un tercero (Twilio, 360dialog y similares) que revende la misma Cloud API, integrada en su propio panel y sistema de facturaciónInfraestructura de Meta, gestionada por BSPMismos requisitos subyacentes de Meta, aprovisionados a través del BSP
API de sesión unificada (Unipile)Conecta una cuenta de WhatsApp, de empresa o personal, tal como lo hace WhatsApp Web, mediante código QR o código de emparejamientoUnipile, en nombre del usuario autenticadoSin verificación de Meta Business, sin número nuevo, sin aprobación de plantillas
El resto de esta guía cubre las tres, con un enfoque específico en la tercera opción, ya que es la que la mayoría de las guías existentes sobre la API de WhatsApp omiten por completo.
Orientación

¿Cuáles son los diferentes tipos de API de WhatsApp?

Actualmente existen cuatro formas prácticas de acceder a WhatsApp de manera programática: el API en la nube (la superficie oficial actual de Meta), la descatalogada API local, la Aplicación WhatsApp Business, y un API de sesión de terceros que conecta una cuenta que un usuario ya tiene.
TipoAprovisionamientoMejor paraFunciona con una cuenta existente
API en la nubeNuevo número de teléfono comercial + Verificación de Meta Business para mayor volumenEmpresas que envían marketing o notificaciones a gran escalaNo, requiere un número nuevo
API localDescontinuado. Meta lo retiró y promovió la migración a la API en la nubeSolo integraciones heredadasNo
Aplicación WhatsApp BusinessAplicación gratuita orientada al consumidor, configuración manual en un dispositivoPequeñas empresas que gestionan los chats manualmenteSí, pero de forma manual, un dispositivo, no mediante programación
API de sesión unificada (Unipile)Vincula la cuenta tal como lo hace WhatsApp Web, sin un número nuevoPlataformas SaaS que integran la propia cuenta de WhatsApp de cada usuario en el productoSí, este es el caso de uso principal
Las primeras dos filas son la infraestructura propia de Meta, construida en torno al aprovisionamiento de un nuevo número de empresa. La tercera es una aplicación manual operada por humanos sin una API real. La cuarta es donde se ubica una API unificada como Unipile: no compite con la Cloud API, resuelve un problema diferente, permitiendo que tus propios usuarios conecten la cuenta de WhatsApp que ya llevan en el bolsillo.
Meta también ha introducido una coexistencia limitada entre la aplicación WhatsApp Business y la API en la nube en el mismo número, por lo que un negocio puede conservar la aplicación para conversaciones manuales mientras un subconjunto del tráfico se ejecuta a través de la API en la nube. Sigue siendo un número propiedad de la empresa que cambia su forma de operar, no es lo mismo que un tercero conectando una cuenta que otro usuario individual ya posee. El tipo que importa para esta guía es el cuarto: es la única opción construida alrededor de la cuenta, no del número. Para una mirada más profunda sobre cómo ejecutar el tipo de API en la nube dentro de un producto multiinquilino, consulte nuestro Integración de la API de WhatsApp Cloud guía.

Ecosistema API de WhatsApp

Meta ofrece dos API oficiales que permiten a las empresas integrar WhatsApp en su software. Ambas están diseñadas para permitir el envío de mensajes de alto volumen, con funciones como mensajes predefinidos (plantillas), intercambio de medios y herramientas de atención al cliente.

Autoalojado

API de WhatsApp Business

La Business API fue la primera solución lanzada por Meta para ayudar a las empresas a interactuar con sus clientes en WhatsApp. Suele ser autoalojada o gestionada por un proveedor autorizado, lo que da a las empresas más control sobre la infraestructura. Admite mensajes salientes con plantillas, respuestas de clientes y formatos multimedia enriquecidos, lo que la hace adecuada para empresas que necesitan integrar WhatsApp directamente en su CRM, centro de contacto o sistema de soporte.

Mejor para empresas que integran WhatsApp en su propio CRM, centro de contacto o sistema de soporte.
Nube de Meta

API de WhatsApp en la nube

Lanzada más tarde, la API en la nube está totalmente alojada por Meta. Elimina la necesidad de que las empresas gestionen servidores o manejen una infraestructura pesada. La API en la nube ofrece funciones básicas similares, como el envío y la recepción de mensajes, la gestión de plantillas y la compatibilidad con medios, pero es más fácil de implementar para los desarrolladores. Se posiciona como una forma más rápida de acceder a WhatsApp mediante programación, especialmente para las empresas que desean escalabilidad sin la sobrecarga del alojamiento local.

Mejor para equipos que desean un despliegue más rápido sin administrar servidores ni alojamiento local.

La complejidad de la integración de WhatsApp

Si bien las API de Negocio y Nube de Meta proporcionan potentes capacidades, su integración está lejos de ser sencilla. Los desarrolladores deben gestionar la verificación comercial, las aprobaciones de plantillas y las cuotas de mensajes antes incluso de empezar a operar. Alojar o conectarse a la API de Nube también requiere gestionar webhooks, cifrado y el cumplimiento de estrictas reglas de opt-in (solicitud de consentimiento). Estos obstáculos a menudo retrasan los proyectos y limitan el acceso a los proveedores SaaS más pequeños que desean añadir WhatsApp rápidamente a sus plataformas.

Verificación de empresas Aprobaciones de plantillas Cuotas de mensajes Manejo de webhooks Cifrado Reglas de opt-in estrictas
Viabilidad

¿Puedes integrar WhatsApp en tu propio software?

Sí. Cualquier producto de software puede integrar la mensajería de WhatsApp. Hay tres formas distintas de hacerlo, y la correcta depende de si estás enviando desde un nuevo número de empresa o desde una cuenta que tu usuario ya posee.
1Construye directamente sobre la API Cloud de Meta. Adquieres un número de teléfono comercial, registras una aplicación de desarrollador de Meta y te integras con los propios puntos de conexión de Meta.
2Acudir a un Proveedor de Soluciones Empresariales. Un BSP proporciona el número y la cuenta de WhatsApp Business para usted y añade su propio panel o API por encima.
3Conecta cuentas existentes a través de una API unificada. Cada uno de sus usuarios vincula la cuenta de WhatsApp que ya tiene, sin número nuevo, sin verificación de Meta Business, en nombre de ese usuario autenticado.
Las siguientes secciones detallan cómo obtener acceso para cada ruta.
Requisitos previos

¿Qué necesitas antes de poder usar la API de WhatsApp Cloud?

La API de la nube de Meta requiere una cuenta de desarrollador de Meta, una cuenta de WhatsApp Business (WABA), un número de teléfono comercial dedicado que nunca haya estado activo en el WhatsApp normal y, más allá de cierto volumen, un negocio verificado de Meta.
Cuenta de desarrollador de Meta con una aplicación que tiene el producto de WhatsApp agregado
Cuenta de WhatsApp Business (WABA) creado dentro de esa aplicación
Un número de teléfono no activo actualmente en WhatsApp o WhatsApp Business
Verificación de empresas en Meta Business Manager, se requiere para desbloquear niveles de mensajería superiores a 250 destinatarios únicos por cada 24 horas
Plantillas de mensajes aprobadas para cualquier conversación iniciada por la empresa fuera de la ventana de servicio de 24 horas
Nada de esto se aplica si conectas una cuenta que tu usuario ya posee en lugar de aprovisionar un nuevo número, ya que no hay una nueva identidad comercial para que Meta la verifique. Más información sobre esto en la sección sobre cuentas personales y existentes abajo.
Proceso completo de verificación comercial paso a paso, documentos requeridos y tiempo de revisión típico: Guía de la API de WhatsApp sin verificación de empresa (próximamente en el clúster).
Límites

¿Cuáles son los límites de la API de WhatsApp?

Meta aplica tres límites diferentes en la plataforma de WhatsApp Business: un límite de rendimiento de 80 mensajes por segundo, un límite de tarifa de API por hora de 200 a 5000 solicitudes, y un nivel de mensajería que limita la cantidad de clientes únicos a los que puedes enviar mensajes en un período móvil de 24 horas.
LímiteValorNotas
Rendimiento80 mensajes / segundoTasa de envío a nivel de plataforma
Límite de velocidad de la API200 a 5.000 solicitudes / horaEscala con el estado y la calidad de la cuenta
Límite de tasa de emparejamiento1 mensaje / 6 segundosPor destinatario, evita el envío masivo de spam al mismo usuario
Nivel de mensajería250 → 2.000 → 10.000 → 100.000 → ilimitadoDestinatarios únicos por periodo móvil de 24 horas, comienza en 250 no verificados
Pasar a un nivel superior de mensajería requiere verificación de la empresa o un historial sostenido de envíos de calidad. Una vez que sea elegible, la ampliación al siguiente nivel puede ocurrir automáticamente si el uso se mantiene alto y la calidad se mantiene.
Ninguno de estos niveles de la API de Cloud se aplica a una conexión basada en sesiones. La velocidad de envío allí está limitada en su lugar por el comportamiento a nivel de cuenta de WhatsApp, y cómo se utiliza una cuenta sigue siendo una decisión del cliente.
Calidad, estrategia de respaldo (backoff) y gestión de errores 429 en detalle: Guía de límites de velocidad de la API de WhatsApp (próximamente en el clúster).
El diferenciador

¿Se puede usar la API de WhatsApp con una cuenta existente de la aplicación personal o de Business?

Sí. Ya sea para uso personal o para una cuenta de Business App, Unipile conecta la cuenta de WhatsApp existente del usuario autenticado de la misma manera que lo hace WhatsApp Web: mediante código QR o código de emparejamiento. Debido a que esa cuenta ya existe, ninguno de los requisitos previos de la API de Cloud de las secciones anteriores es aplicable.
Cada ruta descrita hasta ahora en esta guía, la API de Cloud y el acceso a BSP, asume que estás aprovisionando un número de teléfono comercial completamente nuevo. Ese es el modelo correcto para una empresa que transmite campañas de marketing o notificaciones automatizadas desde un número compartido. Es el modelo incorrecto para una plataforma SaaS, un CRM o una herramienta de bandeja de entrada cuyo objetivo real es permitir que cada uno de sus propios usuarios traiga la cuenta de WhatsApp que ya tiene, ya sea para uso comercial o personal, de la misma manera que ese producto podría permitir a un usuario traer su propia bandeja de entrada de Gmail o su propia cuenta de LinkedIn.
En la práctica, "API de WhatsApp para uso personal" es lo que la mayoría de las personas que la buscan realmente quieren decir: no una forma de saltarse las reglas de WhatsApp, sino una manera de conectar una cuenta que ya existe —el número de un fundador, el número de un representante de soporte, el WhatsApp propio de un freelancer— a un software sin que Meta lo trate como un nuevo despliegue empresarial. Una herramienta de reclutamiento que permite a cada reclutador enviar mensajes a los candidatos desde su propio número, una bandeja de entrada de soporte que unifica las cuentas de WhatsApp personales de un equipo, o una agencia que gestiona las conversaciones con los clientes desde números en los que estos ya confían, entran en esta categoría en lugar del modelo de difusión de la API Cloud.
Ese segundo modelo es para lo que está diseñada una conexión basada en sesión. Unipile vincula la cuenta reproduciendo el mismo flujo de autenticación que WhatsApp Web ya utiliza: un código QR escaneado desde el teléfono, o un código de emparejamiento introducido en la aplicación de WhatsApp cuando escanear no es práctico. Sin aplicación de desarrollador de Meta, sin cuenta de WhatsApp Business, sin migración de números de teléfono, sin plantillas de mensajes enviadas para aprobación.
Cómo conecta Unipile una cuenta existente
Unipile conecta cuenta de WhatsApp existente propia del usuario autenticado, mediante código QR o código de emparejamiento, y actúa en nombre de ese usuario. No hay verificación de Meta Business, ni WABA, ni aprobación de plantillas, porque no estás aprovisionando un nuevo número de empresa, estás conectando una cuenta que el usuario ya posee.
Unipile es un intermediario técnico independiente, no es socio de Meta o WhatsApp, y es no afiliado con, respaldado por o patrocinado por WhatsApp o Meta. Con qué frecuencia y cuántos mensajes se envían a través de una cuenta vinculada sigue siendo un decisión del lado del cliente, y el comportamiento a nivel de cuenta propio de WhatsApp sigue aplicándose.
Este es también el modelo que se escala a través de los canales. El mismo enfoque de cuenta vinculada que conecta WhatsApp funciona para LinkedIn, Instagram y Telegram, y para los buzones de Gmail, Outlook y IMAP, por lo que un producto que integra WhatsApp de esta manera puede añadir otro canal sin una segunda integración.
Conectar una cuenta existente
Implementación

¿Cómo se conecta una cuenta de WhatsApp con Unipile?

Conectar una cuenta de WhatsApp con Unipile requiere una llamada a la API y una acción del usuario: llamar al endpoint de cuentas con el proveedor de WhatsApp y, a continuación, hacer que el usuario escanee el código QR devuelto o introduzca el código de emparejamiento devuelto en su teléfono.
1Conectar por código QR
El flujo predeterminado. Muestra el código QR devuelto, el usuario lo escanea desde WhatsApp > Dispositivos vinculados.
connect-qr.js
// SDK de Node.js
const { qrCodeString, code } = await cuenta.cliente.conectarWhatsapp();
// renderizar qrCodeString al usuario como una imagen
2Conectar mediante código de emparejamiento
Para los flujos donde el escaneo no es práctico. Pase un número de teléfono en dígitos E.164.
connect-pairing.sh
POST /api/v1/accounts
X-API-KEY: tu_clave_de_api

{
  "proveedor": "WhatsApp",
  "número_de_teléfono_de_emparejamiento": "33612345678"
}

// 201 Creado
{
  "objeto": "CuentaCreada",
  "account_id": "e-ma1oQ..."
}
3Enviar un mensaje
Una vez vinculado, envía texto, contenido multimedia, notas de voz o documentos a cualquier chat.
enviar-mensaje.sh
POST /api/v1/chats/{chat_id}/messages
X-API-KEY: tu_clave_de_api

{
  "texto": "¡Hola! Su pedido ha sido enviado."
}

// 201 Creado
{
  "objeto": "MensajeEnviado",
  "id_de_mensaje": "msg_9f2c..."
}
4Escuchar nuevos mensajes con un webhook
Registra un webhook una vez, y cada mensaje nuevo se envía a tu punto de conexión en tiempo real, sin sondeos.
carga-util-webhook.json
{
  "account_id": "e-ma1oQ...",
  "tipo_de_cuenta": "WhatsApp",
  "evento": "mensaje_recibido",
  "chat_id": "chat_182...",
  "id_de_mensaje": "msg_9f2c...",
  "mensaje": "Hola, ¿este pedido sigue disponible?",
  "remitente": { "id_proveedor_asistente": "33612345678@s.whatsapp.net" },
  "timestamp": "2026-08-04T10:15:02Z"
}
Las mismas cuatro llamadas, connect, send, list y listen, funcionan de forma idéntica para LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP. Integras el patrón una sola vez. Para ver el flujo completo de vinculación de cuentas, incluidos los enlaces de wa.me y la gestión de reconexiones, consulta nuestro Flujo de vinculación de cuenta de WhatsApp guía.
Empezar a construir
Capacidades

¿Qué se puede construir con la API de WhatsApp?

Con una cuenta de WhatsApp vinculada, puedes enviar y recibir texto, archivos multimedia, notas de voz y documentos, listar y sincronizar cada chat en tu propia base de datos, reaccionar a los mensajes y reenvíarlos, y obtener entrega en tiempo real a través de webhooks, los mismos puntos de acceso que Unipile utiliza para LinkedIn, Instagram, Telegram, Gmail, Outlook e IMAP.
CapacidadPara qué sirveNotas
Enviar mensajesTexto, archivos multimedia, notas de voz, documentosNotas de voz: .mp3/.m4a. typing_duration simula la escritura
Lista y sincronización de chatsGuarda cada conversación en tu propia base de datosPaginación basada en cursores, filtrar por cuenta
Reaccionar a los mensajesAñadir una reacción con emoji a un mensajeWhatsApp y LinkedIn
Reenviar mensajesReenviar un mensaje a otro chatSólo WhatsApp
Editar / eliminar mensajesEditar o eliminar un mensaje que enviasteEliminar: WhatsApp + LinkedIn. Editar: WhatsApp + LinkedIn Classic
Ganchos web en tiempo realEventos de inserción: recibido, reacción, leído, editado, eliminado, entregadoNo se requiere votación
Guía completa paso a paso de solicitud y respuesta para enviar mensajes de WhatsApp: API de WhatsApp para enviar mensajes.

Lista todos los chats de WhatsApp en tu programa

Cada chat, ya sea personal o de una aplicación de negocios, se sincroniza a través del mismo punto de conexión. Filtra por cuenta y pagina con un cursor para extraer toda tu bandeja de entrada.
list-chats.sh
GET /api/v1/chats?account_id=e-ma1oQ...&account_type=WHATSAPP&limit=50
X-API-KEY: tu_clave_de_api

// 200 OK
{
  "objeto": "ChatList",
  "artículos": [
    {
      "id": "chat_182...",
      "account_id": "e-ma1oQ...",
      "nombre": "Jordan Miles",
      "recuento_no_leídos": 2,
      "archivado": falso
    }
  ],
  "cursor": "eyJsYXN0X2..."
}
Crea tu integración de WhatsApp

Cómo ayuda Unipile a los desarrolladores a conectar WhatsApp al instante con su software

Unipile ofrece una ruta alternativa para los vendedores de SaaS que desean integrar WhatsApp sin pasar por el programa oficial de socios de Meta. Somos no es socio de MetaEn su lugar, ofrecemos una API de mensajería unificada que permite a los desarrolladores conectar cuentas de WhatsApp personales o de empresa al instante mediante un flujo de autenticación por código QR. Este enfoque permite añadir WhatsApp junto a otros canales en tan solo unos pasos.

Su aplicación
MO
Michel Opra
LinkedIn Instagram WhatsApp Gmail Calendario de Google
Mensaje Correo electrónico Calendario
Actividades Nuevo
Gmail
Aquí está el contrato firmado
Hoy 15:08
Te envié el contrato
Hoy 13:02
Calendario de Google
Evento programado el lunes 5/2
Ayer 11:54
WhatsApp Clásico WhatsApp
Clásico
WhatsApp Negocios WhatsApp
Empresas
API de WhatsApp

Integración de Mensajería de WhatsApp con Unipile

Con Unipile, los desarrolladores pueden integrar todas las funciones principales de mensajería de WhatsApp directamente en su SaaS en unos pocos pasos. La API admite mensajes de texto sencillos, medios de comunicación y sincronización en tiempo real para que sus usuarios nunca se pierdan una interacción.

Mensajes de texto : envía y responde mensajes al instante.
Notas de voz : graba y envía mensajes de audio directamente en la conversación.
Medios compartidos : intercambia fotos, documentos y vídeos.
Historial y recibos de mensajes : sincroniza el historial de chat, enumera las reacciones y realiza un seguimiento de los recibos de lectura en tiempo real.
Ganchos web en tiempo real notificaciones instantáneas para cambios en el estado de la cuenta, nuevos mensajes, reacciones y confirmaciones de lectura.
Construir
Juan Rodríguez
Gmail
WhatsApp
LinkedIn LinkedIn
Gmail Gmail
JR
Mensaje de voz enviado
0:45
JR
Mensaje
Gracias John, revisaré los detalles y te responderé pronto.
Pin
Silenciar
Archivo
Responder a John por WhatsApp
Michel Opra
Juan Rodríguez
Alicia Smith
Emma Ward
Grupo Q1
Sesión de reclutamiento - Reino Unido - 16 personas
Michel Opra
Michel Opra
Hola a todos, bienvenidos a la sesión de reclutamiento.
Alicia Smith
Alicia Smith
Gracias Michel, por favor encuentra los detalles aquí.
Juan Rodríguez
Juan Rodríguez
Gracias Alicia, revisaré los detalles y te responderé pronto.
Responder al grupo por WhatsApp
Grupos de WhatsApp

Administrar grupos de WhatsApp con API de Unipile

La API de WhatsApp de Unipile permite a los desarrolladores integrar gestión de grupo completo directamente en sus aplicaciones. Sus usuarios pueden crear o unirse a grupos de WhatsApp, enviar y responder mensajes de grupo, y sincronizar conversaciones en tiempo real.

Ya sea que se trate de coordinar una sesión de reclutamiento, gestionar discusiones de ventas o dirigir la participación comunitaria, cada interacción grupal se puede centralizar dentro de su CRM o ATS. Con soporte para texto, imágenes, documentos y notas de voz, los equipos se mantienen conectados y productivos sin salir de su plataforma.

Crear y unirse a grupos
Mensajería de grupo
Sincronización en tiempo real
Construir
Su aplicación
Cuadro de mandos
Inbox
Contactos
Calendario
Recordatorios
Productos
Citas
Llamadas
Michel Opra
Michel Opra
Gracias.
Sofía Rivera
Sofía Rivera
Hola Sarah, soy española...
Daniel Martínez
Daniel Martínez
¿Cuándo lo conseguiste?
Gabriel López
Gabriel López
¿Puedes ayudarme con eso?
Elena García
Elena García
Estimada Sarah,
Natalia Díaz
Natalia Díaz
Así que, ¡depende de ti!
Víctor Harris
Víctor Harris
Soy Victor de Polonia.
Oscar Ward
Oscar Ward
¡Gracias por preguntar!
API de WhatsApp

Lista todo Chats de WhatsApp en tu software

Lista de todos los chats
GET
rizo --solicitar GET
     --url https://api1.unipile.com:13111/api/v1/chats
     --header 'accept: application/json'

La API de Unipile facilita la recuperación de todos los chats de WhatsApp vinculados a una cuenta de usuario. Ya sean mensajes individuales, discusiones grupales o hilos archivados, los desarrolladores pueden extraer la lista completa de conversaciones con una única solicitud. Esto asegura que tu plataforma SaaS pueda centralizar todas las interacciones de WhatsApp en tiempo real, brindando a los usuarios una experiencia de bandeja de entrada completa y unificada.

Unipile - Características de la API de WhatsApp
API de WhatsApp

Características de la API de WhatsApp con Unipile

Integra la mensajería de WhatsApp en tu CRM, ATS o herramienta de alcance con una única API. Sincroniza chats, grupos y contactos en tiempo real, en nombre de tus usuarios autenticados, sin salir de tu plataforma.

Explorar todos los puntos finales
Mensajes
Conexión a la cuentaCuenta
Archivos adjuntos
Webhooks

Mensajes

10 puntos finales disponibles

Enviar y responder mensajes
Enviar mensajes de voz
Enviar mensajes de vídeo
Lista de mensajes, chats y asistentes
Historial de sincronización
Reacciones
Borrar mensaje
Leer recibos
Crear grupo
Lista de grupos y contactos

Conexión de cuentas

2 puntos finales disponibles

Auth Alojada: marca blanca para conectar a sus usuarios finales
Autenticación personalizada: conecta usuarios con credenciales, cookies, tu extensión de Chrome

Archivos adjuntos

2 puntos finales disponibles

Enviar archivos adjuntos
Recibir archivos adjuntos

Webhooks

3 eventos disponibles

Estado de la cuenta
Nuevo mensaje
Nueva reacción / lectura / acontecimiento
Grupos

¿La API de WhatsApp admite mensajería grupal?

Sí. Meta añadió una API de Grupos oficial a la Plataforma de WhatsApp Business, pero viene con restricciones reales que la mayoría de los equipos no esperan.
OBA
Se requiere cuenta comercial oficial
8
Participantes máx. por grupo
10,000
Grupos máximo por número
Por mensaje
Facturado como cualquier otra conversación
No compatible: llamadas, mensajes temporales, visualización única, mensajes interactivos, comercio, plantillas de autenticación, ni editar o eliminar un mensaje de grupo. Las cuentas conectadas a Unipile siguen la propia mecánica de grupos nativa de WhatsApp en lugar de estas restricciones de Cloud API.
El comportamiento de los grupos difiere significativamente entre la API de Grupos de Meta y las conexiones basadas en sesiones. Análisis completo en nuestro Guía de la API de grupos de WhatsApp.
Perspectivas para 2026

¿Qué herramientas y API de automatización de WhatsApp deberías usar en 2026?

Depende de lo que estés construyendo. Una plataforma SaaS que integre el propio WhatsApp de cada usuario necesita una API unificada basada en sesiones. Una empresa que realice difusiones a gran escala necesita la API en la nube de Meta o un BSP. Un desarrollador que esté creando un prototipo de una idea necesita la opción que permita tener una integración funcional funcionando hoy mismo.
PerfilLo que necesitanEnfoque de ajuste óptimo
Integración de SaaS / CRM con cuentas propiedad del usuarioCada usuario final conecta el WhatsApp (y a menudo LinkedIn, Instagram, correo electrónico) que ya tiene, dentro de su productoAPI de sesión unificada, sin verificación de Meta por usuario
Difusión empresarial a gran escalaUn número comercial verificado que envía plantillas de marketing o de utilidad a una gran audienciala API en la nube de Meta directamente, o a través de un BSP
Prototipado de desarrolladoresLa ruta más rápida posible hacia una integración funcional antes de comprometerse con la infraestructuraAPI de Sesión para cuentas propiedad de usuarios, espacio aislado (sandbox) de Cloud API para un solo número de empresa
Estos no son mutuamente excluyentes. Algunos productos ejecutan ambos: un número de API en la nube para marketing saliente y una conexión basada en sesiones para la integración de cuentas dentro del propio producto.
Lo que cambió de cara a 2026 tiene menos que ver con nuevas API y más con la presión sobre la facturación y el acceso. El precio por mensaje recompensa la precisión por encima del volumen, por lo que las herramientas diseñadas para la difusión masiva necesitan una segmentación más estricta que bajo el antiguo modelo basado en conversaciones. Al mismo tiempo, la demanda de casos de uso personal —particulares y pequeños equipos que conectan una sola cuenta en lugar de aprovisionar un número comercial— sigue creciendo, razón por la cual las API basadas en sesiones han pasado de ser una solución alternativa de nicho a convertirse en una categoría principal por derecho propio.
Si WhatsApp es uno de varios canales que planeas admitir, una API unificada elimina la necesidad de integrar el SDK de cada proveedor por separado. Ver API multicanal para agentes de IA.
Buenas prácticas

¿Cuáles son las mejores prácticas de la API de WhatsApp de Meta?

Las mejores prácticas oficiales de Meta para la Plataforma de WhatsApp Business se centran en seis aspectos: obtener un consentimiento real, proteger tu calificación de calidad, utilizar la categoría de plantilla correcta, respetar la ventana de servicio de 24 horas, gestionar los errores de forma adecuada y mantenerse dentro de los límites de envío.
01
Consigue suscripciones reales
Solo envía mensajes a los usuarios que hayan aceptado explícitamente ser contactados por WhatsApp por tu empresa. Meta requiere una aceptación clara y verificable antes de enviar un mensaje de plantilla.
02
Proteja su calificación de calidad
Meta realiza un seguimiento de las tasas de bloqueo y denuncia por número de teléfono. Una calificación de baja calidad reduce tu nivel de mensajería y puede suspender el envío por completo.
03
Usa la categoría de plantilla correcta
Selecciona marketing, utilidad o autenticación con precisión al enviar. Las categorías que no coinciden hacen que las plantillas sean rechazadas o se cobren a la tarifa incorrecta.
04
Respete la ventana de servicio de 24 horas
Reserve las respuestas libres y sin plantilla para una ventana que el usuario abrió enviando un mensaje primero. Utilice plantillas aprobadas fuera de esa ventana.
05
Manejar los errores con retroceso
Implementa lógica de reintentos para errores de límite de tasa y transitorios en lugar de saturar la API en caso de fallo.
06
Manténgase dentro de los límites de velocidad
El uso excesivo y sostenido de los límites de rendimiento, por hora o por par, degrada tu calificación de calidad incluso antes de que alcances un bloqueo total.
Meta for Developers, documentación de la Plataforma de WhatsApp Business.
Ve más lejos

Adónde ir a continuación con la API de WhatsApp

Esta guía cubre toda la capa de orientación: qué es la API de WhatsApp, cómo obtener acceso, cuánto cuesta y cuáles son sus límites. Para profundizar en la implementación de un aspecto específico, el resto del clúster de WhatsApp de Unipile va más allá.
Próximamente en el clúster: guías dedicadas sobre los límites de la API de grupos de WhatsApp, la API de WhatsApp sin verificación comercial y los límites de velocidad de la API de WhatsApp.
Unipile - Por qué elegir Unipile
Meta vs Unipile

Por qué elegir Unipile en lugar de construir sobre Meta

Omite las limitaciones de las API de Meta. Así es como Unipile se compara en velocidad, esfuerzo y acceso, para que puedas concentrarte en construir en lugar de luchar con la configuración.

Criterios Meta API Unipile
Hora de integrarse Semanas o meses 2-3 días
Esfuerzo de desarrollo Alta Bajo (REST + SDKs)
Mantenimiento Manual Totalmente gestionado
Acceso a las prestaciones Parcial (previa aprobación) Completo, al instante
Ayuda Sólo autoservicio Equipo técnico especializado
Hora de integrarse
Meta APISemanas o meses
Unipile2-3 días
Esfuerzo de desarrollo
Meta APIAlta
UnipileBajo (REST + SDKs)
Mantenimiento
Meta APIManual
UnipileTotalmente gestionado
Acceso a las prestaciones
Meta APIParcial (previa aprobación)
UnipileCompleto, al instante
Ayuda
Meta APISólo autoservicio
UnipileEquipo técnico especializado
Criterios Meta API Unipile
Hora de integrarse Semanas/meses 2-3 días
Esfuerzo de desarrollo Alta Bajo (REST + SDKs)
Mantenimiento Manual Totalmente gestionado
Acceso a las prestaciones Parcial (previa aprobación) Lleno, ahora
Ayuda Sólo autoservicio Equipo técnico especializado

Integración rápida y simplificada

Con Unipile, la incorporación de WhatsApp sólo lleva unos minutos. Los desarrolladores pueden autenticar las cuentas mediante un código QR seguro, empezar a enviar y recibir mensajes de inmediato y beneficiarse de un soporte dedicado durante la configuración. Este enfoque reduce drásticamente el tiempo de comercialización, facilitando a los editores de SaaS el lanzamiento de nuevas funciones de mensajería.

Funciones completas de mensajería

La API Unipile proporciona acceso completo a las funciones esenciales de WhatsApp: envío y recepción de mensajes, notas de voz, imágenes, vídeos, documentos y sincronización de conversaciones en tiempo real. Todas las comunicaciones se centralizan en una bandeja de entrada unificada, lo que garantiza que no se pierda nada. Además de WhatsApp, la misma API conecta LinkedIn, Instagram, Telegram, Messenger, X/Twitter, Gmail y Outlook.

Cuadro de mandos unificado

Un cuadro de mandos para todas sus integraciones

Gestiona todas tus cuentas de LinkedIn, WhatsApp, Gmail y más desde una única e intuitiva interfaz.

/
Acme
/
Aplicación
Documentación
Referencia API
Registro de cambios
Conectar una nueva cuenta
Seleccione el tipo de cuenta que
desea conectarse
LinkedIn
LinkedIn
WhatsApp
WhatsApp
Instagram
Instagram
Telegrama
Telegrama
Google
Google
IMAP
IMAP
Microsoft
Microsoft
Calendario de Google
Calendario de Google
Calendario de Outlook
Calendario de Outlook

Cuentas

20 Operativo
0 Autenticación necesaria
0 Interrupción del servicio
0 En pausa
Nombre ID Estado Enlace
Operativo Enlazado en
03/01/2025
Operativo Enlazado en
02/15/2025
Operativo Enlazado en
02/10/2025
Operativo Enlazado en
03/01/2025
Operativo Enlazado en
02/28/2025
Operativo Enlazado en
02/20/2025
Operativo Enlazado en
03/01/2025
Operativo Enlazado en
02/25/2025
Operativo Enlazado en
03/01/2025
Operativo Enlazado en
02/22/2025
Operativo Enlazado en
02/14/2025
Operativo Enlazado en
02/12/2025
Operativo Enlazado en
02/08/2025
Operativo Enlazado en
02/05/2025
Operativo Enlazado en
03/01/2025
Operativo Enlazado en
02/15/2025
Operativo Enlazado en
03/01/2025
Operativo Enlazado en
02/22/2025
Pruébelo gratis
Demostración del panel de control
Autenticación por código QR de la API de WhatsApp para conectar dispositivos

Integración rápida de la API de WhatsApp con autenticación por código QR

Con Unipile, conectar una cuenta de WhatsApp sólo lleva unos minutos. El flujo es sencillo, seguro y evita el largo proceso de aprobación comercial de Meta. Así es como funciona:

1. Solicitar un código QR

Su aplicación genera un código QR único a través de la API de Unipile. Los usuarios solo tienen que escanearlo con WhatsApp para iniciar la autenticación.

2. Visualizar el código QR

El código QR puede mostrarse directamente en su aplicación utilizando bibliotecas estándar (PHP o JS). Los usuarios lo escanean con su teléfono para vincular su cuenta.

3. Confirmar autenticación

Una vez escaneado el código, el estado de la cuenta cambia a conectado. Puede escuchar este evento sondeando el estado de la cuenta o configurando un webhook para confirmación en tiempo real.

4. Iniciar mensajería

En cuanto la cuenta esté activa, podrás enviar y recibir mensajes de texto, compartir imágenes, vídeos, documentos y notas de voz. Los webhooks en tiempo real también te avisan de nuevos mensajes, reacciones y recibos de lectura.

Unipile - Casos de Uso WhatsApp

Explore más con
nuestra API de mensajería

Unipile no se detiene en WhatsApp. Nuestra API unificada también conecta con LinkedIn, Instagram, Messenger, X (Twitter) y Telegram. Al centralizar todos estos canales en un solo lugar, tus usuarios pueden gestionar todas las conversaciones a la perfección. Desde los mensajes de texto hasta los comentarios y los chats de grupo, todo está accesible en una única bandeja de entrada, lo que ayuda a los equipos a responder más rápido, realizar un seguimiento de la participación y ofrecer una experiencia de usuario coherente en todas las plataformas.

Unipile - Soporte e Integración de Recursos
API de WhatsApp

Soporte de integración y recursos para el éxito de la API de WhatsApp

Cofundadores de Unipile, CTO y CEO
Llamada de integración
Consiga una reunión a petición con nuestros fundadores (Director Técnico y Director General) para alinearse en la estrategia técnica y de producto.
Conectar con la asistencia en directo
Nuestra asistencia en directo está a su disposición antes, durante y después de la integración, garantizándole orientación en cada paso sin coste adicional.

Configuración técnica simplificada

Integra rápidamente funciones de mensajería de WhatsApp utilizando nuestra API completamente documentada y ejemplos de SDK. Ya sea para enviar mensajes, compartir medios o sincronizar conversaciones, nuestras herramientas están diseñadas para ayudarte a lanzar en días en lugar de semanas.

Asistencia experta para una implantación sin problemas

Nuestro equipo técnico trabaja directamente con sus desarrolladores para garantizar una integración perfecta. Desde la autenticación con código QR hasta la gestión de webhooks y la depuración de flujos de mensajes en tiempo real, los expertos de Unipile guían su integración en cada paso del camino.

Mejoras continuas y compatibilidad

Adaptamos continuamente nuestros puntos finales de la API de WhatsApp a las últimas actualizaciones. Esto garantiza que su producto se beneficie de las nuevas funciones sin cambios inesperados ni interrupciones. Estarás al día y cumplirás las normativas, sin gastos de mantenimiento.

Unipile - Pensamientos finales

Reflexiones finales

WhatsApp se ha convertido en un canal esencial para la participación del cliente, el soporte y las ventas, con miles de millones de usuarios activos en todo el mundo. Si bien las API oficiales de Business y Cloud de Meta brindan capacidades sólidas, a menudo conllevan complejidad: largas fases de incorporación, verificación comercial, cuotas y reglas de cumplimiento estrictas. Para muchos editores de SaaS, esto crea fricción y demoras en la entrega de valor a sus usuarios.

Unipile elimina estas barreras con un API de mensajería unificada que hace que la integración de WhatsApp sea rápida, segura y amigable para los desarrolladores. A través de una simple autenticación de código QR, las empresas de software pueden habilitar mensajes de texto, intercambio de medios, notas de voz y conversaciones grupales en cuestión de minutos, sin necesidad de convertirse en socio de Meta ni de alojar infraestructura. Los webhooks en tiempo real, la sincronización de mensajes y la compatibilidad multicanal garantizan una experiencia fluida en WhatsApp, LinkedIn, Instagram, Telegram, Gmail y Outlook.

Al elegir Unipile, las plataformas SaaS pueden ofrecer verdadera comunicación omnicanalUna API, una integración, un potencial ilimitado. Tanto si está creando un CRM, un ATS o una solución de divulgación, Unipile acelera su tiempo de comercialización, reduce los costes de mantenimiento y garantiza el cumplimiento de la Ley de Mercados Digitales.

Ahora es el momento de transformar WhatsApp en un potente activo para tu producto. Empieza a construir con Unipile hoy mismo y ofrece a tus usuarios la experiencia de comunicación que esperan.

API de WhatsApp - Preguntas frecuentes

Respuestas directas sobre uso personal, coste, límites y acceso, obtenidas de la propia documentación de Meta.
Sí. Eso es lo que API de WhatsApp para uso personal significa en la práctica: conectar una cuenta que ya posees. Unipile vincula la cuenta de WhatsApp existente propia del usuario autenticado, aplicación personal o de Negocios, mediante código QR o código de emparejamiento, y actúa en nombre de ese usuario, de la misma manera que lo hace WhatsApp Web. No hay verificación de Meta Business, ni WABA, ni aprobación de plantillas, porque no estás aprovisionando un nuevo número de empresa. La propia API en la nube de Meta, en contraste, está diseñada para empresas que aprovisionan un nuevo número, no para cuentas personales. Cómo se utiliza una cuenta vinculada posteriormente, la cadencia y el volumen, sigue siendo un decisión del lado del cliente. Unipile es un intermediario técnico independiente y es no afiliado con, respaldado por o patrocinado por WhatsApp o Meta.
El acceso a la API en sí no se cobra por mensaje por parte de Unipile más allá de su suscripción, pero Meta ha facturado la plataforma de WhatsApp Business por mensaje entregado desde el 1 de julio de 2025. Las plantillas de marketing y autenticación siempre se cobran. Las plantillas de utilidad y las respuestas de formato libre solo son gratuitas cuando se envían dentro de una ventana de servicio al cliente abierta de 24 horas. Ver Precios de la API de WhatsApp Business para la tarifa completa.
Depende de la ruta. La API en la nube de Meta autentica cada solicitud con un token de acceso permanente vinculado a tu aplicación de Meta y WABA. Una conexión basada en sesiones no utiliza ningún token de Meta: la cuenta se autentica una vez mediante un código QR o código de emparejamiento, y las solicitudes a Unipile se autentican con tu propia clave de API de Unipile.
No. "WhatsApp Business API" es el nombre anterior y general de toda la plataforma. La Cloud API es la superficie oficial actual que Meta aloja para ella, después de que Meta dejara en desuso la API local (On-Premise API). En el uso diario, los dos términos ahora se usan casi indistintamente para referirse a la misma plataforma alojada por Meta.
Depende completamente del camino. Una conexión basada en sesiones con una API unificada puede estar activa en minutos: crear una cuenta, escanear un código QR, empezar a enviar. La API en la nube de Meta toma más tiempo: crear una WABA, agregar un número de teléfono comercial y, para niveles de mensajería más altos, completar la verificación de Meta Business, lo cual puede tomar desde unos pocos días hasta unas pocas semanas por sí solo.
Solo para la API en la nube de Meta, y solo a partir de un cierto volumen. Una WABA no verificada aún puede enviar hasta 250 destinatarios únicos por cada 24 horas. Se requiere verificación para desbloquear niveles de mensajería superiores. Conectar una cuenta existente a través de una API basada en sesiones omite este requisito por completo, ya que no se está aprovisionando ningún número de empresa nuevo.
Sí. Tanto la API de Cloud como una conexión basada en sesiones entregan los mensajes entrantes a través de webhooks. Con Unipile, una cuenta de WhatsApp vinculada activa una mensaje_recibido evento de webhook en tiempo real, con el texto del mensaje, el remitente y los archivos adjuntos, para que nunca tengas que consultar nuevos mensajes.
Meta añadió una API de Grupos oficial a la Cloud API, limitada a 8 participantes por grupo y restringida a una Cuenta de Negocios Oficial. Las conexiones basadas en sesiones siguen el comportamiento de grupo nativo de WhatsApp en su lugar. Análisis completo en nuestro Guía de la API de grupos de WhatsApp.
Los precios de Meta varían según la categoría de la plantilla y el país del destinatario, y no se aplica una tarifa fija única. Como regla general, las plantillas de autenticación y marketing son las más caras, mientras que las de utilidad cuestan menos y, a menudo, son gratuitas dentro de una ventana de servicio abierta. Consulte nuestro Precios de la API de WhatsApp Business guía para números a nivel de país.
Meta limita la API de Cloud a aproximadamente 80 mensajes por segundo, de 200 a 5.000 solicitudes de API por hora dependiendo del estado de la cuenta, y un mensaje cada 6 segundos al mismo destinatario. Un nivel de mensajería también limita a cuántos clientes únicos puedes contactar en 24 horas, comenzando en 250 y aumentando con la verificación y la calidad.
Sí, de dos formas diferentes. Puedes integrarte directamente con la API en la nube de Meta como proveedor de tecnología registrado, sin pasar por un Proveedor de Soluciones Empresariales. O puedes omitir por completo la pila de la API en la nube y conectar una cuenta de WhatsApp existente a través de una API unificada basada en sesiones, que nunca fue territorio de BSP para empezar.
Sí, pero no de la misma manera. Meta ha introducido una coexistencia limitada entre la aplicación WhatsApp Business y la API en la nube en el mismo número, con restricciones. Una conexión basada en sesiones toma una ruta más sencilla: vincula la cuenta de la aplicación Business directamente, mediante un código QR o código de emparejamiento, de la misma manera que lo hace WhatsApp Web, sin una configuración paralela de la API en la nube.
¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.
Hable con un experto

También le puede interesar

linkedin search api amplifica el valor del usuario para los editores

linkedin search api amplifica el valor del usuario para los editores

LinkedIn, la mayor plataforma de redes profesionales del mundo, ofrece diversas herramientas y servicios para ayudar a los usuarios a conectarse, participar y hacer crecer sus redes. Entre ellos se encuentra la función LinkedIn API Search, que permite una integración perfecta de las funciones de búsqueda de LinkedIn en las aplicaciones. ¿Qué es...

leer más
Cómo enviar un mensaje a la API de LinkedIn desde una aplicación

Cómo enviar un mensaje a la API de LinkedIn desde una aplicación

Enviar Mensaje LinkedIn APIIntegrar las capacidades de mensajería de LinkedIn en tu aplicación puede mejorar significativamente la participación del usuario y agilizar la comunicación. Esta guía te guiará a través del uso de la API de LinkedIn para enviar mensajes directamente desde tu aplicación, detallando los pasos necesarios, herramientas y...

leer más
es_ESES