v1

latestOpenAPI 3.0.3Proprietary2026-08-0610636149.4 KB

Crear plantilla WhatsApp

Envía una nueva plantilla para aprobación del proveedor (Meta/Gupshup). El resultado inicial queda en estado pending; al aprobarse pasa a approved.

Plantillas con media (type IMAGE / VIDEO / DOCUMENT) → flujo de dos pasos:

Subí el archivo con POST /v1/whatsapp/{channelId}/template-media (multipart). Devuelve un mediaId.
Llamá a este endpoint incluyendo ese mediaId en el body.

Para plantillas de texto (type: TEXT) es un solo paso: omití mediaId.

post/v1/whatsapp/{channelId}/templates

Path parameters

channelIdstring required

Request body

namestring required

Identificador único de la plantilla dentro del canal.

languageCodestring required

category'MARKETING' | 'UTILITY' | 'AUTHENTICATION' required

type'TEXT' | 'IMAGE' | 'VIDEO' | 'DOCUMENT' required

textstring required

Cuerpo de la plantilla con placeholders posicionales {{1}}, {{2}}, … (numerados por orden de aparición). Al enviar el mensaje se reemplazan por los valores posicionales del array variables. Formato válido para ambos proveedores: Meta lo exige así y Gupshup lo normaliza.

mediaIdstring

Handle devuelto por POST /v1/whatsapp/{channelId}/template-media. Requerido cuando type es IMAGE, VIDEO o DOCUMENT; omitir para TEXT.

buttonsobject[]

Example request

{
  "name": "registro_cliengo",
  "languageCode": "es",
  "text": "Hola {{1}}, tu código es {{2}}"
}

Response

Plantilla creada (pendiente aprobación)

idinteger

ID interno de la plantilla

elementNamestring

Nombre identificador de la plantilla

status'APPROVED' | 'PENDING' | 'REJECTED'

Estado de aprobación en Meta

category'MARKETING' | 'UTILITY' | 'AUTHENTICATION'

Categoría de la plantilla

textstring

Contenido del mensaje con variables ({name}, {1}, etc.)

languagestring

Código de idioma (es, en, pt, etc.)

componentsobject[]

Componentes de la plantilla (header, body, botones) según el formato de Meta.

Example response

{
  "id": 170,
  "elementName": "promo_belleza_personalizada"
}