Crear o actualizar una plantilla

Crea una nueva plantilla de mensaje de WhatsApp Cloud API o actualiza una existente.

POST https://api.getincloud.ai/v1/waba/templates

Crea una nueva plantilla de mensaje de WhatsApp Cloud API o actualiza una existente.

Las plantillas deben enviarse a WhatsApp para su aprobación antes de poder usarse.

La plantilla se creará en la cuenta de WhatsApp Business asociada al dispositivo.

Tras la creación, la plantilla tendrá el estado pending hasta que WhatsApp la revise y la apruebe.

Creación, actualizaciones y borradores:

• Crear: Para crear una nueva plantilla, proporciona name, language, category y components.

• Actualizar: Para actualizar una plantilla existente, incluye su id (ID de la base de datos) o templateId (ID de WhatsApp) en el cuerpo de la solicitud junto con los campos que quieras modificar.

• Modo borrador: Para guardar una plantilla como borrador sin enviarla a aprobación, establece draft: true en el cuerpo de la solicitud. Esto es útil para guardar el progreso antes de finalizar la plantilla.

Estructura de la plantilla:

Las plantillas se componen de componentes:

• HEADER: Encabezado opcional (texto, imagen, video, documento, ubicación)

• BODY: Cuerpo del mensaje obligatorio, con variables opcionales {{1}}, {{2}}, etc.

• FOOTER: Texto de pie de página opcional

• BUTTONS: Botones interactivos opcionales (respuesta rápida, enlace URL, llamada a un número de teléfono, etc.)

Categorías:

• MARKETING: Mensajes promocionales (requiere consentimiento previo)

• UTILITY: Actualizaciones de cuenta, transacciones, alertas

• AUTHENTICATION: Contraseñas de un solo uso y códigos de verificación

Nota: Este endpoint solo está disponible para dispositivos conectados mediante WhatsApp Cloud API.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y prueba la API con el probador en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Respuestas

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Create a simple text template
curl --request POST \
  --url https://api.getincloud.ai/v1/waba/templates \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"name":"welcome_message","language":"en","category":"UTILITY","draft":false,"components":[{"type":"BODY","text":"Hello {{1}}! Welcome to our service."}]}'


// Create template with header and buttons
curl --request POST \
  --url https://api.getincloud.ai/v1/waba/templates \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"name":"order_confirmation","language":"en","category":"UTILITY","draft":false,"components":[{"type":"HEADER","format":"TEXT","text":"Order Confirmation"},{"type":"BODY","text":"Your order {{1}} has been confirmed. Total: {{2}}"},{"type":"FOOTER","text":"Thank you for your purchase"},{"type":"BUTTONS","buttons":[{"type":"QUICK_REPLY","text":"Track Order"},{"type":"URL","text":"View Details","url":"https://example.com/orders/{{1}}","urlType":"DYNAMIC"}]}]}'