WA Clientes

Autenticación

Todas las rutas de la API requieren el header x-api-key o el parámetro ?api_key=.

x-api-key: TU_API_KEY

GET /status

Verifica si WhatsApp está conectado. No requiere autenticación.

GET /status

Respuesta

{ "ready": true }

GET /verificar/:numero

Verifica si un número tiene WhatsApp.

GET /verificar/5491161889205
x-api-key: TU_API_KEY

Respuesta

{
  "numero": "5491161889205",
  "wid": "5491161889205",
  "tiene_whatsapp": true
}

Si el número no tiene código de país, se asume Argentina (+54).

POST /verificar/bulk

Verifica hasta 100 números en una sola llamada.

POST /verificar/bulk
x-api-key: TU_API_KEY
Content-Type: application/json

{
  "numeros": ["5491161889205", "5491161889206"]
}

Respuesta

{
  "total": 2,
  "resultados": [
    { "numero": "5491161889205", "wid": "5491161889205", "tiene_whatsapp": true },
    { "numero": "5491161889206", "wid": "5491161889206", "tiene_whatsapp": false }
  ]
}

GET /web/contactos

Extrae contactos de tus conversaciones individuales. Requiere sesión web (x-web-token).

GET /web/contactos?limit=50
x-web-token: TOKEN

Respuesta

{
  "total": 2,
  "contactos": [
    {
      "nombre": "Juan Pérez",
      "numero": "5491161889205",
      "foto": "https://...",
      "empresa": false,
      "enAgenda": true,
      "sinLeer": 3,
      "ultimoContacto": "2024-04-07",
      "archivado": false,
      "fijado": false,
      "ultimoMensaje": "Perfecto, mañana te llamo",
      "tipoUltimoMensaje": "chat"
    }
  ]
}

Los valores posibles de tipoUltimoMensaje: chat, image, video, audio, document, location, entre otros.

GET /web/exportar

Descarga las fotos de perfil al servidor y retorna un CSV con URLs permanentes.

GET /web/exportar?limit=50
x-web-token: TOKEN

Respuesta — archivo contactos-whatsapp.csv

nombre,numero,foto,empresa,en_agenda,sin_leer,ultimo_contacto,archivado,fijado,ultimo_mensaje,tipo_ultimo_mensaje
"Juan Pérez",+5491161889205,https://kapalua.site/wa-clientes/fotos/5491161889205.jpg,no,si,3,2024-04-07,no,no,"Perfecto mañana te llamo",chat

Códigos de error