Para qué sirve
- Enviar al cliente el PDF de su factura o boleta apenas se emite.
- Avisar que un pedido está listo, en camino o fue entregado.
- Recordar citas, reservas o fechas de pago.
- Enviar cotizaciones y documentos desde tu CRM o ERP.
- Notificar a tu equipo eventos importantes de tu sistema.
Paso 1: vincula tu número por QR
Antes de enviar mensajes conecta tu número desde el panel admin.miapi.cloud, en la sección API de WhatsApp:
- Inicia sesión en el panel y abre la sección de WhatsApp; se genera un código QR.
- En tu teléfono, abre WhatsApp > Dispositivos vinculados > Vincular un dispositivo y escanea el QR.
- Espera a que el panel indique que está conectado.
La vinculación se hace en el panel con tu sesión, no con el token. Puedes conectar más de un número usando distintos instanceId; si no indicas uno, se usa default. Para cambiar de número, reinicia la conexión desde el panel y escanea un QR nuevo.
Paso 2: envía mensajes y archivos
Con el número conectado, envía con tu token en Authorization: Bearer TU_TOKEN:
- Texto:
phonecon código de país y sin el signo +, por ejemplo51900000000, ymessage. - Archivo: imagen, PDF o video de hasta 16 MB, por URL pública en
fileUrl(JSON) o subiendo el archivo en form-data en el campofile;captiones opcional.
La respuesta trae success, un objeto data (en texto incluye el jid del destinatario y el waMessageId del mensaje), el instanceId usado, el messageType y consultasRestantes, que te permite saber cuántos envíos te quedan en tu plan. Guarda el waMessageId si necesitas rastrear el mensaje.
Cómo empezar
- Crea tu cuenta gratis en miapi.cloud; el plan gratuito te permite probar sin tarjeta.
- Copia tu token desde el panel admin.miapi.cloud.
- Envíalo en cada petición en la cabecera
Authorization: Bearer TU_TOKEN, siempre por HTTPS.
Después de vincular tu número, envíate un mensaje de prueba a tu propio celular para confirmar que todo funciona antes de integrarlo con tu sistema.
La cantidad de consultas disponibles depende de tu plan; revisa los planes en miapi.cloud/#planes. Si tienes dudas para integrarla, escríbenos por WhatsApp.
Buenas prácticas y uso responsable
- Escribe solo a quienes te dieron su número y aceptaron recibir mensajes. Los envíos masivos no solicitados pueden hacer que WhatsApp restrinja o bloquee tu número.
- Normaliza los teléfonos antes de enviar: solo dígitos, con
51delante para números peruanos. - Espacia los envíos en lugar de mandar muchos mensajes en ráfaga.
- Revisa la conexión en el panel si los envíos empiezan a fallar: el teléfono pudo desvincularse.
- Controla
consultasRestantespara avisar antes de quedarte sin envíos.
Guarda el token en el servidor, en una variable de entorno o en tu gestor de secretos. No lo pongas en el código de una página web ni en una app móvil: cualquiera podría leerlo y gastar tus consultas. Si sospechas que se filtró, genera uno nuevo desde el panel.
Combínala con la API de facturación electrónica y la API XML a PDF para enviar cada comprobante por WhatsApp de forma automática.
Referencia de la API
Todas las peticiones llevan tu token en la cabecera Authorization: Bearer TU_TOKEN.
Lo copias desde tu panel en admin.miapi.cloud después de
crear tu cuenta gratis. Más detalles en la documentación.
WhatsApp - Vincular número por QR
Vincula tu número de WhatsApp escaneando un código QR desde el panel antes de usar la API de envío.
GET https://admin.miapi.cloud/api/whatsapp/qr?instanceId=default
curl -X GET "https://admin.miapi.cloud/api/whatsapp/qr?instanceId=default" \
-H "Cookie: auth-token=TU_SESION_PANEL"const respuesta = await fetch("https://admin.miapi.cloud/api/whatsapp/qr?instanceId=default", {
method: "GET",
headers: {
"Cookie": "auth-token=TU_SESION_PANEL"
},
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://admin.miapi.cloud/api/whatsapp/qr?instanceId=default");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Cookie: auth-token=TU_SESION_PANEL"
],
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.get(
"https://admin.miapi.cloud/api/whatsapp/qr?instanceId=default",
headers={
"Cookie": "auth-token=TU_SESION_PANEL"
},
timeout=30,
)
print(respuesta.json()) {
"success": true,
"instanceId": "default",
"qr": "<CADENA_QR>",
"connected": false
} WhatsApp - Enviar mensaje de texto
Envía un mensaje de texto a un número con código de país y sin el signo +.
POST https://admin.miapi.cloud/api/whatsapp/send
curl -X POST "https://admin.miapi.cloud/api/whatsapp/send" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"phone":"51900000000","message":"Hola, este es un mensaje de prueba","instanceId":"default"}'const respuesta = await fetch("https://admin.miapi.cloud/api/whatsapp/send", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"phone": "51900000000",
"message": "Hola, este es un mensaje de prueba",
"instanceId": "default"
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://admin.miapi.cloud/api/whatsapp/send");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"phone" => "51900000000",
"message" => "Hola, este es un mensaje de prueba",
"instanceId" => "default"
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://admin.miapi.cloud/api/whatsapp/send",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"phone": "51900000000",
"message": "Hola, este es un mensaje de prueba",
"instanceId": "default"
},
timeout=30,
)
print(respuesta.json()) {
"success": true,
"data": {
"success": true,
"phone": "51900000000",
"message": "Hola, este es un mensaje de prueba",
"jid": "51900000000@s.whatsapp.net",
"waMessageId": "ID_MENSAJE"
},
"instanceId": "default",
"messageType": "text",
"consultasRestantes": 950
} WhatsApp - Enviar archivo
Envía una imagen, PDF o video (máx. 16 MB) por URL en JSON o subiendo el archivo con form-data.
POST https://admin.miapi.cloud/api/whatsapp/send-file
curl -X POST "https://admin.miapi.cloud/api/whatsapp/send-file" \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"phone":"51900000000","fileUrl":"https://ejemplo.com/archivo.pdf","caption":"Aquí está tu documento"}'const respuesta = await fetch("https://admin.miapi.cloud/api/whatsapp/send-file", {
method: "POST",
headers: {
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"phone": "51900000000",
"fileUrl": "https://ejemplo.com/archivo.pdf",
"caption": "Aquí está tu documento"
}),
});
const datos = await respuesta.json();
console.log(datos);<?php
$ch = curl_init("https://admin.miapi.cloud/api/whatsapp/send-file");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer TU_TOKEN",
"Content-Type: application/json"
],
CURLOPT_POSTFIELDS => json_encode([
"phone" => "51900000000",
"fileUrl" => "https://ejemplo.com/archivo.pdf",
"caption" => "Aquí está tu documento"
]),
]);
$datos = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($datos);import requests
respuesta = requests.post(
"https://admin.miapi.cloud/api/whatsapp/send-file",
headers={
"Authorization": "Bearer TU_TOKEN",
"Content-Type": "application/json"
},
json={
"phone": "51900000000",
"fileUrl": "https://ejemplo.com/archivo.pdf",
"caption": "Aquí está tu documento"
},
timeout=30,
)
print(respuesta.json()) {
"success": true,
"data": {},
"instanceId": "default",
"consultasRestantes": 950
} Errores frecuentes
| Código | Qué significa |
|---|---|
400 | Falta phone o falta message / fileUrl / file, o el teléfono no tiene un formato válido. |
401 | Token ausente o inválido. Revisa la cabecera Authorization: Bearer TU_TOKEN. |
429 | Alcanzaste el límite mensual de envíos de tu plan. |
5xx | El número no está conectado o el servicio no respondió. Revisa la conexión en el panel y reintenta más tarde. |
Preguntas frecuentes
¿Necesito WhatsApp Business?
No es obligatorio. Vinculas el número que quieras usar escaneando un QR desde Dispositivos vinculados, igual que en WhatsApp Web.
¿Qué tipos de archivo puedo enviar?
Imágenes, PDF y videos de hasta 16 MB, por URL pública o subiendo el archivo en form-data.
¿Cómo escribo el número de destino?
Con código de país y sin el signo +, solo dígitos. Para Perú, por ejemplo, 51 seguido de los 9 dígitos del celular.
¿Puedo conectar varios números?
Sí, cada número se identifica con un instanceId distinto. Si no indicas uno, se usa default.
¿Cuántos mensajes puedo enviar?
Depende de tu plan; la respuesta de cada envío indica tus consultas restantes. Revisa los planes en miapi.cloud/#planes.
¿Puedo enviar publicidad masiva?
No lo recomendamos. Escribe solo a contactos que aceptaron recibir tus mensajes; el spam puede provocar que WhatsApp bloquee tu número.
APIs relacionadas
-
API XML a PDF
Convierte el XML de tus comprobantes electrónicos en una representación impresa en PDF, en formato A4 o ticket, uno por uno o varios a la vez en un ZIP.
-
API Facturación Electrónica
Emite facturas y boletas electrónicas desde tu propio software: envías los datos en JSON, generamos y firmamos el XML y lo enviamos a SUNAT.
-
API DNI
Obtén nombres, apellidos y domicilio a partir de un DNI de 8 dígitos y valida la identidad de tus clientes desde tu propio sistema, uno por uno o en lote.
Empieza gratis hoy
Crea tu cuenta gratis, copia tu token y haz tu primera consulta en minutos. Sin tarjeta de crédito.