Cómo enviar mensajes con la API de MiSender

Endpoint

curl -X POST https://misender.com/api/v1/messages \\n  -H "Authorization: Bearer ms_live_TU_LLAVE" \\n  -H "Idempotency-Key: pedido-84721" \\n  -H "Content-Type: application/json" \\n  -d '{"to":"5215555555555","type":"text",\n       "text":{"body":"Tu pedido está listo"}}'

POST https://misender.com/api/v1/messages
Authorization: Bearer ms_live_...
Content-Type: application/json
Idempotency-Key: identificador-unico-de-la-operacion

Campos comunes

• to: teléfono internacional, sólo dígitos, de 10 a 15 caracteres.
• type: text, image, document, audio o template.
• external_id: identificador opcional de hasta 190 caracteres.
• metadata: objeto opcional de hasta 20 propiedades y 4 KB.

Enviar texto

Admite hasta 4,096 caracteres. preview_url controla la vista previa de enlaces.

{
  "to": "5215555555555",
  "type": "text",
  "text": {"body": "Tu pago fue confirmado.", "preview_url": false}
}

Enviar imagen

La URL debe ser HTTPS pública. El caption es opcional y admite hasta 1,024 caracteres.

{
  "to": "5215555555555",
  "type": "image",
  "image": {
    "link": "https://ejemplo.com/imagenes/comprobante.jpg",
    "caption": "Este es tu comprobante."
  }
}

Enviar documento

filename es obligatorio y admite hasta 255 caracteres.

{
  "to": "5215555555555",
  "type": "document",
  "document": {
    "link": "https://ejemplo.com/documentos/factura-84721.pdf",
    "filename": "factura-84721.pdf",
    "caption": "Tu factura está lista."
  }
}

Enviar audio

{
  "to": "5215555555555",
  "type": "audio",
  "audio": {"link": "https://ejemplo.com/audio/aviso.mp3"}
}

Ventanas de WhatsApp

Texto, imagen, documento y audio requieren una ventana válida de 24 horas o una ventana gratuita de entrada de 72 horas reconocida por MiSender. La regla se valida al aceptar la petición y nuevamente antes del envío.

Qué ocurre dentro de MiSender

La API localiza o crea el contacto, prepara la conversación, registra el mensaje en Inbox con estado queued y lo procesa en una cola separada. El envío aparecerá en la operación normal de MiSender.