Como usar Postman con MultiMensajes

Postman es una herramienta gratuita para probar APIs sin escribir codigo. Esta guia te lleva de cero a hacer tu primera llamada en menos de 5 minutos.

1. Instalar Postman

• Descarga Postman gratis desde postman.com/downloads
• O usa la version web en web.postman.com

2. Importar la coleccion

1. Abre Postman y haz click en Import arriba a la izquierda.
2. Arrastra el archivo postman_collection.json o pegalo en el cuadro de texto.
3. La coleccion MultiMensajes API aparecera en tu sidebar izquierdo, con todas las requests organizadas por categoria (Cuenta, Celulares, Mensajes, Webhook, Historial).

3. Crear un Environment con tu API key

1. Haz click en el dropdown Environments (esquina superior derecha) y selecciona Create new environment o New Environment.
2. Nombre: MultiMensajes - Produccion (o el nombre que prefieras).
3. Agrega estas variables:

Variable	Valor inicial	Descripcion
api_base	https://api.multimensajes.com	URL base del API server
api_key	WA_69_2e5ded25cd94d7b4	Tu API key (Bearer token). Reemplazala con la tuya real.
destinatario_test	5218711281619	Tu propio numero para pruebas

4. Haz click en Save y selecciona ese environment en el dropdown.

El Bearer token se aplica automaticamente a TODAS las requests porque la coleccion ya tiene configurada la auth bearer con {{api_key}}.

4. Probar tu primera llamada

1. Abre la coleccion MultiMensajes API → Cuenta → Info del cliente.
2. Haz click en Send.
3. Deberias ver un 200 OK con un JSON como:

{
  "ok": true,
  "cliente": { "id": 55, "nombre": "...", "plan": "medido" },
  "saldo_global": 500000,
  "num_celulares": 2
}

Si ves 401 API key invalida, revisa que la variable api_key del environment este bien escrita y que el environment correcto este seleccionado.

5. Enviar tu primer mensaje

1. Abre Mensajes - Texto → Enviar texto (modo cola).
2. El body ya viene pre-rellenado con un ejemplo. Haz click en Send.
3. En 5-30 segundos tu mensaje deberia llegar al numero de destinatario_test.

6. Flujo recomendado para vincular un celular

1. Celulares → Listar celulares - anota el ID del celular que quieres vincular.
2. Celulares → Generar QR para vincular - usa el ID anterior, copia el string qr de la respuesta.
3. Convierte ese string a una imagen QR con una lib como qrcodejs y muestrala al usuario.
4. El usuario escanea el QR desde WhatsApp en su celular.
5. En 5-30 segundos, llama a Celulares → Status de la sesion WhatsApp para confirmar que quedo connected.

Variables utiles que puedes usar en los bodies

Postman soporta variables en cualquier parte del request. Ademas de {{api_key}}, {{api_base}} y {{destinatario_test}}, puedes:

• Usar {{$randomInt}} para generar un numero aleatorio en bodies
• Usar {{$isoTimestamp}} para timestamps
• Usar variables que captures de una respuesta previa con Tests + pm.environment.set('variable', pm.response.json().campo)

Como exportar y compartir

Para compartir tu environment o coleccion con tu equipo:

1. Click derecho en la coleccion o environment en el sidebar.
2. Export → Collection v2.1 (o Recommended).
3. Guarda el .json y mandaselo a tu companero.

Siguiente: OpenAPI / Swagger →