Enviar un mensaje

Envía un mensaje a un contacto a través de uno de tus canales conectados.

POST/messages/send

Autenticación

Este endpoint se autentica con tu API key enviada en la cabecera X-API-Key (formato ek_live_...). Puedes gestionar tus API keys desde la sección Dev Tools del panel.

Pará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 número de WhatsApp desde el que se envía. Puedes copiarlo desde la sección Números de Teléfono del panel, o desde el campo id del número en la API.

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://eclectic-api-537143970188.us-central1.run.app/api/external/v2/messages/send" \
  -H "X-API-Key: ek_live_your_api_key_here" \
  -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.