Ricky logorickyDocs

Crear una plantilla

POST
/templates

Envía una plantilla a revisión de Meta desde la cuenta de negocio de channel_id. Responde la plantilla tal como la tiene Meta, por lo general PENDING; síguela con GET /templates/{template_id}. Un borrador que incumple una regla responde 400 con el primer problema; si Meta la rechaza, responde 422 rule_violation con su motivo.

Permiso: templates:write.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de cabecera

Idempotency-Key?string

Opcional. Un valor que eliges, único por escritura lógica, de 8 a 200 caracteres: un UUID o un ID de tu sistema, como order-10482-ready. Reintentar con la misma clave y el mismo cuerpo repite la primera respuesta en lugar de repetir la escritura.

Longitud8 <= length <= 200

Cuerpo de la solicitud

application/json
  1. body

Un borrador de plantilla. Ricky lo revisa como lo hace POST /templates/validate y luego lo envía.

channel_id*string

Canal de WhatsApp cuya cuenta de negocio será dueña de la plantilla.

Formatouuid
name*string

Letras minúsculas, dígitos y guiones bajos, empezando por una letra.

Patrón^[a-z][a-z0-9_]*$
Longitudlength <= 512
language*string

Código de idioma, por ejemplo es o en_US.

Patrón^[a-z]{2,3}(?:_[A-Z]{2})?$
category*string

UTILITY para novedades sobre algo que el cliente pidió; MARKETING en los demás casos.

Uno de"MARKETING""UTILITY"
parameter_format?string

Cómo se escriben las variables: {{first_name}} o {{1}}. No se puede cambiar después.

Predeterminado"NAMED"
Uno de"NAMED""POSITIONAL"
header?|||||

TEXT, IMAGE, VIDEO, DOCUMENT o LOCATION. Envía null para no tener encabezado.

body*

El texto del mensaje.

footer?|

Texto del pie, sin variables.

buttons?array<||>

Respuestas rápidas, hasta dos enlaces y un teléfono. Las respuestas rápidas no pueden ir entre los otros botones.

Elementositems <= 10

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

Una plantilla de mensaje de WhatsApp.

curl -X POST 'https://getricky.ai/api/v1/templates' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "channel_id": "8f3c2a5e-6b1d-4c7a-9e2f-1a2b3c4d5e6f",  "name": "pedido_listo",  "language": "es",  "category": "UTILITY",  "parameter_format": "POSITIONAL",  "body": {    "text": "Hola {{1}}, tu pedido {{2}} está listo para retirar.",    "examples": {      "1": "Ana",      "2": "10482"    }  },  "footer": "Casa Nativa",  "buttons": [    {      "type": "QUICK_REPLY",      "text": "Gracias"    }  ]}'
{  "data": {    "id": "1234567890123456",    "name": "pedido_listo",    "language": "es",    "category": "UTILITY",    "status": "APPROVED",    "whatsapp_business_account_id": "102030405060708",    "parameter_format": "POSITIONAL",    "components": [      {        "type": "BODY",        "text": "Hola {{1}}, tu pedido {{2}} está listo para retirar."      }    ]  }}