Producto
WhatsApp

Enviar mensaje

Envía un mensaje de texto libre por WhatsApp a un contacto.

Enviar mensaje

Envía un mensaje de texto libre a un contacto de WhatsApp. Úsalo para responder dentro de la ventana de 24 horas; para escribir primero a un contacto usa send-template.

bash
01plazbot whatsapp send-message -p <número> -m "<mensaje>" [opciones]

Parámetros

ParámetroFlagRequeridoDescripción
Teléfono-p, --phone <number>SíNúmero del destinatario en formato internacional: +51912345678, "+51 912 345 678", 0051912345678 o 51912345678
Mensaje-m, --message <text>SíTexto a enviar. Ponlo entre comillas si tiene espacios
JSON--jsonNoImprime solo JSON en stdout

Las formas anteriores (--to) siguen funcionando.

Ejemplos

bash
01# Enviar un mensaje rápido
02plazbot whatsapp send-message -p +51912345678 -m "Hola desde Plazbot"
03 
04# Cualquier formato internacional sirve (espacios, prefijo 00)
05plazbot whatsapp send-message -p "+51 912 345 678" -m "Tu pedido está en camino"
06 
07# Resultado en JSON para scripts
08plazbot whatsapp send-message -p +51912345678 -m "Hola" --json

Resultado

text
01 Sending WhatsApp message
02 ────────────────────────────────────────
03 To: +51912345678
04 Message: Hola desde Plazbot
05✔ Message sent

Salida JSON

json
01{
02 "phone": "51912345678",
03 "status": "sent",
04 "messageId": "..."
05}

messageId aparece solo cuando la API lo devuelve.

Errores comunes

MensajeCausaSolución
Missing phone number.No pasaste -pAgrega -p +51912345678
Invalid phone number "123".El número no tiene entre 8 y 15 dígitos con código de paísUsa el formato internacional, por ejemplo +51912345678
Message is empty.-m vacíoPasa el texto con -m "Hola"
The message was not sent. (más el detalle de la API)Fuera de la ventana de 24 horas, o el contacto no existeEl CLI sugiere: Outside that window send an approved template: plazbot whatsapp send-template -p <number> -t <template>
You are not signed in.No hay sesión activaEjecuta plazbot login

WhatsApp solo permite texto libre dentro de las 24 horas desde el último mensaje del contacto. Fuera de esa ventana, o para escribir primero, usa una plantilla aprobada con plazbot whatsapp send-template. El contacto debe existir en el workspace (se crea cuando escribe a tu número).

¿Quieres probar la API en vivo? Abre el Playground.