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.

Antes de empezar

Necesitás:
  1. Una cuenta de Waspy con un número de WhatsApp conectado
  2. Una API key (creala en Configuración → API Keys)

Paso 1: Verificar tu cuenta

Comprobá que tu cuenta está activa y tu número conectado:
curl https://api.waspytech.com/api/v2/account \
  -H "Authorization: Bearer wspy_tu_api_key"
Deberías recibir los datos de tu cuenta con el plan activo.

Paso 2: Obtener tu canal

Listá los números conectados para obtener el phoneNumberId:
curl https://api.waspytech.com/api/v2/channels \
  -H "Authorization: Bearer wspy_tu_api_key"
{
  "data": [
    {
      "id": "uuid-del-canal",
      "phoneNumber": "+5491155654076",
      "displayName": "Mi Tienda",
      "status": "connected"
    }
  ]
}
Copiá el id del canal. Lo vas a necesitar para enviar mensajes.

Paso 3: Enviar un mensaje

Los mensajes de texto libre solo se pueden enviar si el contacto escribió en las últimas 24 horas (ventana de servicio). Si no, usá un template. Ver Ventana de servicio.

Enviar un template (funciona siempre)

curl -X POST https://api.waspytech.com/api/v2/messages \
  -H "Authorization: Bearer wspy_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumberId": "uuid-del-canal",
    "to": "+5491126032641",
    "type": "template",
    "template": {
      "name": "hello_world",
      "language": { "code": "es_AR" }
    }
  }'

Enviar texto libre (requiere ventana activa)

curl -X POST https://api.waspytech.com/api/v2/messages \
  -H "Authorization: Bearer wspy_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumberId": "uuid-del-canal",
    "to": "+5491126032641",
    "type": "text",
    "text": "Hola! Este mensaje fue enviado desde la API."
  }'

Paso 4: Verificar el envío

Consultá el estado del mensaje con el id que recibiste:
curl https://api.waspytech.com/api/v2/messages/MSG_ID \
  -H "Authorization: Bearer wspy_tu_api_key"
Los estados posibles son: queuedsentdeliveredread (o failed).

Próximos pasos

Enviar templates

Usá templates con variables dinámicas.

Gestionar contactos

Creá y actualizá contactos desde tu sistema.