> ## Documentation Index > Fetch the complete documentation index at: https://docs.jurichat.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar conversas > Lista conversas da inbox com filtros por status, prioridade, canal, tags e texto. Use `page` e `limit` para paginar. ## OpenAPI ````yaml https://api.jurichat.com/docs/client/openapi.json get /conversation/ openapi: 3.1.0 info: title: JuriChat API — Documentação para Integradores description: '' version: 1.0.0 servers: - url: https://api.jurichat.com description: Production server security: - apiKeyAuth: [] tags: [] paths: /conversation/: get: tags: - Conversations summary: Listar conversas description: >- Lista conversas da inbox com filtros por status, prioridade, canal, tags e texto. Use `page` e `limit` para paginar. parameters: - schema: anyOf: - type: string - type: number in: query name: page required: false description: Número da página. - schema: anyOf: - type: string - type: number in: query name: limit required: false description: Quantidade de itens por página. - schema: type: string in: query name: inboxId required: true description: ID da inbox. Obrigatório para filtrar as conversas. - schema: type: string in: query name: content required: false description: >- Filtra por nome, telefone ou grupo. Com 3+ caracteres, também busca no texto das mensagens. - schema: type: string in: query name: tags required: false description: Filtra por tags (IDs separados por vírgula ou outro formato aceito). - schema: anyOf: - type: string enum: - all - type: string pattern: ^[cC][^\s-]{8,}$ - type: array items: type: string pattern: ^[cC][^\s-]{8,}$ in: query name: integrationId required: false description: >- Filtra por canal de integração. Pode ser `all`, um ID ou uma lista de IDs. - schema: type: string enum: - ROBOT_INTERACTIVE - INACTIVE - HUMAN_INTERACTIVE - WAITING_HUMAN in: query name: status required: false description: Filtra pelo status da conversa. - schema: type: string enum: - LOW - MEDIUM - HIGH in: query name: priority required: false description: Filtra pela prioridade da conversa. - schema: type: string pattern: ^[cC][^\s-]{8,}$ in: query name: userId required: false description: Filtra pelo ID do usuário responsável. - schema: type: string in: query name: departmentId required: false description: Filtra pelo ID do departamento responsável pela conversa. - schema: type: boolean in: query name: assignedToMe required: false description: >- Quando verdadeiro, retorna apenas as conversas atribuídas ao usuário logado ou aos departamentos dele. - schema: type: boolean in: query name: showOnlyUnread required: false description: Quando verdadeiro, retorna apenas conversas com mensagens não lidas. - schema: type: boolean in: query name: showGroups required: false description: Quando verdadeiro, inclui conversas de grupo. - schema: type: boolean in: query name: onlyGroups required: false description: Quando verdadeiro, retorna apenas conversas de grupo. - schema: type: boolean in: query name: onlyPrivate required: false description: Quando verdadeiro, retorna apenas conversas individuais (1:1). - schema: type: boolean in: query name: onlyArchived required: false description: Quando verdadeiro, retorna apenas conversas arquivadas. responses: '200': description: Default Response content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string description: ID da conversa. status: type: string enum: - ROBOT_INTERACTIVE - INACTIVE - HUMAN_INTERACTIVE - WAITING_HUMAN description: Status atual da conversa. priority: type: string enum: - LOW - MEDIUM - HIGH description: Prioridade da conversa. isFixed: type: boolean description: Indica se a conversa está fixada na inbox. isGroup: type: boolean description: Indica se é uma conversa de grupo. isPrivate: type: boolean description: Indica se é uma conversa individual (1:1). isArchived: type: boolean description: Indica se a conversa está arquivada. responsables: type: array items: type: string description: IDs dos usuários responsáveis pela conversa. person: type: object properties: id: type: string name: type: string nullable: true imageUrl: type: string nullable: true phoneNumber: type: string nullable: true externalIdentitySource: type: string enum: - WEB_CHAT - INSTAGRAM nullable: true externalIdentityId: type: string nullable: true required: - id - name - imageUrl - phoneNumber additionalProperties: false nullable: true description: >- Contato vinculado à conversa individual. Null para grupos. group: type: object properties: id: type: string name: type: string externalId: type: string imageUrl: type: string nullable: true required: - id - name - externalId - imageUrl additionalProperties: false nullable: true description: Dados do grupo. Null para conversas individuais. lastMessage: type: object properties: id: type: string content: type: string nullable: true type: type: string direction: type: string description: >- Direção da última mensagem: INBOUND (cliente) ou OUTBOUND (atendente/IA). messageAt: type: string userId: type: string nullable: true userName: type: string nullable: true isViewedBySameUserLastMessage: type: boolean additionalProperties: false description: >- Resumo da última mensagem. Omitido se não houver mensagens. user: type: object properties: id: type: string name: type: string imageUrl: type: string nullable: true required: - id - name - imageUrl additionalProperties: false nullable: true description: >- Atendente atribuído à conversa. Null se não atribuído. formattedDate: type: string nullable: true description: Data formatada para exibição. createdAt: type: string format: date-time description: Data e hora de criação. updatedAt: type: string format: date-time description: Data e hora da última atualização. unreadCount: type: number nullable: true description: >- Quantidade de mensagens não lidas. Null se não calculado. scheduledMessagesCount: type: number description: >- Quantidade de mensagens agendadas pendentes vinculadas à conversa. department: type: object properties: id: type: string name: type: string required: - id - name additionalProperties: false nullable: true description: >- Departamento responsável pela fila. Null se não atribuído. tags: type: array items: type: object properties: id: type: string name: type: string color: type: string required: - id - name - color additionalProperties: false description: Tags associadas à conversa. inbox: type: object properties: id: type: string name: type: string required: - id - name additionalProperties: false description: Inbox à qual a conversa pertence. integration: type: object properties: id: type: string name: type: string channel: type: string required: - id - name additionalProperties: false description: Canal de integração da conversa. legalArea: type: object properties: id: type: string name: type: string color: type: string required: - id - name - color additionalProperties: false nullable: true description: >- Área jurídica associada à conversa. Null se não atribuída. required: - id - status - priority - isFixed - isGroup - isPrivate - isArchived - responsables - person - group - user - formattedDate - createdAt - updatedAt - unreadCount - scheduledMessagesCount - department - tags - inbox - integration - legalArea additionalProperties: false totalResults: type: number description: Total de registros encontrados. totalPages: type: number description: Total de páginas para a quantidade solicitada. required: - data - totalResults - totalPages additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: message: type: string statusCode: type: number details: {} required: - message - statusCode additionalProperties: false security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-jurichat-api-key description: >- Chave de API do escritório (criada no painel). Envie o valor no header x-jurichat-api-key. ````