{
  "info": {
    "name": "MultiMensajes API",
    "description": "Coleccion para probar la API de MultiMensajes.\n\n**Como usar:**\n1. Importa este archivo en Postman (File > Import).\n2. Crea un Environment con la variable `api_key` (tu WA_<id>_<sig> o token legacy) y opcionalmente `api_base` (default: https://api.multimensajes.com).\n3. Todas las llamadas usan `{{api_key}}` automaticamente como Bearer token.\n4. Ejecuta las requests en orden: primero 'Login / Info' para verificar que la API key funciona.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {"key": "api_base", "value": "https://api.multimensajes.com", "type": "string"},
    {"key": "api_key", "value": "TU_API_KEY_AQUI", "type": "string"},
    {"key": "destinatario_test", "value": "5218711281619", "type": "string"}
  ],
  "auth": {
    "type": "bearer",
    "bearer": [
      {"key": "token", "value": "{{api_key}}", "type": "string"}
    ]
  },
  "item": [
    {
      "name": "Cuenta",
      "item": [
        {
          "name": "Info del cliente",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/info.php", "host": ["{{api_base}}"], "path": ["api", "info.php"]}
          }
        },
        {
          "name": "Saldo del cliente y celular",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/saldo.php", "host": ["{{api_base}}"], "path": ["api", "saldo.php"]}
          }
        }
      ]
    },
    {
      "name": "Celulares",
      "item": [
        {
          "name": "Listar celulares",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/celulares.php", "host": ["{{api_base}}"], "path": ["api", "celulares.php"]}
          }
        },
        {
          "name": "Ver detalle de un celular",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/celular.php?id=1", "host": ["{{api_base}}"], "path": ["api", "celular.php"], "query": [{"key": "id", "value": "1"}]}
          }
        },
        {
          "name": "Crear celular (sin vincular)",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numero\": \"5218711122233\",\n  \"nombre_interno\": \"Mi numero principal\"\n}"
            },
            "url": {"raw": "{{api_base}}/api/celular_crear.php", "host": ["{{api_base}}"], "path": ["api", "celular_crear.php"]}
          }
        },
        {
          "name": "Editar celular",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"nombre_interno\": \"Mi numero EDITADO\",\n  \"max_envios_por_minuto\": 10,\n  \"max_envios_por_hora\": 100\n}"
            },
            "url": {"raw": "{{api_base}}/api/celular_editar.php?id=1", "host": ["{{api_base}}"], "path": ["api", "celular_editar.php"], "query": [{"key": "id", "value": "1"}]}
          }
        },
        {
          "name": "Generar QR para vincular",
          "request": {
            "method": "POST",
            "header": [],
            "url": {"raw": "{{api_base}}/api/celular_qr.php?id=1", "host": ["{{api_base}}"], "path": ["api", "celular_qr.php"], "query": [{"key": "id", "value": "1"}]}
          }
        },
        {
          "name": "Status de la sesion WhatsApp",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/celular_status.php?id=1", "host": ["{{api_base}}"], "path": ["api", "celular_status.php"], "query": [{"key": "id", "value": "1"}]}
          }
        },
        {
          "name": "Eliminar celular (hard delete)",
          "request": {
            "method": "POST",
            "header": [],
            "url": {"raw": "{{api_base}}/api/celular_eliminar.php?id=1", "host": ["{{api_base}}"], "path": ["api", "celular_eliminar.php"], "query": [{"key": "id", "value": "1"}]}
          }
        }
      ]
    },
    {
      "name": "Mensajes - Texto",
      "item": [
        {
          "name": "Enviar texto (modo cola)",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"mensaje\": \"Hola desde Postman!\"\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_texto.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_texto.php"]}
          }
        },
        {
          "name": "Enviar texto (modo directo)",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"mensaje\": \"Texto directo!\",\n  \"directo\": 1\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_texto.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_texto.php"]}
          }
        }
      ]
    },
    {
      "name": "Mensajes - Multimedia (URL)",
      "item": [
        {
          "name": "Enviar imagen",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"url\": \"https://picsum.photos/600/400\",\n  \"caption\": \"Imagen desde Postman\"\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_imagen.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_imagen.php"]}
          }
        },
        {
          "name": "Enviar documento",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"url\": \"https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf\",\n  \"filename\": \"dummy.pdf\",\n  \"caption\": \"PDF desde Postman\"\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_documento.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_documento.php"]}
          }
        },
        {
          "name": "Enviar audio (voz)",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"url\": \"https://www.kozco.com/tech/piano2-CoolEdit.mp3\",\n  \"ptt\": true\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_audio.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_audio.php"]}
          }
        },
        {
          "name": "Enviar video",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"url\": \"https://download.samplelib.com/mp4/sample-5s.mp4\",\n  \"caption\": \"Video de prueba\"\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_video.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_video.php"]}
          }
        },
        {
          "name": "Enviar sticker",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"url\": \"https://raw.githubusercontent.com/twitter/twemoji/master/assets/72x72/1f60a.png\"\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_sticker.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_sticker.php"]}
          }
        }
      ]
    },
    {
      "name": "Mensajes - Base64",
      "item": [
        {
          "name": "Enviar imagen base64",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"data_base64\": \"<BASE64_DE_LA_IMAGEN>\",\n  \"mime\": \"image/jpeg\",\n  \"filename\": \"imagen.jpg\",\n  \"caption\": \"Imagen base64\"\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_imagen_base64.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_imagen_base64.php"]}
          }
        },
        {
          "name": "Enviar documento base64",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"{{api_key}}\",\n  \"destinatario\": \"{{destinatario_test}}\",\n  \"data_base64\": \"<BASE64_DEL_PDF>\",\n  \"mime\": \"application/pdf\",\n  \"filename\": \"doc.pdf\"\n}"
            },
            "url": {"raw": "{{api_base}}/api/mensaje_enviar_documento_base64.php", "host": ["{{api_base}}"], "path": ["api", "mensaje_enviar_documento_base64.php"]}
          }
        }
      ]
    },
    {
      "name": "Webhook",
      "item": [
        {
          "name": "Obtener configuracion actual",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/webhook.php", "host": ["{{api_base}}"], "path": ["api", "webhook.php"]}
          }
        },
        {
          "name": "Configurar webhook",
          "request": {
            "method": "POST",
            "header": [{"key": "Content-Type", "value": "application/json"}],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://mi-app.example.com/webhook/multimensajes\",\n  \"secret\": \"mi_secret_para_firma_hmac\",\n  \"eventos\": [\"messages.received\", \"message.status\", \"session.status\"],\n  \"activo\": true\n}"
            },
            "url": {"raw": "{{api_base}}/api/webhook.php", "host": ["{{api_base}}"], "path": ["api", "webhook.php"]}
          }
        },
        {
          "name": "Eliminar webhook",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {"raw": "{{api_base}}/api/webhook.php", "host": ["{{api_base}}"], "path": ["api", "webhook.php"]}
          }
        }
      ]
    },
    {
      "name": "Historial",
      "item": [
        {
          "name": "Listar ultimos 100 mensajes",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/historial_listar.php?page=1&per_page=100", "host": ["{{api_base}}"], "path": ["api", "historial_listar.php"], "query": [{"key": "page", "value": "1"}, {"key": "per_page", "value": "100"}]}
          }
        },
        {
          "name": "Filtrar por estado (enviados OK)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/historial_listar.php?estado=entregado&page=1", "host": ["{{api_base}}"], "path": ["api", "historial_listar.php"], "query": [{"key": "estado", "value": "entregado"}, {"key": "page", "value": "1"}]}
          }
        },
        {
          "name": "Filtrar por destinatario",
          "request": {
            "method": "GET",
            "header": [],
            "url": {"raw": "{{api_base}}/api/historial_listar.php?destinatario=5218711281619&page=1", "host": ["{{api_base}}"], "path": ["api", "historial_listar.php"], "query": [{"key": "destinatario", "value": "5218711281619"}, {"key": "page", "value": "1"}]}
          }
        }
      ]
    }
  ]
}