Crear plantilla Meta

POST https://app.sendapp.ai/api/whatsapp-meta/create_template

Crea una plantilla de WhatsApp Meta y la envía a Meta para su aprobación. Pasa los campos simples (body, y los opcionales header/footer) y nosotros construimos los componentes; para plantillas avanzadas puedes pasar directamente el array components en formato Meta. En el body usa {{1}}, {{2}}… como variables.

La plantilla debe ser aprobada por Meta antes de poder enviarse. La aprobación puede tardar un tiempo.

Cabecera con un archivo (PDF, imagen o vídeo): primero sube el archivo con Subir media, luego pasa su URL en header_media_url y en los components pon un HEADER con format DOCUMENT (o IMAGE / VIDEO): el archivo llega a Meta como ejemplo para la aprobación. Un botón URL solo puede tener una parte variable al final del enlace ({{1}}), con un ejemplo en example. Mira el segundo ejemplo.

Parámetros

10 · 5 obligatorios

apikey obligatorio

Tu API Key.

token obligatorio

Token de la cuenta de WhatsApp Meta.

name obligatorio

Nombre de la plantilla: minúsculas, solo letras, números y guiones bajos.

category obligatorio

MARKETING o UTILITY.

body obligatorio

Texto del cuerpo (obligatorio si no pasas components).

language opcional

Código de idioma (por defecto it).

header opcional

Texto del encabezado (máx. 60 caracteres).

footer opcional

Texto del pie de página (máx. 60 caracteres).

components opcional

Array/JSON de componentes en formato Meta, para plantillas avanzadas.

header_media_url opcional

URL del archivo de la cabecera (PDF, imagen o vídeo) subido con Subir media. Hace falta cuando los components tienen un HEADER con un archivo.

¿Necesitas ayuda con la integración? info@sendapp.live

Solicitud

curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/create_template' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "name": "promo_estate",
    "category": "MARKETING",
    "language": "it",
    "header": "Oferta especial",
    "body": "¡Hola {{1}}, {{2}}% de descuento solo por hoy!",
    "footer": "Responde STOP para darte de baja"
  }'

# Plantilla con PDF en la cabecera y botón con enlace variable
curl -X POST 'https://app.sendapp.ai/api/whatsapp-meta/create_template' \
  -H 'Content-Type: application/json' \
  -d '{
    "apikey": "YOUR_API_KEY",
    "token": "YOUR_ACCOUNT_TOKEN",
    "name": "preventivo_pdf",
    "category": "UTILITY",
    "language": "it",
    "header_media_url": "https://cdn.sendapp.example/media/preventivo-esempio.pdf",
    "components": [
      { "type": "HEADER", "format": "DOCUMENT" },
      { "type": "BODY", "text": "Hola {{1}}, te adjuntamos tu presupuesto.", "example": { "body_text": [["Mario"]] } },
      { "type": "BUTTONS", "buttons": [
        { "type": "URL", "text": "Aviso de privacidad", "url": "https://example.com/privacy/{{1}}", "example": ["cliente-1042"] }
      ] }
    ]
  }'

<?php
$ch = curl_init('https://app.sendapp.ai/api/whatsapp-meta/create_template');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode([
        'apikey'   => 'YOUR_API_KEY',
        'token'    => 'YOUR_ACCOUNT_TOKEN',
        'name'     => 'promo_estate',
        'category' => 'MARKETING',
        'body'     => '¡Hola {{1}}, {{2}}% de descuento solo por hoy!',
    ]),
]);
echo curl_exec($ch);

const res = await fetch('https://app.sendapp.ai/api/whatsapp-meta/create_template', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apikey: 'YOUR_API_KEY',
    token: 'YOUR_ACCOUNT_TOKEN',
    name: 'promo_estate',
    category: 'MARKETING',
    body: '¡Hola {{1}}, {{2}}% de descuento solo por hoy!'
  })
});
console.log(await res.json());

Respuesta

{
  "status": "success",
  "message": "Template created successfully.",
  "template_id": "1234567890123456"
}

{
  "status": "error",
  "message": "The name can only contain lowercase letters, numbers and underscores."
}