Cómo probar MiSender API con Postman paso a paso

1. Descarga Postman desde el sitio oficial

Abre Descargar Postman y elige la aplicación para tu sistema operativo. También existe una versión web; para una experiencia completa recomendamos la aplicación de escritorio.

Si utilizas Postman en el navegador y necesitas el agente local, descárgalo desde la página oficial de Postman Agent.

2. Prepara MiSender

1. Inicia sesión como owner.
2. Abre Configuración → API.
3. Comprueba que la API esté habilitada.
4. Crea una llave con los scopes que probarás.
5. Copia la llave cuando aparezca: sólo se muestra completa una vez.

3. Crea un ambiente en Postman

1. En la barra lateral selecciona Environments.
2. Presiona el botón para crear un ambiente nuevo.
3. Llámalo MiSender Producción o MiSender Pruebas.
4. Agrega las variables siguientes.
5. Marca misender_api_key como sensible o utiliza únicamente su valor local.
6. Selecciona el ambiente desde el selector superior.

misender_base_url  = https://misender.com/api/v1
misender_api_key   = ms_live_TU_LLAVE_REAL
misender_phone     = 5215555555555
misender_message_id =

Postman referencia variables entre llaves dobles: {{misender_base_url}}. Su documentación oficial explica cómo crear y proteger variables de ambiente.

4. Crea una colección

1. Selecciona Collections → New Collection.
2. Llámala MiSender API V1.
3. En la pestaña Authorization elige Bearer Token.
4. En Token escribe {{misender_api_key}}.
5. Guarda la colección.

Las solicitudes guardadas dentro de la colección pueden heredar esta autorización. Postman añadirá correctamente el encabezado Authorization: Bearer ....

5. Prueba primero la conexión de WhatsApp

1. Agrega una solicitud llamada Estado de WhatsApp.
2. Selecciona el método GET.
3. Escribe la URL siguiente.
4. Presiona Send.

{{misender_base_url}}/whatsapp

Respuesta esperada

{
  "data": {
    "connected": true,
    "status": "connected",
    "display_phone_number": "+52 55 5555 5555",
    "verified_name": "Mi Empresa",
    "updated_at": "2026-10-02 18:00:00"
  }
}

Si recibes 401 invalid_api_key, revisa la variable y la autorización Bearer. Si recibes 403 insufficient_scope, la llave necesita whatsapp:read.

6. Envía un mensaje de texto

1. Crea una solicitud llamada Enviar texto.
2. Selecciona POST.
3. Usa {{misender_base_url}}/messages.
4. En Headers agrega Idempotency-Key.
5. En Body elige raw y después JSON.
6. Pega el cuerpo y presiona Send.

Content-Type: application/json
Idempotency-Key: postman-prueba-texto-001

{
  "to": "{{misender_phone}}",
  "type": "text",
  "text": {
    "body": "Hola, esta es una prueba transaccional desde Postman.",
    "preview_url": false
  },
  "external_id": "postman-prueba-001",
  "metadata": {
    "origen": "postman"
  }
}

Respuesta esperada

La primera petición correcta devuelve 202 Accepted, un identificador msg_... y estado queued. Esto significa que fue validada y encolada; no confirma todavía la entrega.

{
  "data": {
    "id": "msg_...",
    "status": "queued",
    "to": "5215555555555",
    "type": "text",
    "external_id": "postman-prueba-001",
    "metadata": {"origen": "postman"},
    "provider_message_id": null,
    "error": null
  },
  "idempotent_replay": false
}

7. Guarda automáticamente el ID del mensaje

Abre la pestaña Scripts → Post-response de la solicitud y agrega:

const response = pm.response.json();
if (response.data && response.data.id) {
  pm.environment.set("misender_message_id", response.data.id);
}

Después de enviar, la variable misender_message_id contendrá el ID público devuelto.

8. Consulta el estado

1. Crea una solicitud Consultar mensaje.
2. Selecciona GET.
3. Usa la URL siguiente y presiona Send.

{{misender_base_url}}/messages/{{misender_message_id}}

El estado puede avanzar por queued, processing, sent, delivered y read. Si aparece failed, consulta el objeto error.

9. Prueba las templates aprobadas

Crea una solicitud GET para consultar primero las templates de la cuenta:

{{misender_base_url}}/templates?status=APPROVED&limit=25&after=0

Después crea una solicitud POST a /messages, utiliza una nueva Idempotency-Key y copia exactamente name y language.

{
  "to": "{{misender_phone}}",
  "type": "template",
  "template": {
    "name": "confirmacion_pedido",
    "language": "es_MX",
    "components": [
      {
        "type": "body",
        "parameters": [
          {"type": "text", "text": "84721"}
        ]
      }
    ]
  },
  "external_id": "postman-template-001"
}

10. Comprueba la idempotencia

1. Envía dos veces exactamente la misma solicitud con la misma Idempotency-Key.
2. La segunda respuesta debe ser HTTP 200 con idempotent_replay: true.
3. Cambia el cuerpo sin cambiar la clave.
4. MiSender debe responder 409 idempotency_conflict.

Esta prueba demuestra que un reintento de red no creará el mismo mensaje dos veces.

Errores comunes en Postman

• 401: la colección no está enviando Bearer Token o la variable está vacía.
• 403: falta un scope, la API no está activa o la cuenta no dispone del acceso requerido.
• 422 outside_customer_window: intenta una template aprobada o responde dentro de una ventana válida.
• 422 invalid_recipient: usa número internacional, sin espacios ni signo +.
• 429: espera el tiempo de Retry-After.

Lista final de comprobación

• El ambiente correcto está seleccionado.
• La llave se guarda como valor privado.
• La colección usa Bearer Token.
• Cada operación nueva tiene una Idempotency-Key distinta.
• El teléfono tiene formato internacional.
• No compartiste ni exportaste una llave real.
• Guardaste data.id para consultar el resultado.

Fuentes oficiales de Postman

• Descargar Postman.
• Crear y enviar solicitudes.
• Autenticación Bearer Token.
• Variables de ambiente.