50% de descuento con el código BLACKFRIDAY5020% de descuento con el código BLACKFRIDAY20
Integraciones y APIGrowth / Pro o superior

API: listar y enviar plantillas de WhatsApp

Dos endpoints permiten que tu software use tus plantillas de WhatsApp. GET /api/v1/whatsapp/templates lista tus plantillas aprobadas, y POST /api/v1/whatsapp/send-template envía una a un cliente desde tu número predeterminado. Ambos necesitan una clave con acceso WhatsApp.

Dónde
Ask Menuthere support for a key
Plan
Necesita un número de WhatsApp Business conectado, que empieza en Starter / Pro.
Actualizado

Lista tus plantillas

curl 'https://menuthere.com/api/v1/whatsapp/templates' -H 'Authorization: Bearer ck_live_YOUR_KEY'

Devuelve las plantillas aprobadas de tu número predeterminado, para que sepas el nombre exacto y cuántos valores necesita cada una.

CampoSignificado
name, languageEl nombre de la plantilla y su código de idioma.
category, statusCategoría como MARKETING o UTILITY. El estado es APPROVED.
body_variablesCuántos valores {{n}} necesita el cuerpo.
has_header, header_formatSi tiene encabezado, y TEXT, IMAGE, VIDEO o DOCUMENT.

Envía una plantilla

POST /api/v1/whatsapp/send-template con un cuerpo JSON. El mensaje sale desde tu remitente predeterminado, que se define en Varios números y el número principal. No puedes elegir el número en la llamada.

CampoObligatorioQué es
toSíEl número del cliente con código de país.
template_nameSíEl nombre de la llamada de lista.
languageNoSe busca en la plantilla aprobada si lo omites.
body_paramsNoArreglo de valores para {{1}}, {{2}} y así sucesivamente, en orden.
header_paramsNoArreglo de valores para un encabezado de texto.
header_media_url, header_media_typeNoUn enlace y image, video o document para un encabezado multimedia.
button_paramsNoArreglo de valores para un botón de URL dinámica.
idempotency_keyNoUna referencia que tú eliges. id y un encabezado Idempotency-Key también funcionan.

Un envío exitoso devuelve ok: true, el message_id, el número to y status: "sent". Si envías de nuevo la misma clave de idempotencia, recibes el primer resultado con duplicate: true y no se envía nada dos veces. Un envío fallido libera la clave para que puedas reintentar.

Errores y límites

Estado`error`Significado
400missing_fields, invalid_json, invalid_number, template_errorFalta un campo obligatorio, el número parece incorrecto, o la plantilla no es adecuada para los valores que enviaste.
404template_not_foundNo hay ninguna plantilla aprobada con ese nombre en tu número predeterminado.
409recipient_opted_outEl cliente respondió STOP. No se envía ningún mensaje.
409in_progressUna solicitud con la misma clave de idempotencia sigue en curso.
412no_whatsapp_numberNo hay un número de WhatsApp predeterminado conectado.
429daily_limit_reached, rate_limitedSe agotó el límite diario de WhatsApp de tu número, o la clave superó su límite de solicitudes.
502send_failedNo se pudo contactar a WhatsApp. Inténtalo de nuevo.
Conviene saberCada envío por la API es un mensaje normal de WhatsApp, así que Meta lo cobra como cualquier otro. Consulta Cuánto cuestan los mensajes de WhatsApp. Una plantilla debe estar aprobada para poder enviarse. Consulta Plantillas de mensajes.

Preguntas

¿Puedo enviar un mensaje de texto normal por la API?
No. La API solo envía plantillas aprobadas, que además llegan a clientes fuera de la ventana de 24 horas.
¿Enviará un mensaje a alguien que se dio de baja?
No. Un cliente que respondió STOP se omite y la llamada devuelve recipient_opted_out.

¿No lo encuentras? Escribe a help@mail.menuthere.com o chatea con nosotros, de 9 a. m. a 9 p. m.Centro de ayudaPreciosmenuthere.com