Enviar mensajes
Envía y gestiona mensajes de WhatsApp con Wazend: texto, multimedia, encuestas, listas, botones, reacciones y más.
Envía y gestiona mensajes de WhatsApp desde tu aplicación.
Campos comunes
session— nombre de la sesión desde la que envías el mensaje.chatId— identificador del destino:5215551234567@c.us(usuario),...@g.us(grupo),...@newsletter(canal) ostatus@broadcast(estado).file— para multimedia, usafile.url(URL pública) ofile.data(base64).reply_to— ID del mensaje al que respondes.
Marcar como leído
POST /api/sendSeen{
"session": "S0001",
"chatId": "5215551234567@c.us"
}Para leer mensajes específicos, usa messagesIds (y participant en grupos):
{
"session": "S0001",
"chatId": "5215551234567@c.us",
"messagesIds": [
"false_5215551234567@c.us_AAAAAAAAAAAAAAAAAAAA"
]
}Enviar texto
POST /api/sendText{
"session": "S0001",
"chatId": "5215551234567@c.us",
"text": "¡Hola!"
}Opciones adicionales:
reply_to— responder a un mensaje.mentions— mencionar contactos en un grupo (["5215551234567@c.us"]o["all"]para todos).linkPreview— activar vista previa de enlaces.linkPreviewHighQuality— vista previa en alta calidad.
Enviar imagen
POST /api/sendImage{
"session": "S0001",
"chatId": "5215551234567@c.us",
"file": {
"mimetype": "image/jpeg",
"url": "https://ejemplo.com/foto.jpg",
"filename": "foto.jpg"
},
"caption": "Mira esta imagen"
}También puedes enviar el archivo en base64 usando file.data en lugar de file.url.
Formato de imagen
WhatsApp funciona mejor con imágenes en JPEG. No hay flag convert para imágenes: debes convertir a JPEG antes de enviarlas.
Enviar nota de voz
POST /api/sendVoice{
"session": "S0001",
"chatId": "5215551234567@c.us",
"file": {
"mimetype": "audio/ogg; codecs=opus",
"url": "https://ejemplo.com/audio.ogg"
},
"convert": false
}Usa convert: true para que Wazend convierta el audio automáticamente. También puedes enviar el archivo en base64 con file.data.
Enviar video
POST /api/sendVideo{
"session": "S0001",
"chatId": "5215551234567@c.us",
"file": {
"mimetype": "video/mp4",
"url": "https://ejemplo.com/video.mp4"
},
"caption": "Mira este video",
"convert": false
}Usa convert: true para que Wazend convierta el video automáticamente.
Convertir voz
Convierte un audio a un formato compatible con WhatsApp (OGG/Opus).
POST /api/{session}/media/convert/voice{
"url": "https://ejemplo.com/audio.mp3"
}Convertir video
Convierte un video a formato MP4.
POST /api/{session}/media/convert/video{
"url": "https://ejemplo.com/video.avi"
}Enviar archivo
POST /api/sendFile{
"session": "S0001",
"chatId": "5215551234567@c.us",
"file": {
"mimetype": "application/pdf",
"url": "https://ejemplo.com/documento.pdf",
"filename": "documento.pdf"
},
"caption": "Aquí el documento"
}Enviar encuesta
POST /api/sendPoll{
"session": "S0001",
"chatId": "5215551234567@c.us",
"poll": {
"name": "¿Cuál es tu color favorito?",
"options": ["Rojo", "Azul", "Verde"],
"multipleAnswers": false
}
}Votar en encuesta
POST /api/sendPollVote{
"session": "S0001",
"chatId": "5215551234567@c.us",
"pollMessageId": "ID_DE_LA_ENCUESTA",
"pollServerId": null,
"votes": ["Rojo"]
}Enviar lista interactiva
POST /api/sendList{
"session": "S0001",
"chatId": "5215551234567@c.us",
"title": "Menú principal",
"text": "Selecciona una opción",
"buttonText": "Abrir menú",
"sections": [
{
"title": "Opciones",
"rows": [
{ "title": "Opción 1", "description": "Descripción 1" },
{ "title": "Opción 2", "description": "Descripción 2" }
]
}
]
}Enviar link con vista previa personalizada
POST /api/send/link-custom-preview{
"session": "S0001",
"chatId": "5215551234567@c.us",
"title": "Título personalizado",
"description": "Descripción del enlace",
"url": "https://ejemplo.com",
"imageUrl": "https://ejemplo.com/preview.jpg"
}Reenviar mensaje
POST /api/forwardMessage{
"session": "S0001",
"messageId": "false_5215551234567@c.us_ABC123",
"chatId": "5219999999999@c.us"
}Reaccionar a un mensaje
POST /api/reaction{
"session": "S0001",
"messageId": "false_5215551234567@c.us_ABC123",
"chatId": "5215551234567@c.us",
"reaction": "👍"
}Destacar mensaje
POST /api/star{
"session": "S0001",
"messageId": "false_5215551234567@c.us_ABC123",
"chatId": "5215551234567@c.us",
"star": true
}Enviar contacto
POST /api/sendContactVcard{
"session": "S0001",
"chatId": "5215551234567@c.us",
"contacts": [
{ "fullName": "Juan Pérez", "phoneNumber": "+5215551234567" }
]
}Enviar ubicación
POST /api/sendLocation{
"session": "S0001",
"chatId": "5215551234567@c.us",
"lat": 19.4326,
"lng": -99.1332,
"title": "Ciudad de México"
}Indicador de escritura
POST /api/startTyping{
"session": "S0001",
"chatId": "5215551234567@c.us"
}POST /api/stopTyping