Enviar mensajes de WhatsApp por API
Una petición HTTP con tu API key, tu número y el destino. El mensaje sale desde tu WhatsApp y la respuesta llega en JSON.
/send-messagecurl -X POST https://api.kontacto.pro/send-message \
-H "Content-Type: application/json" \
-d '{
"api_key": "TU_API_KEY",
"sender": "51999888777",
"number": "51987654321",
"message": "Hola Ana, tu pedido #1024 ya salió a reparto."
}'
<?php
$datos = [
'api_key' => 'TU_API_KEY',
'sender' => '51999888777',
'number' => '51987654321',
'message' => 'Hola Ana, tu pedido #1024 ya salió a reparto.',
];
$ch = curl_init('https://api.kontacto.pro/send-message');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($datos),
CURLOPT_RETURNTRANSFER => true,
]);
$respuesta = json_decode(curl_exec($ch), true);
const datos = {
api_key: 'TU_API_KEY',
sender: '51999888777',
number: '51987654321',
message: 'Hola Ana, tu pedido #1024 ya salió a reparto.',
};
const respuesta = await fetch('https://api.kontacto.pro/send-message', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(datos),
});
console.log(await respuesta.json());
import requests
datos = {
"api_key": "TU_API_KEY",
"sender": "51999888777",
"number": "51987654321",
"message": "Hola Ana, tu pedido #1024 ya salió a reparto.",
}
respuesta = requests.post("https://api.kontacto.pro/send-message", json=datos, timeout=30)
print(respuesta.json())
Lo que necesitas saber
-
GET o POST
Usa POST con JSON o una URL con parámetros si tu sistema solo sabe abrir enlaces.
-
Hasta 10 destinos
Separa los números con | en el campo number y el mismo texto sale a todos.
-
Grupos, canales y LID
El destino puede ser un número, un grupo (…@g.us), un canal (…@newsletter) o un chat LID (…@lid).
Respuesta de la API
Todas las respuestas son JSON con status y un mensaje. Si algo falla, el detalle viene en errors.
{
"status": true,
"msg": "Mensaje enviado con éxito!"
}
Todos los parámetros y los errores posibles están en la documentación de enviar mensajes.
¿Necesito plantillas aprobadas por Meta?
No. El texto es libre porque el mensaje sale desde tu número conectado por QR, como en WhatsApp Web.
¿Con qué formato va el número?
Con código de país y sin el signo +: 51987654321 para Perú.
¿Hay costo por mensaje?
No. Pagas tu plan mensual y envías los mensajes que necesites, siempre a personas que esperan tu mensaje.
Casos de uso con esta función
-
Notificaciones de pedidos por WhatsApp
El cliente compra y recibe la confirmación en su WhatsApp. Cuando sale a reparto, otro aviso. Menos llamadas preguntando "¿dónde está mi pedido?". -
Códigos de verificación OTP por WhatsApp
Tu sistema genera el código, lo envía por WhatsApp y el usuario lo escribe. Sin costo por SMS y con la vista previa en la notificación. -
Recordatorios de citas por WhatsApp
Un día antes, tu agenda envía el recordatorio con la fecha y la hora. El paciente confirma con un toque en la encuesta. -
Recordatorios de pago por WhatsApp
El correo se ignora; el WhatsApp se lee. Recordatorios con el monto y la fecha de cada cliente, enviados desde tu sistema. -
Envío de boletas y facturas electrónicas por WhatsApp
Emites el comprobante y el PDF llega al WhatsApp del cliente. Sin imprimir, sin pedir correo y sin que se pierda en la bandeja de spam. -
Formulario web conectado a WhatsApp
El interesado deja sus datos y en segundos recibe tu WhatsApp. Respondes mientras todavía está pensando en ti.
Funciones relacionadas
-
Enviar imágenes, documentos y audios por la API de WhatsApp
Pasa la URL pública del archivo y su tipo. Llega al chat como imagen, video, nota de voz o documento con su nombre. -
Webhook de WhatsApp para recibir mensajes en tu sistema
Configura una URL y cada mensaje entrante llega por POST en JSON. Si respondes con un mensaje, se envía al cliente. -
API de grupos de WhatsApp
Obtén los grupos donde participa tu número con su id, cantidad de miembros y si puedes escribir. Luego usa ese id como destino.
Envía tu primer mensaje hoy
Escríbenos por WhatsApp, conectamos tu número con un QR y te damos tu API key para que pruebes desde tu sistema.