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.
GET /templates
Lista las plantillas de WhatsApp disponibles en tu cuenta. Las plantillas deben estar aprobadas por Meta para poder usarse.
Scope requerido: templates:read
Parámetros
| Parámetro | Tipo | Default | Descripción |
|---|
page | number | 1 | Página |
pageSize | number | 20 | Resultados por página (máx 100) |
phoneNumberId | string (UUID) | — | Filtrar por canal |
status | string | — | Filtrar por estado: pending, approved, rejected, disabled, paused |
Request
curl "https://api.waspytech.com/api/v2/templates?status=approved&pageSize=50" \
-H "Authorization: Bearer wspy_..."
Response 200
{
"data": [
{
"id": "template-uuid",
"phoneNumberId": "channel-uuid",
"metaTemplateId": "1234567890",
"name": "confirmacion_pedido",
"language": "es_AR",
"category": "UTILITY",
"status": "approved",
"components": [
{
"type": "BODY",
"text": "Hola {{1}}, tu pedido {{2}} fue confirmado."
}
],
"createdAt": "2026-03-15T10:00:00.000Z"
}
],
"meta": { "requestId": "...", "page": 1, "pageSize": 50, "total": 12 }
}
phoneNumberId puede ser null para templates “globales” (no atados a un canal específico). metaTemplateId es el ID del lado de Meta — útil si gestionás los mismos templates desde Meta Business Manager.
GET /templates/:id
Obtener un template por ID.
Scope requerido: templates:read
curl https://api.waspytech.com/api/v2/templates/TEMPLATE_ID \
-H "Authorization: Bearer wspy_..."
GET /templates/by-name/:name
Resolver un template por su nombre aprobado (el mismo string que pasás a POST /messages en template.name). Útil cuando tu integración conoce el nombre (ej. confirmacion_pedido) pero no el UUID interno.
Scope requerido: templates:read
| Query | Descripción |
|---|
language | Filtrar por idioma (ej: es_AR, en_US) |
phoneNumberId | Desambiguar cuando el mismo nombre existe en múltiples canales |
curl "https://api.waspytech.com/api/v2/templates/by-name/confirmacion_pedido?language=es_AR" \
-H "Authorization: Bearer wspy_..."
Campos
| Campo | Tipo | Descripción |
|---|
id | string (UUID) | ID interno del template |
phoneNumberId | string | null | Canal al que pertenece, o null para templates globales |
metaTemplateId | string | null | ID del template en Meta Business Manager |
name | string | Nombre del template en Meta |
language | string | Código de idioma (ej: es_AR, en_US) |
category | string | MARKETING, UTILITY, AUTHENTICATION |
status | string | pending, approved, rejected, disabled, paused |
components | array | Componentes del template (HEADER, BODY, FOOTER, BUTTONS) |
Solo los templates con status approved se pueden usar para enviar mensajes. Si intentás usar uno que no está aprobado, recibís un error de Meta.
Categorías
| Categoría | Uso | Costo Meta |
|---|
UTILITY | Confirmaciones, tracking, actualizaciones de pedido | Menor costo |
MARKETING | Promociones, ofertas, reactivación | Mayor costo |
AUTHENTICATION | Códigos de verificación, OTP | Menor costo |