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 | — | Filtrar por canal (número) |
status | string | — | Filtrar por estado: APPROVED, PENDING, REJECTED |
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",
"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 }
}
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_..."
Campos
| Campo | Tipo | Descripción |
|---|
id | string (UUID) | ID interno del template |
phoneNumberId | string | Canal al que pertenece |
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 | APPROVED, PENDING, REJECTED |
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 |