> ## Documentation Index > Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar conversaciones del módulo tester > Variante del listado que devuelve **solo** conversaciones creadas desde el módulo tester del dashboard (feature donde el usuario prueba flujos con conversaciones ficticias; `is_tester = true`). Mismo shape de respuesta y paginación que `/conversations`. El listado principal ya incluye reales y tester mezclados — usar este endpoint solo si el cliente quiere exclusivamente tester sin filtrar client-side. ## OpenAPI ````yaml /openapi.json get /{slug}/tester/conversations openapi: 3.1.0 info: title: 1TO1 AI Public API version: 0.2.0 description: >- API pública de 1TO1 AI para integraciones externas (n8n, CRMs, scripts). Auth via Bearer token. Rate limit 60 req/min por API key. Contrato REST puro: el body de éxito es el payload directo (status HTTP como señal), errores retornan `{code, message}` con ambos campos garantizados. Ver schema `PublicError`. servers: - url: https://app.1to1.ai/api/v1/public description: Producción security: - bearerAuth: [] paths: /{slug}/tester/conversations: get: tags: - Conversations (tester) summary: Listar conversaciones del módulo tester description: >- Variante del listado que devuelve **solo** conversaciones creadas desde el módulo tester del dashboard (feature donde el usuario prueba flujos con conversaciones ficticias; `is_tester = true`). Mismo shape de respuesta y paginación que `/conversations`. El listado principal ya incluye reales y tester mezclados — usar este endpoint solo si el cliente quiere exclusivamente tester sin filtrar client-side. parameters: - $ref: '#/components/parameters/SlugPathParam' - schema: type: string minLength: 1 maxLength: 512 description: >- Cursor opaco devuelto por la página anterior. No reutilizar cursors entre endpoints distintos — aunque el formato sea idéntico, cada endpoint lo interpreta en su propio dataset. required: false description: >- Cursor opaco devuelto por la página anterior. No reutilizar cursors entre endpoints distintos — aunque el formato sea idéntico, cada endpoint lo interpreta en su propio dataset. name: cursor in: query - schema: type: integer minimum: 1 maximum: 100 description: Items por página. Default 50. example: 50 required: false description: Items por página. Default 50. name: limit in: query - schema: type: string enum: - asc - desc description: '`desc` (más recientes primero, default) o `asc`.' required: false description: '`desc` (más recientes primero, default) o `asc`.' name: order in: query responses: '200': description: Página de conversaciones tester headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/ConversationsListData' '400': description: >- Query params inválidos (INVALID_REQUEST) o cursor corrupto (INVALID_CURSOR) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '401': description: Token ausente, mal formado o no válido (INVALID_API_TOKEN) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '403': description: >- El slug del path no coincide con el business del token (TOKEN_BUSINESS_MISMATCH) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '429': description: >- Rate limit excedido (RATE_LIMIT_EXCEEDED). Headers `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` indican cuándo reintentar. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '500': description: Error inesperado del servidor (UNKNOWN_ERROR) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' components: parameters: SlugPathParam: schema: $ref: '#/components/schemas/SlugPathParam' required: true description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. name: slug in: path schemas: ConversationsListData: type: object properties: items: type: array items: $ref: '#/components/schemas/ConversationSummary' next_cursor: type: - string - 'null' has_more: type: boolean required: - items - next_cursor - has_more PublicError: type: object properties: code: type: string example: INVALID_API_TOKEN message: type: string example: >- The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token. required: - code - message description: >- Public API error body. The client should match against `code` (stable canonical identifier) and NOT against `message` (human text, may be refined between API versions without notice). The HTTP status code is the error-type signal (4xx client, 5xx server). SlugPathParam: type: string example: acme description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. ConversationSummary: type: object properties: uuid: type: string format: uuid contact: type: object properties: uuid: type: string format: uuid name: type: - string - 'null' profile_name: type: - string - 'null' phone: type: - string - 'null' whatsapp_user_id: type: - string - 'null' description: >- BSUID del contacto (identificador forward-compatible). Devuelve el BSUID real cuando existe, con fallback al teléfono (`phone`) mientras Meta no migre. Para resolver una conversación con un valor de fallback, reenvíalo como `phone` (el resolver solo acepta BSUIDs reales y daría `404`). required: - uuid - name - profile_name - phone - whatsapp_user_id last_message_at: type: - string - 'null' format: date-time last_message_preview: $ref: '#/components/schemas/LastMessagePreview' inbox_status: type: string enum: - pending - resolved response_status: type: string enum: - unread - pending - responded unread_count: type: integer minimum: 0 mailbox: type: - object - 'null' properties: uuid: type: string format: uuid name: type: string required: - uuid - name ai_employee: type: - object - 'null' properties: uuid: type: string format: uuid name: type: string required: - uuid - name tags: type: array items: type: object properties: uuid: type: string format: uuid name: type: string color: type: string required: - uuid - name - color messaging_window_expires_at: type: - string - 'null' format: date-time is_tester: type: boolean description: >- Indica si la conversación fue creada desde el módulo tester del dashboard (feature donde el usuario prueba flujos con conversaciones ficticias). El listado devuelve reales y tester mezclados; filtrar por este campo si el cliente solo necesita uno de los dos. Para solo-tester existe `/tester/conversations`. required: - uuid - contact - last_message_at - last_message_preview - inbox_status - response_status - unread_count - mailbox - ai_employee - tags - messaging_window_expires_at - is_tester LastMessagePreview: type: - object - 'null' properties: body: type: - string - 'null' example: sí, te mando el documento content_type: type: string enum: - text - image - audio - video - document - location - sticker - contacts - template - interactive - reaction example: text is_from_customer: type: boolean description: >- Prefijo "Tú:" en UI cuando `false`. Útil para distinguir mensajes del negocio (humano o AI) vs mensajes del cliente en el preview. required: - body - content_type - is_from_customer securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: sk_1to1_ description: >- API token emitido desde Settings → API Token del dashboard 1TO1 AI. Enviar en header Authorization: Bearer sk_1to1_... ````