Enviar Mensajes por WhatsApp

Aprende a enviar texto, imágenes, documentos y más.

Formato de número

Usa formato internacional sin símbolos:

País	Formato	Ejemplo
México	521XXXXXXXXX	5215512345678
Argentina	549XXXXXXXXX	5491123456789
Colombia	57XXXXXXXXXX	573001234567
España	34XXXXXXXXX	34612345678

Enviar texto

curl -X POST "https://tu-evolution.deployalo.com/message/sendText/mi-negocio" \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5215512345678",
    "text": "¡Hola! Este es un mensaje de prueba."
  }'

Enviar imagen

curl -X POST ".../message/sendMedia/mi-negocio" \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5215512345678",
    "mediatype": "image",
    "media": "https://ejemplo.com/imagen.jpg",
    "caption": "Mira esta imagen"
  }'

Enviar documento

curl -X POST ".../message/sendMedia/mi-negocio" \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5215512345678",
    "mediatype": "document",
    "media": "https://ejemplo.com/factura.pdf",
    "fileName": "Factura-001.pdf"
  }'

Enviar ubicación

curl -X POST ".../message/sendLocation/mi-negocio" \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5215512345678",
    "latitude": 19.4326,
    "longitude": -99.1332,
    "name": "Nuestra Oficina",
    "address": "Av. Reforma 123, CDMX"
  }'

Enviar contacto

curl -X POST ".../message/sendContact/mi-negocio" \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5215512345678",
    "contact": {
      "fullName": "Juan Pérez",
      "phoneNumber": "5215598765432"
    }
  }'

Enviar botones (interactivo)

curl -X POST ".../message/sendButtons/mi-negocio" \
  -H "apikey: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5215512345678",
    "title": "¿Cómo podemos ayudarte?",
    "buttons": [
      {"buttonId": "btn1", "buttonText": {"displayText": "Ver productos"}},
      {"buttonId": "btn2", "buttonText": {"displayText": "Hablar con ventas"}},
      {"buttonId": "btn3", "buttonText": {"displayText": "Soporte técnico"}}
    ]
  }'

Respuestas

Éxito

{
  "key": {
    "id": "3EB0...",
    "remoteJid": "[email protected]"
  },
  "message": {...},
  "status": "PENDING"
}

Error

{
  "error": true,
  "message": "Number not registered on WhatsApp"
}

Mejores prácticas

• ✅ Verifica que el número existe antes de enviar
• ✅ Respeta horarios de envío (no de madrugada)
• ✅ No envíes spam o mensajes no solicitados
• ✅ Usa templates para mensajes repetitivos
• ❌ No envíes más de 1 mensaje por segundo
• ❌ No envíes a números que te bloquearon