Coleccion Postman
Tu primera llamada en 5 minutos
Postman es una herramienta gratuita para probar APIs sin escribir codigo. Importa la coleccion, configura tu environment y envia tu primer WhatsApp sin tocar una terminal.
1 Instalar Postman
Elige una de las dos opciones:
- App de escritorio: postman.com/downloads — recomendada, mas estable.
- Version web: web.postman.com — sin instalar nada, abre desde el navegador.
2 Importar la coleccion
- Abre Postman y haz click en Import (esquina superior izquierda).
- Arrastra el archivo
postman_collection.jsono pegalo en el cuadro de texto. - La coleccion MultiMensajes API aparecera en tu sidebar con todas las requests organizadas por categoria: Cuenta, Celulares, Mensajes, Webhook, Historial.
3 Crear un Environment con tu token
4 variables- Click en el dropdown Environments (esquina superior derecha) y selecciona Create new environment.
- Nombre:
MultiMensajes - Produccion(o el que prefieras). - Agrega estas 4 variables:
| Variable | Valor inicial | Descripcion |
|---|---|---|
api_base |
https://api.multimensajes.com |
URL base del API server |
token |
TU_TOKEN_AQUI |
Token del celular (mismo que usa api_wa.php). Reemplazalo con el tuyo. |
destinatario_test |
5212345678901 |
Tu propio numero para pruebas (placeholder, no uses el real) |
bearer_token |
WA_TU_API_KEY |
Token Bearer moderno (header Authorization) |
- Click Save y selecciona ese environment en el dropdown superior.
Tip de seguridad: nunca commitees tu environment con tokens reales.
Exporta el environment SIN valores sensibles (marca la opcion al exportar) y subelo a un
vault si lo compartes con tu equipo.
4 Probar tu primera llamada
- Abre MultiMensajes API → Cuenta → Info del cliente.
- Click Send.
- Deberias ver
200 OKcon un JSON como:
JSON response
{
"ok": true,
"cliente": { "id": 55, "nombre": "...", "plan": "medido" },
"saldo_global": 500000,
"num_celulares": 2
}
Si ves
401 token invalido: revisa que la variable token
del environment este bien escrita y que el environment correcto este seleccionado.
5 Enviar tu primer WhatsApp
- Abre Mensajes → Texto → Enviar texto (modo cola).
- El body ya viene pre-rellenado con un ejemplo. Click Send.
- En 5-30 segundos tu mensaje llega al numero de
destinatario_test.
6 Vincular un celular con QR
- Celulares → Listar celulares — anota el ID del celular a vincular.
- Celulares → Generar QR para vincular — usa el ID anterior, copia el string
qrde la respuesta. - Convierte ese string a una imagen QR con una lib como qrcodejs y muestrala al usuario.
- El usuario escanea el QR desde WhatsApp en su celular.
- En 5-30 segundos, llama a Celulares → Status de la sesion WhatsApp para confirmar que quedo
connected.
Variables dinamicas que puedes usar
Postman soporta variables en cualquier parte del request. Ademas de {{token}}, {{api_base}} y {{destinatario_test}}, puedes usar:
{{$randomInt}}
Genera un entero aleatorio en bodies — util para numeros de pedido o test IDs.
{{$isoTimestamp}}
Timestamp ISO-8601 — para campos created_at en payloads.
{{$guid}}
UUID v4 — para identificadores unicos.
pm.environment.set(...)
Captura valores de una respuesta y usarlos en requests siguientes.
Exportar y compartir
- Click derecho en la coleccion o environment en el sidebar.
- Export → Collection v2.1 (Recommended).
- Guarda el
.jsony mandaselo a tu companero.