WhatsApp API — Envíe mensajes de forma programática

Una API de WhatsApp completa para enviar texto, multimedia y gestionar conversaciones a través de una interfaz REST sencilla. Sin Puppeteer, sin navegador headless: WebSocket puro.

curl -X POST https://api2whats.com/send-text \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{"to": "971501234567", "message": "Hello from the API!"}'

¿Qué es una WhatsApp API?

Una WhatsApp API le permite enviar y recibir mensajes de WhatsApp desde su propio software. En lugar de abrir la app de WhatsApp en un teléfono y escribir los mensajes manualmente, su código realiza solicitudes HTTP a un endpoint de la API. La API gestiona la conexión con los servidores de WhatsApp, la entrega de mensajes, el seguimiento del estado y el reenvío de los mensajes entrantes.

Esto es útil para cualquier empresa que necesite comunicarse con sus clientes a gran escala. Confirmaciones de pedidos, actualizaciones de envío, recordatorios de citas, respuestas de soporte al cliente, campañas de marketing: todo esto puede automatizarse mediante una WhatsApp API. Los mensajes aparecen en el mismo chat de WhatsApp que los clientes ya utilizan, lo que significa que realmente los leen. Las tasas de apertura de los mensajes de WhatsApp suelen superar el 90%, en comparación con el 20% del correo electrónico.

El concepto es sencillo: su aplicación envía una solicitud HTTP al servidor de la API, el servidor de la API entrega el mensaje al destinatario a través de WhatsApp, y usted recibe una respuesta que confirma la entrega. Para los mensajes entrantes, la API los reenvía a su URL de webhook en tiempo real para que su sistema pueda procesarlos de inmediato.

Cómo funciona nuestra WhatsApp API

Nuestra API está construida sobre el protocolo de WhatsApp Web mediante conexiones WebSocket directas. Esto es fundamentalmente diferente de las soluciones que utilizan Puppeteer o navegadores headless para automatizar una interfaz web. WebSocket directo significa menor latencia, menor consumo de recursos y una fiabilidad significativamente mejor.

Cada instancia que cree mantiene una conexión WebSocket autenticada con los servidores de WhatsApp. Cuando envía un mensaje a través de la API, este viaja directamente por esa conexión WebSocket. No hay sobrecarga de renderizado de navegador, ni análisis de capturas de pantalla, ni manipulación frágil del DOM. La conexión es persistente y gestiona la reconexión automáticamente.

También operamos un pool de proxies SOCKS5 distribuido en múltiples regiones. Esto cumple dos propósitos: garantiza una conectividad fiable independientemente de dónde estén ubicados sus servidores, y distribuye las conexiones entre varias direcciones IP para evitar la limitación de solicitudes. Cada instancia se conecta a través de un proxy diferente, de modo que incluso si está ejecutando diez instancias simultáneamente, cada una tiene su propia ruta de conexión limpia.

Qué puede hacer con la API

Envío de mensajes de texto

El caso de uso más básico: enviar un mensaje de texto a cualquier número de WhatsApp. Los mensajes admiten Unicode, por lo que puede enviar texto en cualquier idioma, incluidos árabe, hindi, chino y emoji. Cada mensaje se entrega individualmente con seguimiento completo del estado de entrega.

Envío de multimedia

Vaya más allá del texto. Envíe imágenes, vídeos, documentos, archivos de audio y stickers. El multimedia puede proporcionarse como URL (la API lo descarga y lo entrega) o como datos codificados en Base64 para el envío en línea. Los documentos pueden ser PDF, archivos de Word, hojas de cálculo: cualquier tipo de archivo que WhatsApp admita.

Recibir mensajes vía webhooks

Cuando alguien envía un mensaje a su número conectado, la API lo reenvía a su URL de webhook como una solicitud POST. Usted recibe el número del remitente, el contenido del mensaje, cualquier archivo multimedia adjunto y la información de marca de tiempo. Su gestor de webhooks procesa el mensaje y puede desencadenar cualquier respuesta automatizada o flujo de trabajo.

Gestionar varios números

Cada plan admite varias instancias, lo que significa que puede conectar varios números de WhatsApp y gestionarlos todos desde un único panel de control. Cambie entre números mediante la API especificando el ID de la instancia en su solicitud. Esto es útil para empresas que operan en múltiples regiones o marcas.

Seguimiento del estado de los mensajes

Cada mensaje que envía recibe un ID único. Puede consultar el estado de cualquier mensaje: si está pendiente, enviado, entregado o leído. Los webhooks también envían las actualizaciones de estado en tiempo real, por lo que su sistema sabe en el momento en que un mensaje se entrega o se lee, sin necesidad de sondear.

Endpoints de la API

La API sigue un diseño REST limpio. Todos los endpoints aceptan y devuelven JSON. Estos son los endpoints principales:

• POST /send-text — Enviar un mensaje de texto
• POST /send-image — Enviar una imagen
• POST /send-video — Enviar un vídeo
• POST /send-document — Enviar un documento o archivo
• POST /send-audio — Enviar un archivo de audio
• POST /send-location — Enviar un pin de ubicación
• GET /message-status/{id} — Consultar el estado de entrega
• POST /set-webhook — Configurar su URL de webhook
• GET /instance/status — Consultar el estado de conexión

Cada endpoint requiere una clave de API enviada en la cabecera Authorization. Los límites de solicitudes se aplican según el plan, y la API devuelve mensajes de error claros con códigos de estado HTTP cuando algo falla.

Métodos de conexión

Conectar un número de teléfono a la API es sencillo. Admitimos dos métodos:

Conexión mediante código QR

Escanee un código QR desde su panel de control con la app de WhatsApp en su teléfono. Es el método más rápido: tarda unos 10 segundos. El código QR se actualiza automáticamente si no lo escanea a tiempo. Una vez escaneado, la conexión se establece y la instancia permanece en línea hasta que la desconecte.

Conexión mediante código de emparejamiento

Introduzca un código de emparejamiento numérico en su teléfono en lugar de escanear un código QR. Esto es útil cuando no puede escanear un código QR, por ejemplo, al conectar un número en un servidor remoto. El código de emparejamiento lo genera la API y caduca a los pocos minutos.

Lenguajes de programación compatibles

La API es independiente del lenguaje. Cualquier lenguaje capaz de realizar solicitudes HTTP puede utilizarla. Proporcionamos ejemplos de código listos para:

• PHP — Usar cURL o Guzzle
• Python — Usar la librería requests
• JavaScript — Usar fetch o axios (Node.js y navegador)
• cURL — Uso directo desde la línea de comandos
• Go — Usar net/http
• Java — Usar HttpURLConnection u OkHttp

Si su lenguaje puede enviar una solicitud HTTP POST con un cuerpo JSON, puede utilizar esta API. No es necesario instalar ningún SDK.

Flujo de entrega de mensajes

Entender cómo fluyen los mensajes por el sistema le ayuda a construir mejores integraciones. Cuando envía un mensaje, esto es lo que ocurre paso a paso:

1. Su aplicación envía una solicitud HTTP a la API con su clave de API y los datos del mensaje
2. La API valida su solicitud: comprueba la clave de API, verifica el formato del número de teléfono y confirma que la instancia está conectada
3. El mensaje se pone en cola para su entrega a través de la conexión WebSocket de la instancia correspondiente
4. El mensaje se transmite a los servidores de WhatsApp por la conexión WebSocket persistente
5. WhatsApp entrega el mensaje al teléfono del destinatario
6. La API recibe una confirmación de entrega de WhatsApp y actualiza el estado del mensaje
7. Si hay un webhook configurado, la actualización de estado se reenvía a su servidor

Todo el flujo desde su solicitud hasta la confirmación de entrega suele tardar entre 1 y 3 segundos. Las actualizaciones de estado (entregado, leído) pueden tardar más dependiendo de la conexión del destinatario y de cuándo abra el mensaje.

Gestión de instancias

Cada número de WhatsApp que conecta se denomina "instancia". Puede gestionar varias instancias desde un único panel de control y cambiar entre ellas mediante la API especificando el ID de la instancia. Cada instancia tiene su propio:

• API key — Token de autenticación único
• Connection status — Conectada, desconectada o reconectando
• Phone number — El número de WhatsApp asociado a la instancia
• Webhook URL — A dónde se reenvían los mensajes entrantes
• Message history — Registro de mensajes enviados y recibidos

Las instancias pueden crearse, desconectarse y eliminarse desde el panel de control o mediante la API. Cuando desconecta una instancia, la sesión de WhatsApp finaliza, pero puede reconectarse en cualquier momento sin perder sus datos.

Fiabilidad y disponibilidad

Mantenemos un SLA de disponibilidad del 99.9% en todos los planes. Nuestra infraestructura está construida para la fiabilidad:

• Automatic reconnection — Si una conexión WebSocket se interrumpe, la API se reconecta automáticamente en segundos
• Proxy failover — Si un servidor proxy tiene problemas, el tráfico se redirige a otro del pool
• Message queuing — Si la conexión con WhatsApp no está disponible temporalmente, los mensajes se ponen en cola y se entregan cuando la conexión se restablece
• Health monitoring — Monitorizamos todas las instancias 24/7 y abordamos los problemas de forma proactiva antes de que afecten a la entrega

La API solo devuelve un error 503 Service Unavailable cuando se han agotado todas las rutas de conexión, algo extremadamente raro. En la práctica, sus mensajes se entregarán incluso si componentes individuales sufren breves caídas.

Seguridad y privacidad

Toda la comunicación de la API está cifrada mediante HTTPS. Las claves de API se almacenan de forma segura con hashing bcrypt; nunca las almacenamos en texto plano. Sus URL de webhook se validan y todos los payloads de webhook están firmados para que pueda verificar que realmente provienen de nuestros servidores.

No tenemos acceso al contenido de sus mensajes salvo que usted lo reenvíe explícitamente mediante webhooks. Los mensajes entre usted y sus clientes permanecen privados. La conexión de WhatsApp utiliza cifrado de extremo a extremo para la capa de transporte de los mensajes.

Precios

Los planes comienzan en $9.99 al mes e incluyen un número determinado de solicitudes a la API por día, instancias y funcionalidades. No hay tarifas ocultas, ni cargos por mensaje, ni sorpresas por excesos. Puede actualizar o reducir su plan en cualquier momento desde su panel de control.

Aceptamos criptomonedas y tarjetas de crédito. El procesamiento de pagos se realiza a través de pasarelas seguras, y su información de pago nunca se almacena en nuestros servidores.

Casos de uso

Nuestra WhatsApp API se utiliza en una amplia variedad de industrias y aplicaciones. Estos son algunos de los casos de uso más comunes que construyen nuestros clientes:

• E-commerce — Confirmaciones de pedidos, actualizaciones de envío, notificaciones de entrega, estados de devolución y recordatorios de carritos abandonados
• Healthcare — Recordatorios de citas, notificaciones de renovación de recetas, entrega de resultados de laboratorio y seguimiento de pacientes
• Education — Confirmaciones de inscripción en cursos, fechas límite de tareas, resultados de exámenes y comunicación entre padres y profesores
• Real Estate — Alertas de propiedades inmobiliarias, confirmaciones de visitas, notificaciones de ofertas y comunicación con inquilinos
• Financial Services — Alertas de transacciones, entrega de facturas, recordatorios de pago y notificaciones de cuenta
• Restaurants — Confirmaciones de pedidos, recordatorios de reservas de mesa, recopilación de opiniones y ofertas promocionales
• Logistics — Actualizaciones de seguimiento de envíos, confirmaciones de entrega, asignación de conductores y notificaciones de almacén

Cualquier empresa que se comunique con sus clientes a través de WhatsApp puede beneficiarse de automatizar esas conversaciones mediante la API. La clave está en identificar qué mensajes son repetitivos y predecibles: esos son los que deberían automatizarse.

Cómo empezar

1. Cree una cuenta gratis — tarda 30 segundos
2. Elija el plan que se adapte a sus necesidades
3. Cree una instancia desde su panel de control
4. Conecte su número de teléfono mediante código QR o código de emparejamiento
5. Utilice su clave de API para enviar su primer mensaje

Si necesita ayuda para empezar, consulte nuestra documentación de la API o contacte con nuestro equipo de soporte.