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 unlimit 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 comolist-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.
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 quelimit 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
ownerEmailysearchdel listado de contactos están obsoletos. Para buscar un correo o teléfono conocido, usa la consulta por identificador. Para filtrar un inventario porownerId, lee ese campo en las filas devueltas y filtra en tu código. - Los filtros
emailystatusdel listado de usuarios de Bridge están obsoletos. Usa la consulta por identificador para un correo conocido o revisa elstatusde cada usuario devuelto. - Cada solicitud de página consume el presupuesto compartido del espacio de trabajo. Sigue Límites de solicitudes, incluido
Retry-Afterante un429. Este ejemplo mínimo se detiene si recibe una respuesta distinta de 200, en lugar de reintentar automáticamente.

