Enviar plantilla de mensaje tipo carrusel

Envía una plantilla de carrusel de WhatsApp aprobada definiendo el contenido de cada tarjeta.

API de Mensajería

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

Una vez que la plantilla de mensaje tipo carrusel de WhatsApp ha sido creada mediante la API y ha sido aprobada, el siguiente paso es enviar la plantilla a los usuarios finales a través de la API de mensajes.

POST https://api.getincloud.online/balerion/v3/messages

Parámetros del cuerpo (Whatsapp Message Request)

Campo	Tipo	Obligatorio	Descripción
placeholders	object	No	Aplica únicamente si el tipo BODY contiene campos personalizados. Objeto de campos personalizados que contienen el cuerpo del mensaje. Establece como parámetro el marcador configurado dentro de llaves dobles `{{...}}` al crear la plantilla y asigna el valor correspondiente. Los marcadores deben estar en el mismo orden en que se creó la plantilla. Ejemplo: para "Here is your {{code}}", establece `code: 34871`.
templateName	string	No	Nombre de la plantilla creada en tu cuenta de WhatsApp Business.
templateLanguage	string	No	Idioma de la plantilla definido al momento de su creación. La API soporta inglés, español y portugués. Es obligatorio si deseas enviar plantillas en un idioma diferente al inglés.
from	string	Sí	Número de teléfono del remitente. El número proporcionado durante la configuración de la cuenta WABA se utilizará como remitente. Solo acepta caracteres numéricos. No incluir el signo +.
to	string	Sí	Número de teléfono de destino para el mensaje de plantilla. Formato E.164 (incluye + y código de país).
type	string	No	Tipo de plantilla de mensaje que se envía. Para plantillas tipo carrusel, debe establecerse como `carousel`.
templateId	string	No	Identificador único de la plantilla de mensaje.
callbacks	array de strings	No	Sin descripción adicional en el manual.
cards	array de objetos	No	Arreglo que define el contenido de cada tarjeta del carrusel en el momento del envío. Cada objeto corresponde a una tarjeta definida en la plantilla del mensaje y debe seguir el mismo orden.

Idiomas soportados

English: en
Spanish: es
Portuguese: pt_BR, pt_PT

Respuestas

Código	Descripción
202 Accepted	La solicitud fue aceptada correctamente para su procesamiento.
400 Bad Request	La solicitud contiene errores o parámetros inválidos.
401 Unauthorized	Error de autenticación. Credenciales inválidas o token expirado.
410 Gone	El recurso solicitado ya no está disponible o la plantilla no es válida.
500 Internal Server Error	Error interno del servidor al procesar la solicitud.

AnteriorEnviar plantilla de mensaje multimedia SiguienteEnvío de Flow mediante plantilla de mensaje

¿Te sirvió esta página?