API de WhatsApp para desarrolladores

Q: ¿Qué pasa si mando dos veces el mismo pedido?

Con el mismo Idempotency-Key el mensaje se manda una sola vez y la segunda respuesta devuelve el mismo identificador.

WAIA Connect es una API REST sobre la API oficial de WhatsApp de Meta (Cloud API y Coexistence). Mandás un POST /v1/messages con tu clave, nosotros lo encolamos y lo entregamos a Meta a un ritmo seguro, y los mensajes que entran te llegan a un webhook firmado. Proveedor de tecnología verificado por Meta, con documentación pública, OpenAPI y ejemplos en cuatro lenguajes.

Actualizado el 28 de septiembre de 2026.

Qué resuelve la API por vos

Cola de salida con reintentos: el envío se confirma con 202 y se entrega a Meta respetando el ritmo por número. Un rechazo de Meta queda en el estado del mensaje con un código estable.
Idempotencia: el encabezado Idempotency-Key evita mandar dos veces el mismo mensaje si reintentás.
Webhooks firmados con HMAC sobre fecha y cuerpo (protección contra reenvíos), y un encabezado estático opcional para herramientas sin código como n8n.
Plantillas: crearlas, sincronizarlas y validarlas antes de mandarlas a Meta, con el motivo y cómo arreglarlo si algo va a ser rechazado.
Media: enviar imagen, documento, audio y video por enlace, y descargar la media que entra por un proxy.
Errores de Meta traducidos a un catálogo de códigos estables, con qué hacer en cada caso.

Cómo se ve

Un envío es un pedido HTTP con tu clave de API. El número sale del identificador de conexión (conn_…) que te devuelve GET /v1/connections.

Ejemplos listos para copiar en cURL, Node.js, PHP y Python: Enviar un mensaje. Todo el contrato: OpenAPI.

Lo que no hace

No es una bandeja de chats para atender con un equipo: para eso está WAIA, nuestro producto llave en mano.
No guarda archivos: para mandar un archivo propio lo hospedás vos y mandás el enlace.
No te saca de las reglas de Meta: la ventana de 24 horas, las plantillas aprobadas y los límites de envío siguen valiendo. Te los explicamos en Antes de conectar.

Cuánto cuesta

Tarifa plana por número conectado, sin tope de mensajes. Empezás con 14 días de prueba; el plan más chico es Starter (US$ 12 por mes).

Starter — US$ 12 por mes, 1 número
Studio — US$ 25 por mes, 5 números
Agencia — US$ 45 por mes, 12 números
Escala — US$ 99 por mes, 30 números, y US$ 3 por cada número extra

Meta cobra aparte sus mensajes, a tu tarjeta; no les agregamos recargo. Comparación con quien sí lo hace: WAIA Connect vs Twilio.

Preguntas frecuentes

¿Usa la API oficial de Meta?

Sí. WAIA Connect es un proveedor de tecnología verificado por Meta y opera la Cloud API y la convivencia (Coexistence). No usa librerías no oficiales que simulan WhatsApp Web.

¿Cómo recibo los mensajes que entran?

Registrás una URL https y te llegan por POST, firmados con HMAC. La guía de verificación de la firma tiene ejemplos en cuatro lenguajes.

¿Qué pasa si mando dos veces el mismo pedido?

Con el mismo Idempotency-Key el mensaje se manda una sola vez y la segunda respuesta devuelve el mismo identificador.

¿Hay límite de mensajes por mes?

En WAIA Connect no: el plan se paga por número conectado. Meta sí tiene límites propios para iniciar conversaciones con plantillas, que dependen de tu cuenta de Meta.

¿La documentación está pensada para leerla con una IA?

Sí: cada módulo está también en Markdown, hay un llms.txt en la raíz del sitio y el contrato completo está en OpenAPI.

Para seguir leyendo

Conectá tu primer número hoy

Verificado por Meta como proveedor de tecnología. Coexistence en un click.

Empezar