API REST v2

Construí lo que quieras

La API de Waspy te deja conectar WhatsApp Business con tu sistema, tu tienda o tu automatización. Moderna, documentada y pensada para que tu equipo la use en una tarde.

curl, JS, Python Bearer + scopes Webhooks HMAC Idempotencia
MENSAJES

Enviá WhatsApp desde tu sistema

Mandá mensajes de texto, plantillas aprobadas, imágenes, PDFs, audios y videos. Recibí el estado en tiempo real: enviado, entregado, leído.

  • Texto, plantillas, multimedia y botones
  • Idempotency-Key para evitar duplicados
  • Estados en tiempo real (sent, delivered, read, failed)
  • Origin tracking para saber qué sistema lo disparó
Terminal
curl -X POST https://api.waspytech.com/api/v2/messages \
  -H "Authorization: Bearer ${WASPY_API_KEY}" \
  -H "Idempotency-Key: pedido-48291-confirmado" \
  -H "Content-Type: application/json" \
  -d '{
    "channelId": "0a1b2c3d-...",
    "to": "+5491136582172",
    "type": "template",
    "template": {
      "name": "pedido_confirmado",
      "language": "es_AR",
      "variables": ["Laura", "48291", "29900"]
    }
  }'
CONTACTOS

Sincronizá tu base de clientes

Creá, actualizá y consultá contactos desde tu CRM, ERP o ecommerce. Usá atributos custom para segmentar después.

  • CRUD completo sobre la libreta de contactos
  • Atributos custom (CUIT, segmento, tag)
  • Consentimiento por canal (marketing / utility)
  • Búsqueda por teléfono, email o externalId
Terminal
curl -X POST https://api.waspytech.com/api/v2/contacts \
  -H "Authorization: Bearer ${WASPY_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+5491136582172",
    "name": "Laura Méndez",
    "externalId": "TN-12345",
    "optedIn": true,
    "attributes": {
      "segmento": "vip",
      "totalComprado": 184200
    }
  }'
CONVERSACIONES

Leé todo el historial que querés

Traé conversaciones, mensajes y adjuntos. Marcá como leído, dispará "escribiendo…" y cerrá tickets desde tu aplicación.

  • Listado paginado de conversaciones (cursor-based)
  • Mark-as-read v2 programático
  • Typing indicator desde tu sistema
  • Cierre y reapertura de tickets
Terminal
curl https://api.waspytech.com/api/v2/conversations?limit=50&cursor=eyJ... \
  -H "Authorization: Bearer ${WASPY_API_KEY}"

# Respuesta
{
  "data": [
    { "id": "c1...", "contactId": "ct...", "status": "open", "lastMessageAt": "2026-04-18T12:30:00Z" }
  ],
  "meta": { "requestId": "req_abc", "nextCursor": "eyJ..." }
}
PLANTILLAS

Trabajá con plantillas aprobadas por Meta

Listá plantillas de tu WABA, consultá su estado y enviá usándolas. Sincronización automática con la Cloud API.

  • Listado de plantillas por canal
  • Estado en vivo: approved, pending, rejected
  • Envío parametrizado con variables
  • Soporte de categorías Marketing, Utility y Authentication
Terminal
curl https://api.waspytech.com/api/v2/templates \
  -H "Authorization: Bearer ${WASPY_API_KEY}"

# Respuesta
{
  "data": [
    { "name": "pedido_confirmado", "language": "es_AR", "category": "UTILITY", "status": "APPROVED" },
    { "name": "promo_otono", "language": "es_AR", "category": "MARKETING", "status": "PENDING" }
  ]
}

Qué podés construir con Waspy API

Cualquier flujo donde WhatsApp sea parte de tu operación: ventas, logística, cobranza, soporte, alertas.

Avisos desde tu ERP

Conectá tu sistema de facturación para mandar recordatorios de pago, comprobantes y vencimientos por WhatsApp.

Automatizaciones con n8n / Make

Usá los endpoints de Waspy en tus flujos de n8n, Zapier o Make.com. Disparos sin escribir un backend.

Ecommerce custom

Si no usás Tienda Nube, conectá tu tienda propia: pedidos, envíos, devoluciones y carritos abandonados.

Dashboards internos

Extraé métricas de WhatsApp a tu BI: volumen, tiempos de respuesta, conversión por agente.

Apps para tu equipo

Armá un inbox custom, un CRM liviano o una app móvil interna usando Waspy como backend de WhatsApp.

Webhooks salientes

Recibí eventos en tiempo real con webhooks: mensajes entrantes, cambios de estado, nuevos contactos, altas y bajas de consentimiento.

Pensada para developers

Todo lo que esperás de una API moderna — y lo que hace falta para WhatsApp Business.

Documentación completa

Referencia con ejemplos en curl, JavaScript y Python. OpenAPI spec disponible.

Autenticación simple

API keys con scopes granulares. Revocá, rotá y auditá desde el panel.

Respuestas rápidas

Infra en GCP us-central1 con SLA de 99.9%. Respuestas típicas < 200 ms.

Rate limits claros

Headers estándar X-RateLimit-* en cada respuesta. Código 429 con Retry-After. Ver limitaciones.

Idempotencia nativa

Header Idempotency-Key en todos los POST. Nunca más un envío duplicado por reintento.

Webhooks firmados

HMAC-SHA256, retries con backoff, auto-disable si tu endpoint cae. Replay desde el panel.

Eventos en tiempo real con webhooks

Recibí cada mensaje entrante, cambio de estado y consentimiento en tu endpoint. Firmado con HMAC-SHA256, con reintentos con backoff y auto-disable si tu servidor cae.

POST https://tu-sistema.com/webhooks/waspy
{
  "event": "message.received",
  "timestamp": "2026-04-18T12:30:45Z",
  "data": {
    "messageId": "m_7f8a...",
    "conversationId": "c_a1b2...",
    "contact": {
      "phone": "+5491136582172",
      "name": "Laura Méndez"
    },
    "channel": { "id": "0a1b2c3d-...", "phoneNumber": "+5491155555555" },
    "content": { "type": "text", "text": "Hola, necesito cambiar mi pedido" }
  },
  "signature": "sha256=a3f2e1..."
}

HMAC-SHA256

Cada evento viene firmado con tu secreto. Verificá antes de procesar.

Reintentos automáticos

Si tu endpoint responde 5xx, reintentamos con backoff exponencial hasta 24 hs.

Replay desde panel

Volvé a disparar un evento si lo necesitás. Sin tocar código.

Estamos cerca mientras integrás

No te dejamos solo con la docs. Te acompañamos durante la implementación hasta que el primer mensaje viaje en producción.

Soporte técnico

Nuestro equipo responde dudas de implementación en menos de 24 hs hábiles.

Debugging asistido

Logs de requests, eventos de webhook y reintentos disponibles en el panel.

Feedback directo

Pedinos endpoints o mejoras. Las integraciones reales guían el roadmap.

Tu equipo integrando WhatsApp en 48 horas

Arrancá gratis, sin tarjeta. Leé la docs, pedí tu API key, mandá tu primer mensaje.