Documentación de la API de LeoChats

Este endpoint te permite enviar mensajes de texto y notificaciones instantáneas a cualquier número de WhatsApp en el mundo. Requiere autenticación mediante Bearer Token en la cabecera HTTP Authorization: Bearer <TU_API_KEY>.

Ejemplos de Integración Rápida

curl -X POST "https://api.leotaucomunicaciones.com/api/v1/messages/send.php" \
  -H "Authorization: Bearer lc_live_tu_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "573101234567",
    "text": "Hola! Tu factura del mes ha sido generada exitosamente."
  }'

<?php
$payload = [
    'to'   => '573101234567',
    'text' => 'Hola! Tu factura del mes ha sido generada exitosamente.'
];

$ch = curl_init('https://api.leotaucomunicaciones.com/api/v1/messages/send.php');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer lc_live_tu_api_key_aqui'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['success']) {
    echo "Mensaje enviado! ID: " . $result['message_id'];
} else {
    echo "Error: " . $result['message'];
}
?>

import requests

url = "https://api.leotaucomunicaciones.com/api/v1/messages/send.php"
headers = {
    "Authorization": "Bearer lc_live_tu_api_key_aqui",
    "Content-Type": "application/json"
}
data = {
    "to": "573101234567",
    "text": "Hola! Tu factura del mes ha sido generada exitosamente."
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

const axios = require('axios');

async function sendWhatsApp() {
  try {
    const res = await axios.post('https://api.leotaucomunicaciones.com/api/v1/messages/send.php', {
      to: '573101234567',
      text: 'Hola! Tu factura del mes ha sido generada exitosamente.'
    }, {
      headers: {
        'Authorization': 'Bearer lc_live_tu_api_key_aqui',
        'Content-Type': 'application/json'
      }
    });
    console.log('Mensaje enviado:', res.data);
  } catch (err) {
    console.error('Error al enviar:', err.response ? err.response.data : err.message);
  }
}

sendWhatsApp();

Para enviar archivos PDF, comprobantes, facturas electrónicas o documentos a tus clientes, envía el parámetro documentUrl junto al nombre del archivo fileName y el texto opcional de pie de mensaje:

curl -X POST "https://api.leotaucomunicaciones.com/api/v1/messages/send.php" \
  -H "Authorization: Bearer lc_live_tu_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "573101234567",
    "documentUrl": "https://tusitio.com/facturas/FAC-2026-001.pdf",
    "fileName": "Factura_Internet_Octubre.pdf",
    "text": "Estimado cliente, adjuntamos su factura del mes de Octubre."
  }'

Consultar si un Mensaje fue Entregado o Leído

Permite a tu CRM, bot o sistema externo verificar en cualquier momento el estado de entrega en tiempo real de cualquier mensaje enviado:

curl -X GET "https://api.leotaucomunicaciones.com/v1/messages/status?id=3EB0429C91" \
  -H "Authorization: Bearer lc_live_tu_api_key_aqui"

Respuesta JSON:

{
  "success": true,
  "message_id": "3EB0429C91",
  "to": "573101234567",
  "status": "delivered", // "server_ack" (enviado), "delivered" (entregado), "read" (leído)
  "is_delivered": true,
  "is_read": false,
  "is_failed": false,
  "sent_at": "2026-10-19 03:50:00",
  "updated_at": "2026-10-19 03:50:04"
}

Configura la URL de tu Webhook en tu dispositivo para recibir automáticamente los mensajes entrantes de tus clientes. LeoChats descarga automáticamente las fotos de comprobantes y notas de voz, entregándote el enlace directo y el tipo de contenido:

Evento: Mensaje con Foto o Audio recibido (message.received)

{
  "event": "message.received",
  "sessionId": "dispositivo_1",
  "data": {
    "id": "3EB0429C91...",
    "from": "573101234567",
    "type": "image", // "image", "audio", "document" o "text"
    "body": "Adjunto mi comprobante de pago",
    "mediaUrl": "https://leochats.leotaucomunicaciones.com/uploads/media/202610/3EB0429C91_1729312345.jpg",
    "mimetype": "image/jpeg",
    "fileName": "3EB0429C91_1729312345.jpg",
    "isVoiceNote": false,
    "pushName": "Juan Pérez",
    "timestamp": 1729312345
  }
}

Evento: Confirmación de Entrega y Lectura (message.ack)

{
  "event": "message.ack",
  "sessionId": "dispositivo_1",
  "data": {
    "id": "3EB0429C91...",
    "from": "573101234567",
    "status": "delivered", // "delivered" (entregado), "read" (leído / doble check azul)
    "statusCode": 3
  }
}