Saltar al contenido principal
Los endpoints de listado devuelven una colección y un cursor opcional. Envía ese cursor sin modificar para leer la siguiente página. Continúa hasta que sea null o no aparezca.

Elige la colección

Los cuatro endpoints siguientes aceptan un limit de 1 a 100, con un valor predeterminado de 20. Usa la consulta de contactos por identificador o la consulta de usuarios de Bridge por identificador cuando necesites encontrar a una persona conocida. Recorrer toda una lista es una tarea distinta.

Ejemplo desde el servidor

Este ejemplo lee contactos. Guárdalo como list-contacts.mjs y configura BRIDGE_API_KEY y BRIDGE_WORKSPACE_ID en tu servidor. La protección local maxPages evita una ejecución ilimitada por accidente; no es un límite de la API de Bridge. La protección contra cursores repetidos detiene el proceso e informa el problema, en lugar de devolver silenciosamente una lista incompleta.
Usa pages("conversations", "conversations", { status: "ACTIVE" }), pages("users", "users") o pages("agents", "agents") con el contrato correspondiente. Conserva los mismos filtros durante todo un recorrido.

No te detengas en una página corta

Una página con menos registros que limit puede tener una página siguiente. El endpoint de agentes documenta expresamente este comportamiento. El cursor devuelto indica si debes continuar; la cantidad de elementos de la colección no lo indica. Trata el cursor como un valor opaco. No lo decodifiques, no lo incrementes ni construyas uno por tu cuenta. En el ejemplo, URL.searchParams conserva su valor mediante la codificación de URL.

Filtros y límites de solicitudes

  • Los filtros ownerEmail y search del listado de contactos están obsoletos. Para buscar un correo o teléfono conocido, usa la consulta por identificador. Para filtrar un inventario por ownerId, lee ese campo en las filas devueltas y filtra en tu código.
  • Los filtros email y status del listado de usuarios de Bridge están obsoletos. Usa la consulta por identificador para un correo conocido o revisa el status de cada usuario devuelto.
  • Cada solicitud de página consume el presupuesto compartido del espacio de trabajo. Sigue Límites de solicitudes, incluido Retry-After ante un 429. Este ejemplo mínimo se detiene si recibe una respuesta distinta de 200, en lugar de reintentar automáticamente.
Los contratos publicados no prometen una instantánea transaccional del listado mientras cambian los registros. No presentes este recorrido como una exportación cuya consistencia esté garantizada ni deduzcas una vigencia del cursor que no esté documentada.

Referencias