Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.waspytech.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Base URL

https://api.waspytech.com/api/v2

​
Autenticación

Todas las requests requieren Authorization: Bearer <api_key>. Ver Autenticación.

​
Recursos disponibles

Account

Información de tu cuenta y plan.

Channels

Números de WhatsApp conectados.

Contacts

Crear, listar y actualizar contactos.

Conversations

Consultar conversaciones, marcar como leído, enviar typing indicator.

Messages

Enviar mensajes y consultar estado. Incluye campo origin para handoff.

Templates

Listar y consultar plantillas aprobadas.

Media

Resolver mensajes con media (audio, imagen, video) a URLs descargables.

Webhooks

Suscribirse a eventos en tiempo real (mensajes entrantes, status, etc).

​
Integración reactiva (webhooks)

Para bots y CRMs que necesiten reaccionar a eventos en tiempo real (no polling), Waspy entrega POST HTTP firmados a tu URL:
  • 4 eventos: message.received, message.status_changed, conversation.created, contact.created
  • Firma HMAC-SHA256 en header X-Waspy-Signature
  • Reintentos automáticos con backoff exponencial
  • Distinción de origen (message.origin) para implementar handoff humano sin que tu bot pise a un agente
Ver Webhooks: Introducción para el detalle.

​
Convenciones

  • Los IDs son UUIDs v4.
  • Las fechas están en formato ISO 8601 con timezone UTC.
  • Los números de teléfono incluyen código de país con + (ej: +5491126032641).
  • Las respuestas siempre incluyen meta.requestId.

​
Limitaciones conocidas

Para que sepas exactamente qué se puede y qué no se puede hacer hoy: ver Limitaciones.