MultiMensajes MultiMensajes / API Docs
Guia rapida

Tu primer mensaje en 5 minutos

Sigue estos 5 pasos para enviar tu primer WhatsApp usando la API. En el paso 3 elegiras tu lenguaje de programacion y te mostraremos el ejemplo listo para copiar.

  1. 1

    Consigue tu API key

    Desde el panel del cliente, entra a Celulares, selecciona el numero que quieras usar y copia la token del celular (empieza con WA_). Si no tienes cuenta, contacta a soporte@multimensajes.com.

    Ir al panel del cliente
  2. 2

    Vincula tu WhatsApp

    Si tu celular aun no esta vinculado, escanea el codigo QR desde el panel (la sesion WhatsApp queda asociada a tu token). Si ya esta vinculado, salta este paso.

    Tip: vincula el celular una sola vez, la sesion persiste hasta que la cierres manualmente.
  3. 3

    Elige tu lenguaje de programacion

    Selecciona el lenguaje que usas. Te mostraremos abajo un ejemplo de codigo listo para copiar y pegar.

    El codigo del paso 4 cambiara al instante.
  4. 4

    Copia el ejemplo

    Este es el codigo completo para enviar un mensaje de texto plano a un destinatario. Cambia 5212345678901 por tu numero destino y pegalo en tu proyecto.

    cURL 
    curl -X POST 'https://panel.multimensajes.com/api/mensaje_enviar_texto.php' \
  -H 'Authorization: Bearer WA_TU_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "destinatario": "521000000000",
    "mensaje": "Hola desde cURL",
    "directo": 1
}'
    Lo que hace este codigo:
    1. Hace POST a /api/mensaje_enviar_texto.php con JSON en el body
    2. Incluye tu token en el header Authorization: Bearer
    3. El server valida el token, descuenta 1 credito y encola el mensaje
    4. En pocos segundos tu WhatsApp llega al destinatario
  5. 5

    Ejecuta y verifica

    Copia y pega el codigo en tu proyecto. Si todo va bien, recibiras un 200 OK con un JSON similar a:

    {
  "ok": true,
  "msg_id": "9c8a7b6d-1234-5678-9abc-def012345678",
  "tipo": "mensaje",
  "modo": "cola",
  "saldo": 999
}
    Listo. Tu primer WhatsApp via API salio. Para mas alla (imagenes, documentos, webhooks), explora los endpoints abajo.

¿Necesitas mas?

Los 13 lenguajes soportados: cURL, PHP (cURL/Guzzle), Python (requests/http.client), Node.js (fetch/axios), Java (OkHttp), Go, Ruby, C#, Postman, RapidAPI. Si tu lenguaje no aparece, contanos.

Ver los 13 endpoints Guia de Postman
API REST de WhatsApp

Envia WhatsApps desde tu sistema en minutos

13 endpoints REST. Ejemplos en 12 lenguajes. Modo principal lagacy (compatible con tu sistema actual) y modo alternativo Bearer para nuevos proyectos.

Operativa hoy 13 endpoints 12 lenguajes Modo directo + cola
Modo principal

API Lagacy (compatible)

El endpoint /panel/api_wa.php es el modo principal de envio. Mantiene el mismo contrato del conector anterior (multi_clientes / multi_lineas), por lo que tus sistemas externos siguen funcionando sin cambios.

Operativo Mismo token de antes Texto + archivo en una llamada
RECOMENDADO
POST /panel/api_wa.php

Enviar mensaje universal (lagacy)

Endpoint principal de envio. Acepta texto y archivo (imagen/video/audio/documento/sticker) en una sola llamada. Es el modo recomendado para sistemas externos con el token del sistema anterior.

TOKEN LEGACY Ver documentacion →
Modo alternativo

API Bearer (nueva)

11 endpoints REST con autenticacion Authorization: Bearer y cuerpo JSON. Ideales para nuevos proyectos. Ofrecen proteccion anti-duplicado, modo directo opcional y soporte base64 inline.

Bearer token JSON nativo Anti-duplicado directo=1 disponible

🎵 Audio 2

POST /api/mensaje_enviar_audio.php

Enviar audio (URL publica)

Envia un archivo de audio. Soporta PTT (push-to-talk / nota de voz) con ptt=true.

BEARER Ver →
POST /api/mensaje_enviar_audio_base64.php

Enviar audio (base64)

Envia audio en base64. Soporta nota de voz (ptt=true).

BEARER Ver →

📄 Documento 2

POST /api/mensaje_enviar_documento.php

Enviar documento (URL publica)

Envia un documento PDF, Word, Excel, ZIP, etc. WhatsApp detecta el tipo y muestra el icono apropiado.

BEARER Ver →
POST /api/mensaje_enviar_documento_base64.php

Enviar documento (base64)

Envia un documento como base64. Ideal cuando el archivo vive en memoria o base de datos.

BEARER Ver →

🖼️ Imagen 2

POST /api/mensaje_enviar_imagen.php

Enviar imagen (URL publica)

Envia una imagen desde una URL publica. La API descarga y envia al instante. La URL debe responder 200 y ser accesible desde el servidor.

BEARER Ver →
POST /api/mensaje_enviar_imagen_base64.php

Enviar imagen (base64)

Envia una imagen embebida como base64 en el cuerpo del request. Ideal para sistemas que no pueden hospedar archivos publicos.

BEARER Ver →

😀 Sticker 2

POST /api/mensaje_enviar_sticker.php

Enviar sticker (URL publica)

Envia un sticker WebP. WhatsApp requiere formato WebP animado o estatico de 512x512 px.

BEARER Ver →
POST /api/mensaje_enviar_sticker_base64.php

Enviar sticker (base64)

Envia un sticker WebP en base64.

BEARER Ver →

💬 Texto 1

POST /api/mensaje_enviar_texto.php

Enviar texto

Envia un mensaje de texto plano a un destinatario. Por default encola (modo humanizado). Con "directo":1 envia al instante.

BEARER Ver →

🎬 Video 2

POST /api/mensaje_enviar_video.php

Enviar video (URL publica)

Envia un video desde una URL publica. WhatsApp acepta MP4 con codec H.264.

BEARER Ver →
POST /api/mensaje_enviar_video_base64.php

Enviar video (base64)

Envia un video como base64 inline. Mismas garantias de privacidad que la imagen base64.

BEARER Ver →

Utilidades

Endpoints auxiliares sin auth, utiles para integrar la API en herramientas externas.

GET /api/docs_listar.php

Listar documentacion (machine-readable)

Devuelve el catalogo completo de endpoints en JSON, incluyendo politicas (modo directo, anti-duplicado, normalizador de paises). Util para generar SDKs.

PUBLICO Ver →

Recursos para developers

Coleccion Postman

Importa la coleccion, configura tu token y prueba todos los endpoints en 2 minutos.

OpenAPI 3.0

Spec completa para generar SDKs en cualquier lenguaje con openapi-generator.

Soporte developers

Email a soporte@multimensajes.com. Respondemos en menos de 24h.

¿Como funciona?

Cuatro pasos desde tu request HTTP hasta el WhatsApp del destinatario. Todo en menos de 1 segundo (modo directo) o unos minutos (cola humanizada).

1

Tu sistema hace el request

POST con JSON a la API. Bearer token o token del celular.

2

Validacion + cola

Auth, saldo, blacklist, anti-duplicado. Modo cola o directo.

3

Envio a WhatsApp

Llamada al servidor de WhatsApp via WasenderAPI.

4

Confirmacion + log

Status devuelto en JSON. Webhook opcional para delivery/lectura.