Maytapi
Maytapi/Documentación/Guía de Node.js
Guía de Node.jsUnos 10 minutosCómo enviar un mensaje de WhatsApp con Node.js
Envía mensajes de texto y multimedia desde Node.js con una sola petición HTTP y recibe las respuestas en tu propio webhook. REST y JSON puros: sin SDK ni aprobación de plantillas.
Última actualización:
- Node.js
- REST + JSON
- sin SDK
- respuestas por webhook
// Node.js 18+ (built-in fetch)
const PID = "your-pid";
const PHONE_ID = "your-phone-id";
const TOKEN = "your-token";
const res = await fetch(
`https://api.maytapi.com/api/${PID}/${PHONE_ID}/sendMessage`,
{
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({
to_number: "3461xxxxx67",
type: "text",
message: "Hello from Node.js!"
})
}
);
console.log(await res.json());Qué necesitas
Cuatro cosas, todas disponibles en la consola en pocos minutos.
-
cuenta
Una cuenta de Maytapi
Regístrate e inicia la prueba gratuita, sin tarjeta.
-
teléfono
Un número vinculado
Escanea el código QR con WhatsApp en tu teléfono. Tu número sigue funcionando como siempre.
-
token
pid y token
Cópialos de la página de token de la consola; el phone_id aparece junto a tu número.
-
Node.js
Un entorno de Node.js
Basta con una versión reciente de Node.js y su cliente HTTP estándar.
Envía un mensaje de texto con Node.js
Haz un POST con un cuerpo JSON a /sendMessage con tu token en la cabecera x-maytapi-key. El mensaje se encola en tu teléfono y la respuesta llega al instante.
- ✓to_number en formato internacional, p. ej. 3461xxxxx67
- ✓type: text y el texto del mensaje
- ✓La respuesta incluye el id del mensaje
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{"to_number": "3461xxxxx67", "type": "text", "message": "Hello from Node.js!"}'{
"success": true,
"data": {
"chatId": "3461xxxxx67@c.us",
"msgId": "3EB065B353B9493D00C9"
}
}Envía una imagen, un video o un documento
Usa el mismo endpoint con type media y una URL pública o un data URI en base64. Añade un pie de foto y un nombre de archivo opcionales.
- ✓Imágenes, video, audio, PDF y otros documentos
- ✓Pie de foto en el campo text
- ✓Los data URI en base64 funcionan igual que las URL
await fetch(`https://api.maytapi.com/api/${PID}/${PHONE_ID}/sendMessage`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({
to_number: "3461xxxxx67",
type: "media",
message: "https://example.com/invoice-10482.pdf",
text: "Your invoice for order #10482",
filename: "invoice-10482.pdf"
})
});Recibe respuestas con un webhook en Node.js
Registra la URL del webhook una vez. Los mensajes entrantes y las confirmaciones de entrega y lectura llegan en JSON; responde con la URL reply incluida en cada evento.
- ✓Devuelve 200 rápido y luego procesa el evento
- ✓Omite tus propios mensajes con fromMe
- ✓Usa event.reply para responder en el mismo chat
await fetch(`https://api.maytapi.com/api/${PID}/setWebhook`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({ webhook: "https://example.com/maytapi/webhook" })
});import express from "express";
const app = express();
app.post("/maytapi/webhook", express.json(), async (req, res) => {
res.sendStatus(200); // acknowledge first
const event = req.body;
if (event.type !== "message" || event.message.fromMe) return;
await fetch(event.reply, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({
to_number: event.conversation,
type: "text",
message: "Thanks! We received your message."
})
});
});
app.listen(3000);FAQ de WhatsApp API con Node.js
Pregunta lo que quieras a nuestro equipo de soporte por WhatsApp. El tiempo medio de respuesta es inferior a 24 horas.
Centro de ayuda →¿Hay un SDK oficial para Node.js?
No hace falta. La API es REST con JSON, así que basta con el cliente HTTP estándar de Node.js, como muestran los ejemplos de esta página.
¿Puedo enviar mensajes a grupos desde Node.js?
Sí. Usa el id del grupo (termina en @g.us) como to_number; los endpoints de grupos están disponibles en todos los planes.
¿Por qué no llegó mi mensaje?
Comprueba que el estado del teléfono esté activo y revisa la cola y los registros en la consola. Los números nuevos deben calentarse antes de enviar en volumen.
Más funciones de WhatsApp API
Consigue tu clave y envía tu primer mensaje en diez minutos
Sin aprobación, sin plantillas, sin tarjeta. Todos los endpoints abiertos durante tres días.