Enviar un mensaje
Envía un mensaje a un contacto a través de uno de tus canales conectados.
POST
/messages/sendParámetros obligatorios
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
to | String | Obligatorio | Número de teléfono o identificador de plataforma del destinatario. |
from | String | Obligatorio | Identificador del canal (p. ej. whatsapp). |
type | MessageType | Obligatorio | Tipo de mensaje a enviar. |
content | MessageContent | Obligatorio | Contenido del mensaje. |
channel_uuid | String | Obligatorio | UUID del canal usado para enviar el mensaje. |
Parámetros opcionales
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
template_uuid | String | Opcional | Identificador del mensaje de plantilla. |
optin_contact | Boolean | Opcional | Confirma el estado de opt-in del cliente. |
template_values | Array | Opcional | Valores para las variables de la plantilla. |
assigned_user | String | Opcional | Dirección de correo del responsable asignado. |
team_uuid | String | Opcional | UUID del equipo al que asignar la conversación. |
fields | String | Opcional | Campos adicionales separados por comas: contact, conversation. |
bot_status | String | Opcional | Estado del bot: bot_start o bot_end. |
metadata | Object | Opcional | Pares clave-valor personalizados (máx. 10 pares). |
Ejemplo de solicitud
bash
curl -X POST "https://api.try-eclectic.com/v1/messages/send" \
-H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
-H "Content-Type: application/json" \
-d '{
"to": "+31612345678",
"from": "whatsapp",
"type": "text",
"channel_uuid": "35f6f8cc-b550-4278-a2ea-099f3a4e0730",
"content": {
"text": "Hello!"
}
}'Ejemplo de respuesta
json
{
"message": {
"uuid": "adf3d1216d4c4dcd908199d6700f2381",
"status": "enqueued"
}
}Notas
- Fuera de la ventana de atención de 24 horas se requiere un mensaje de plantilla.
- Se admiten imágenes, documentos, audio y vídeo mediante un campo url dentro del objeto content.
- metadata acepta hasta 10 pares clave-valor; claves de hasta 50 caracteres, valores de hasta 500 caracteres.