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.

Waspy entrega eventos a tu URL como POST HTTP firmado. Es la forma recomendada de integrar bots y CRMs externos: te enterás del evento en cuanto sucede, sin necesidad de hacer polling.

​
Eventos soportados

EventoCuándo dispara
message.receivedLlega un mensaje entrante de un contacto
message.status_changedCambia el estado de un mensaje saliente (sent, delivered, read, failed)
conversation.createdSe crea una conversación nueva
contact.createdSe crea un contacto nuevo

​
Crear una suscripción

curl -X POST https://api.waspytech.com/api/v2/webhooks \
  -H "Authorization: Bearer wspy_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-bot.example.com/webhook/waspy",
    "events": ["message.received", "message.status_changed"],
    "description": "Bot de soporte"
  }'
Respuesta 201 (el secret se devuelve una sola vez — guardalo): 
{
  "data": {
    "id": "uuid",
    "url": "https://tu-bot.example.com/webhook/waspy",
    "events": ["message.received", "message.status_changed"],
    "secret": "whsec_abc123...",
    "enabled": true,
    "createdAt": "2026-04-19T12:00:00.000Z"
  },
  "meta": { "requestId": "..." }
}
Scopes requeridos: webhooks:read para listar/consultar, webhooks:write para crear/actualizar/borrar/test/replay.

​
Aislamiento por tenant

Cada suscripción está atada a tu API key, y por lo tanto a tu tenant. Solo recibís eventos de tu propia cuenta. Nunca ves datos de otros tenants.

​
Reintentos y auto-disable

Si tu URL devuelve un código no-2xx o no responde en 10s, Waspy reintenta automáticamente:
IntentoEspera antes
21 minuto
35 minutos
430 minutos
52 horas
(último)12 horas
Después de 10 entregas consecutivas fallidas la suscripción se auto-desactiva (enabled: false, disabledReason poblado). Para reactivarla, hacé PATCH /webhooks/:id con enabled: true.

​
Probar antes de producción

curl -X POST https://api.waspytech.com/api/v2/webhooks/{id}/test \
  -H "Authorization: Bearer wspy_..."
Esto encola un evento sintético message.received con datos dummy para que validés tu firma + URL.

​
Próximos pasos