WhatsApp

Este producto envía mensajes de WhatsApp desde una línea tuya: conectas tu número una vez desde el panel y envías por API con tu misma API Key.

• Sin trámites de Meta. No necesitas cuenta de WhatsApp Business API, verificación de empresa ni aprobación de plantillas.
• Sin plantillas. El message es texto libre (hasta 1000 caracteres), o multimedia: imagen, video, audio o documento.
• Para transaccionales. Mensajes uno a uno derivados de una acción del usuario. Para campañas y envíos masivos usa SMS Masivos.

Conecta tu línea

1. Entra al panel y crea tu instancia de WhatsApp.
2. Escanea el código QR con la app de WhatsApp del número que va a enviar (igual que WhatsApp Web).
3. Copia el instance_id de la instancia; lo mandas en cada petición.

La instancia debe pertenecer a tu cuenta y estar conectada al momento del envío. Si tu teléfono pierde sesión, reconéctala desde el panel escaneando el QR de nuevo.

Transaccional, no masivo

Este canal es para mensajes que responden a una acción del usuario: la confirmación de su pedido, el aviso de que su paquete salió, el recibo de su pago, la respuesta a su consulta.

La regla práctica: si disparas dos mensajes simultáneos, ya es masivo. Promociones, cobranza, recordatorios en lote o cualquier envío que no derive de la acción de un usuario cuenta como masivo, aunque el texto sea distinto en cada mensaje.

Enviar un mensaje

POST /whatsapp/send con tu instance_id, el número destino y el texto:

curl -X POST https://api.smsmasivos.com.mx/whatsapp/send \
  -H "Content-Type: application/json" \
  -H "apikey: $API_KEY" \
  -d '{
    "instance_id": "instance_abc123",
    "number": "5512345678",
    "message": "Hola, tu pedido #4821 esta confirmado. Te avisamos cuando salga.",
    "type": "text"
  }'

Parámetros principales:

Enviar multimedia

Cambia type a image, video, audio o document y manda en message la URL del archivo. La URL debe usar HTTPS, ser accesible públicamente sin autenticación y terminar en la extensión del archivo, sin query string. Con caption agregas un texto descriptivo al medio (máximo 1000 caracteres).

{
  "instance_id": "instance_abc123",
  "number": "5512345678",
  "message": "https://tusitio.com/recibos/4821.pdf",
  "type": "document",
  "caption": "Tu recibo de compra"
}

Códigos de verificación

Para códigos OTP, login o 2FA por WhatsApp no uses este canal ni necesitas instancia: POST /v2/otp con channel: "whatsapp" envía por la integración oficial y la API genera y valida el código por ti.

Errores

El éxito responde whatsapp_21. Los errores más comunes: whatsapp_04/whatsapp_08 (instancia inexistente o inactiva; verifica el instance_id y el estado en el panel), whatsapp_23 (número mal formado; van 10 dígitos sin código de país) y sms_07 (créditos insuficientes). La lista completa está en Errores y límites y en la Referencia API.