WhatsApp
Enviar mensaje de plantilla de WhatsApp
Envía un mensaje de WhatsApp usando una plantilla aprobada a través de Famulor
POST
Envía un mensaje de WhatsApp usando una plantilla de Meta preaprobada a través de tu remitente de WhatsApp de Famulor. Los mensajes de plantilla son obligatorios al iniciar una conversación con un usuario por primera vez o al enviar mensajes fuera de la ventana de mensajería de 24 horas.
Este endpoint está limitado a 5 solicitudes por segundo por usuario.
Cuerpo de la solicitud
integer
requerido
El ID del remitente de WhatsApp desde el que enviar (obtenido del endpoint Obtener remitentes)
integer
requerido
El ID de la plantilla de mensaje a usar (obtenido del endpoint Obtener plantillas)
string
requerido
El número de teléfono del destinatario en formato internacional (p. ej.,
+1234567890)string
El nombre del destinatario, máx. 255 caracteres (se usa para el seguimiento de conversaciones y para fines de CRM)
object
Pares clave-valor para las variables de la plantilla. Las claves deben coincidir con los nombres de variable de la plantilla. Si la plantilla tiene las variables
{{1}}, {{2}}, etc., proporciónalas como {"1": "value1", "2": "value2"} o usando los nombres de clave del array variables de la plantilla.Campos de la respuesta
boolean
Indica si el mensaje se envió correctamente
integer
El ID de la conversación (nueva o existente) asociada a este mensaje
integer
El ID del registro de mensaje de la conversación
integer
El ID del registro de mensaje de WhatsApp
string
El SID de mensaje de Twilio para el seguimiento de la entrega
string
El estado inicial de entrega del mensaje (p. ej.,
queued, sent)Respuestas de error
Notas
- Los mensajes de plantilla deben usar plantillas aprobadas. Las plantillas con estado
pendingorejectedfallarán. - El remitente debe estar
online. Los remitentes desconectados no pueden enviar mensajes. - El coste de los mensajes se deduce automáticamente del saldo de tu cuenta de Famulor (créditos para usuarios de tenant, minutos para usuarios directos).
- Después de enviar un mensaje de plantilla, se abre una ventana de mensajería de 24 horas. Durante esta ventana, puedes enviar mensajes de texto libre sin necesidad de una plantilla.
- Si ya existe una conversación con el destinatario, el mensaje se añade a la conversación existente.
- Límite de frecuencia: 5 solicitudes por segundo por usuario.