API: Gestion de Celulares

Endpoints para administrar los numeros de WhatsApp del cliente de forma remota: listar, ver, crear, editar, eliminar, generar QR de vinculacion y consultar status de la sesion.

GET /api/celulares.php

Lista todos los celulares del cliente. URL completa: https://api.multimensajes.com/api/celulares.php

Ejemplo cURL

curl -X GET 'https://api.multimensajes.com/api/celulares.php' \
  -H 'Authorization: Bearer WA_69_2e5ded25cd94d7b4'

Respuesta (200)

{
  "ok": true,
  "cliente_id": 55,
  "total": 2,
  "celulares": [
    {
      "id": 69,
      "numero": "5218713982936",
      "nombre_interno": "MF Hombre 001",
      "estado": "activo",
      "saldo_actual": 82,
      "max_envios_por_minuto": 4,
      "max_envios_por_hora": 40,
      "max_envios_por_dia": null,
      "hora_inicio_permitido": "00:00",
      "hora_fin_permitido": "23:59",
      "wasenderapi_instancia": "107549",
      "tiene_wasenderapi_token": true,
      "tiene_token_legacy": true,
      "last_status_check": "2026-08-09 20:30:00",
      "last_status": "connected"
    }
  ]
}

GET /api/celular.php?id=N

Detalle completo de un celular. URL completa: https://api.multimensajes.com/api/celular.php?id=69

Ejemplo cURL

curl -X GET 'https://api.multimensajes.com/api/celular.php?id=69' \
  -H 'Authorization: Bearer WA_69_2e5ded25cd94d7b4'

POST /api/celular_crear.php

Crea un celular nuevo (estado inicial: desconectado). Para vincularlo con WhatsApp via QR, llamar despues a /api/celular_qr.php?id=N. URL completa: https://api.multimensajes.com/api/celular_crear.php

Body (JSON)

{
  "numero": "5218711122233",
  "nombre_interno": "Mi numero principal"
}

Ejemplo cURL

curl -X POST 'https://api.multimensajes.com/api/celular_crear.php' \
  -H 'Authorization: Bearer WA_69_2e5ded25cd94d7b4' \
  -H 'Content-Type: application/json' \
  -d '{"numero": "5218711122233", "nombre_interno": "Mi numero"}'

Respuesta (201)

{
  "ok": true,
  "celular_id": 82,
  "numero": "5218711122233",
  "nombre_interno": "Mi numero",
  "estado": "desconectado",
  "next_step": "POST /api/celular_vincular.php?id=82 para generar QR y vincular WhatsApp"
}

Errores

POST /api/celular_editar.php?id=N

Edita uno o varios campos de un celular. Solo se actualizan los campos que envies. URL completa: https://api.multimensajes.com/api/celular_editar.php?id=69

Body (JSON)

{
  "nombre_interno": "Mi numero EDITADO",
  "max_envios_por_minuto": 10,
  "max_envios_por_hora": 100,
  "max_envios_por_dia": 2000,
  "hora_inicio_permitido": "08:00",
  "hora_fin_permitido": "22:00",
  "estado": "activo"
}

Ejemplo cURL

curl -X POST 'https://api.multimensajes.com/api/celular_editar.php?id=69' \
  -H 'Authorization: Bearer WA_69_2e5ded25cd94d7b4' \
  -H 'Content-Type: application/json' \
  -d '{"nombre_interno": "Editado", "max_envios_por_minuto": 10}'

POST /api/celular_eliminar.php?id=N

Elimina un celular con todos sus datos relacionados (mensajes, entrenamientos, movimientos de saldo). Genera un snapshot forense en la auditoria antes de borrar. Tambien desconecta la session de WhatsApp (best effort). URL completa: https://api.multimensajes.com/api/celular_eliminar.php?id=69

POST /api/celular_qr.php?id=N

Genera o recupera el QR para vincular el WhatsApp. Si el celular no tiene session, crea una automaticamente. Devuelve el string del QR que debes convertir a imagen (con una lib qrcode en JS o Python) y mostrar al usuario para que lo escanee desde WhatsApp. URL completa: https://api.multimensajes.com/api/celular_qr.php?id=82

Ejemplo cURL

curl -X POST 'https://api.multimensajes.com/api/celular_qr.php?id=82' \
  -H 'Authorization: Bearer WA_69_2e5ded25cd94d7b4'

Respuesta (200)

{
  "ok": true,
  "celular_id": 82,
  "wasenderapi_instancia": "107888",
  "qr": "2@abc123...,xyz456...",
  "status": "need_scan"
}

Como renderizar el QR en HTML

<!-- Incluye la lib qrcodejs -->
<script src="https://cdn.jsdelivr.net/npm/qrcodejs@1.0.0/qrcode.min.js"></script>
<div id="qr"></div>
<script>
  new QRCode(document.getElementById("qr"), "2@abc123...,xyz456...");
</script>

GET /api/celular_status.php?id=N

Consulta el status actual de la sesion de WhatsApp. Actualiza la BD local. URL completa: https://api.multimensajes.com/api/celular_status.php?id=69

Valores de status

Siguiente: Webhooks →