Ricky logorickyDocs

Editar una plantilla

PATCH
/templates/{template_id}

Cambia la categoría o el contenido de una plantilla y la envía otra vez a revisión de Meta. Meta lo permite solo con plantillas APPROVED, REJECTED y PAUSED, y limita cuántas veces puede cambiar una aprobada; si no, responde 422 rule_violation. Una edición que mantiene un encabezado de imagen, video o documento envía header otra vez con un handle nuevo. Las plantillas con botones o componentes que el editor de Ricky no arma no se pueden editar aquí.

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 ruta

template_id*string

ID de la plantilla.

Patrón^[0-9]{1,32}$

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

Solo cambian las partes que envías; buttons reemplaza todos los botones. El nombre, el idioma y parameter_format no se pueden cambiar.

category?string

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

Uno de"MARKETING""UTILITY"
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 PATCH 'https://getricky.ai/api/v1/templates/string' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "body": {    "text": "Hola {{1}}, tu pedido {{2}} ya está listo. Te esperamos.",    "examples": {      "1": "Ana",      "2": "10482"    }  }}'
{  "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."      }    ]  }}