Únase a la comunidad Slack
API de WhatsApp: Tipos, Acceso, Precios y Límites
// 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'
});¿Qué es la API de WhatsApp?
| Nombre | Qué es | Quién lo opera | Requisitos 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 escala | Meta | Aplicació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ón | Infraestructura de Meta, gestionada por BSP | Mismos 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 emparejamiento | Unipile, en nombre del usuario autenticado | Sin verificación de Meta Business, sin número nuevo, sin aprobación de plantillas |
¿Cuáles son los diferentes tipos de API de WhatsApp?
| Tipo | Aprovisionamiento | Ideal para | Funciona con una cuenta existente |
|---|---|---|---|
| API en la nube | Nuevo número de teléfono comercial + Verificación de Meta Business para mayor volumen | Empresas que envían marketing o notificaciones a gran escala | No, requiere un número nuevo |
| API local | Descontinuado. Meta lo retiró y promovió la migración a la API en la nube | Solo integraciones heredadas | No |
| Aplicación WhatsApp Business | Aplicación gratuita orientada al consumidor, configuración manual en un dispositivo | Pequeñas empresas que gestionan los chats manualmente | Sí, 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 nuevo | Plataformas SaaS que integran la propia cuenta de WhatsApp de cada usuario en el producto | Sí, este es el caso de uso principal |
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.
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.
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.
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.
¿Puedes integrar WhatsApp en tu propio software?
¿Cómo se obtiene acceso a la API de WhatsApp?
¿Qué necesitas antes de poder usar la API de WhatsApp Cloud?
¿Cuáles son los límites de la API de WhatsApp?
| Límite | Valor | Notas |
|---|---|---|
| Rendimiento | 80 mensajes / segundo | Tasa de envío a nivel de plataforma |
| Límite de velocidad de la API | 200 a 5.000 solicitudes / hora | Escala con el estado y la calidad de la cuenta |
| Límite de tasa de emparejamiento | 1 mensaje / 6 segundos | Por destinatario, evita el envío masivo de spam al mismo usuario |
| Nivel de mensajería | 250 → 2.000 → 10.000 → 100.000 → ilimitado | Destinatarios únicos por periodo móvil de 24 horas, comienza en 250 no verificados |
¿Se puede usar la API de WhatsApp con una cuenta existente de la aplicación personal o de Business?
¿Cómo se conecta una cuenta de WhatsApp con Unipile?
// SDK de Node.js
const { qrCodeString, code } = await cuenta.cliente.conectarWhatsapp();
// renderizar qrCodeString al usuario como una imagenPOST /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..."
}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..."
}{
"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"
}¿Qué se puede construir con la API de WhatsApp?
| Funcionalidad | Para qué sirve | Notas |
|---|---|---|
| Enviar mensajes | Texto, archivos multimedia, notas de voz, documentos | Notas de voz: .mp3/.m4a. typing_duration simula la escritura |
| Lista y sincronización de chats | Guarda cada conversación en tu propia base de datos | Paginación basada en cursores, filtrar por cuenta |
| Reaccionar a los mensajes | Añadir una reacción con emoji a un mensaje | WhatsApp y LinkedIn |
| Reenviar mensajes | Reenviar un mensaje a otro chat | Sólo WhatsApp |
| Editar / eliminar mensajes | Editar o eliminar un mensaje que enviaste | Eliminar: WhatsApp + LinkedIn. Editar: WhatsApp + LinkedIn Classic |
| Ganchos web en tiempo real | Eventos de inserción: recibido, reacción, leído, editado, eliminado, entregado | No se requiere votación |
Lista todos los chats de WhatsApp en tu programa
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..."
}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.
WhatsAppClásico
WhatsAppEmpresas
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.
LinkedIn
Gmail
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.
Lista todo Chats de WhatsApp en tu software
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.
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.
Mensajes
10 puntos finales disponibles
Conexión de cuentas
2 puntos finales disponibles
Archivos adjuntos
2 puntos finales disponibles
Webhooks
3 eventos disponibles
¿La API de WhatsApp admite mensajería grupal?
¿Qué herramientas y API de automatización de WhatsApp deberías usar en 2026?
| Perfil | Lo que necesitan | Enfoque recomendado |
|---|---|---|
| Integración de SaaS / CRM con cuentas propiedad del usuario | Cada usuario final conecta el WhatsApp (y a menudo LinkedIn, Instagram, correo electrónico) que ya tiene, dentro de su producto | API de sesión unificada, sin verificación de Meta por usuario |
| Difusión empresarial a gran escala | Un número comercial verificado que envía plantillas de marketing o de utilidad a una gran audiencia | la API en la nube de Meta directamente, o a través de un BSP |
| Prototipado de desarrolladores | La ruta más rápida posible hacia una integración funcional antes de comprometerse con la infraestructura | API de Sesión para cuentas propiedad de usuarios, espacio aislado (sandbox) de Cloud API para un solo número de empresa |
¿Cuáles son las mejores prácticas de la API de WhatsApp de Meta?
Adónde ir a continuación con la API de WhatsApp
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 |
| Criterios | API de Meta | 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.
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.
desea conectarse
Cuentas
03/01/2025
02/15/2025
02/10/2025
03/01/2025
02/28/2025
02/20/2025
03/01/2025
02/25/2025
03/01/2025
02/22/2025
02/14/2025
02/12/2025
02/08/2025
02/05/2025
03/01/2025
02/15/2025
03/01/2025
02/22/2025
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.
Casos de uso: Añadir WhatsApp a Tu Producto
Integra la mensajería nativa de WhatsApp en las herramientas que tus usuarios ya utilizan, desde ventas hasta reclutamiento y campañas de contacto multicanal.
CRM / Herramientas de ventas
Convierta las conversaciones en oportunidades. Lleve los mensajes de WhatsApp directamente a su CRM. Centraliza los chats de clientes, responde más rápido, comparte documentos o notas de voz y activa seguimientos automáticos, todo desde un mismo lugar sin cambiar de herramienta.
WhatsApp para CRMATS / Contratación
Conecte con los candidatos allí donde estén. Sincroniza las conversaciones de los candidatos en WhatsApp y gestiónalas en una bandeja de entrada compartida. Asigna conversaciones a compañeros de equipo, colabora fácilmente y mantén cada intercambio visible en tu ATS para acelerar las decisiones de contratación.
WhatsApp para ATSPlataformas de divulgación
Multicanal simplificado. Crea campañas que combinen WhatsApp, LinkedIn y correo electrónico en un flujo de trabajo unificado. Envía secuencias personalizadas, realiza un seguimiento de las respuestas en tiempo real y cumple las normativas mientras gestionas todas las conversaciones dentro de tu herramienta de difusión.
Herramienta WhatsApp for OutreachExplore 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.
Soporte de integración y recursos para el éxito de la API de WhatsApp
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.
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
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.
