Historial de conexiones

Esta página documenta el historial de conexiones, una línea de tiempo auditable de cuándo cada número de WhatsApp fue vinculado (conectado) y desvinculado (desconectado) de una instancia. Sirve para que siga y compruebe qué número estuvo conectado en cada momento, útil al revisar un período facturado con transparencia, con el registro a mano.

Consultar el historial

GET /api/account/connections?number=<jid>&instance=<id>&from=<rfc3339>&to=<rfc3339>&limit=<n> Devuelve los eventos de vínculo y desvínculo de la cuenta, más recientes primero. Autentique con el TokenAccount de la cuenta, o con el token global pasando ?account=<nombre-de-la-cuenta>. Todos los filtros son opcionales: sin ninguno, recibe los eventos más recientes de la cuenta.

string

Filtra por un número específico. Use el JID exacto, ej. 5511999998888@s.whatsapp.net.

string

Filtra por una instancia específica. Use el instanceId que aparece en los propios eventos.

string

Inicio de la ventana, en RFC3339. Sin él, no hay límite inferior.

string

Fin de la ventana, en RFC3339. Sin él, no hay límite superior.

integer

Máximo de eventos a devolver. Predeterminado 200. Valores fuera del rango de 1 a 1000 también usan 200.

string

Nombre de la cuenta. Obligatorio solo cuando usa el token global.

curl "https://ryzeapi.cloud/api/account/connections?number=5511999998888@s.whatsapp.net&limit=50" \
  -H "token: $Token_Account"

const params = new URLSearchParams({
  number: "5511999998888@s.whatsapp.net",
  limit: "50"
});

await fetch(`https://ryzeapi.cloud/api/account/connections?${params}`, {
  headers: { "token": process.env.Token_Account }
});

import os, requests

requests.get(
    "https://ryzeapi.cloud/api/account/connections",
    headers={"token": os.environ["Token_Account"]},
    params={"number": "5511999998888@s.whatsapp.net", "limit": 50}
)

200 OK

{
  "events": [
    {
      "instanceId": "9f1c2b3a-7d4e-4a1b-9c2d-3e4f5a6b7c8d",
      "instanceName": "cliente-acme",
      "numberJid": "5511999998888@s.whatsapp.net",
      "event": "unlinked",
      "at": "2026-08-20T09:05:00Z"
    },
    {
      "instanceId": "9f1c2b3a-7d4e-4a1b-9c2d-3e4f5a6b7c8d",
      "instanceName": "cliente-acme",
      "numberJid": "5511999998888@s.whatsapp.net",
      "event": "linked",
      "at": "2026-08-01T12:30:00Z"
    }
  ]
}

Campos de la respuesta

array

Los eventos de conexión, más recientes primero. Una instancia eliminada conserva sus eventos, con el nombre y el número que tenía, porque el registro sobrevive a la eliminación.

Mostrar campos de cada evento

string

Identificador de la instancia. Use este valor en el filtro instance.

string

Nombre de la instancia en el momento del evento.

string

El número de WhatsApp (JID) involucrado en el evento.

string

linked cuando el número fue vinculado (conexión) o unlinked cuando fue desvinculado (desconexión).

string

Cuándo ocurrió el evento, en RFC3339 (UTC).

Extracto de uso

La factura con detalle del período, instancia por instancia.

Webhooks Enterprise

Reaccione a cada cambio de estado por evento.

Primeros pasos

Facturación

Auditoría

Referencia

Historial de conexiones

Consultar el historial

Campos de la respuesta

Siguiente

Extracto de uso

Webhooks Enterprise

​Consultar el historial

​Campos de la respuesta

​Siguiente

Extracto de uso

Webhooks Enterprise

Consultar el historial

Campos de la respuesta

Siguiente