Enviar mensaje plantilla por WhatsApp

post

https://api-ws.wasapi.io/api/v1/whatsapp-messages/send-template

Este endpoint permite enviar mensajes preaprobados por WhatsApp (plantillas) a uno o más destinatarios. Se usa para iniciar o continuar una conversación.

Características principales:

Soporta hasta 20 destinatarios por envío
Permite variables dinámicas en el cuerpo, encabezado y botones
Soporta archivos multimedia en el encabezado
Permite controlar el estado del chatbot y la conversación

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Cuerpo de la plantilla de WhatsApp

recipients

string

required

Lista de destinatarios separados por coma. Puede ser números de teléfono (con código de país) o IDs de contactos existentes.

template_id

string

required

Identificador único de la plantilla aprobada por WhatsApp.

contact_type

string

enum

required

Define el tipo de destinatarios:

phone - El campo recipients contiene números de teléfono
contact - El campo recipients contiene IDs de contactos existentes en Wasapi

Allowed:

from_id

integer

ID del número de teléfono de Wasapi desde el cual se enviará el mensaje.

file

string

enum

Tipo de archivo a adjuntar en el encabezado de la plantilla:

document - Archivos PDF, DOC, XLS, etc.
video - Archivos MP4, MOV, etc.
image - Archivos JPG, PNG, etc.
audio - Archivos MP3, WAV, etc.

Allowed:

url_file

uri

URL del archivo a adjuntar en el encabezado de la plantilla. El archivo debe ser accesible públicamente.

file_name

string

Nombre personalizado para el archivo. Este campo solo funciona cuando el tipo de archivo es "document".

body_vars

array of objects

Variables para personalizar el cuerpo del mensaje. Cada variable debe coincidir con los placeholders definidos en la plantilla.

body_vars

header_var

array of objects

Variable para personalizar el encabezado del mensaje. Solo aplica si la plantilla tiene un encabezado configurado.

header_var

cta_var

array of objects

Variables para personalizar los botones de llamada a la acción. Solo aplica si la plantilla tiene botones configurados.

cta_var

chatbot_status

string

enum

Controla el comportamiento del chatbot para los contactos:

enable - Activa el chatbot para responder automáticamente
disable - Desactiva el chatbot por 24 horas
disable_permanently - Desactiva el chatbot permanentemente

Allowed:

conversation_status

string

enum

Define el estado de la conversación después del envío:

open - Inicia una nueva conversación o reabre una existente
hold - Pone la conversación en espera
closed - Cierra la conversación
unchanged - Mantiene el estado actual de la conversación

Allowed:

Responses

401

No autenticado - Token inválido o no proporcionado

500

Error interno del servidor

200Plantilla enviada exitosamente