> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airys.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact conversas

> Obter conversas associadas a esse contato



## OpenAPI

````yaml /pt-br/swagger/tag_groups/application_swagger.json get /api/v1/accounts/{account_id}/contacts/{id}/conversations
openapi: 3.1.0
info:
  title: Chatwoot
  description: Esta é a documentação da API para o servidor Chatwoot.
  version: 1.1.0
  termsOfService: https://www.chatwoot.com/terms-of-service/
  contact:
    email: hello@chatwoot.com
  license:
    name: MIT License
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://airys.chat/
security: []
tags:
  - name: AgentBots de Conta
    description: Agent Bots específicos da conta
  - name: Agentes
    description: APIs de gerenciamento de agentes
  - name: Respostas Prontas
    description: Respostas predefinidas para consultas comuns
  - name: Contatos
    description: APIs de gerenciamento de contatos
  - name: Rótulos de Contato
    description: Gerenciar rótulos de contato
  - name: Atribuições de Conversa
    description: Gerenciar atribuições de conversas
  - name: Rótulos de Conversa
    description: Gerenciar rótulos de conversas
  - name: Conversas
    description: APIs de gerenciamento de conversas
  - name: Atributos Personalizados
    description: Campos personalizados para contatos e conversas
  - name: Filtros Personalizados
    description: Filtros salvos para conversas
  - name: Caixas de Entrada
    description: Configuração de canais de comunicação
  - name: Integrações
    description: Integrações de terceiros
  - name: Rótulos
    description: APIs de gerenciamento de rótulos da conta
  - name: Mensagens
    description: APIs de gerenciamento de mensagens
  - name: Perfil
    description: APIs de perfil de usuário
  - name: Relatórios
    description: APIs de análise e relatórios
  - name: Equipes
    description: APIs de gerenciamento de equipe
  - name: Webhooks
    description: Webhooks de notificação de eventos
  - name: Regra de Automação
    description: Regras de automação de fluxo de trabalho
  - name: Central de Ajuda
    description: Gerenciamento da base de conhecimento
paths:
  /api/v1/accounts/{account_id}/contacts/{id}/conversations:
    parameters:
      - $ref: '#/components/parameters/account_id'
      - name: id
        in: path
        required: true
        schema:
          type: number
        description: ID do contato
    get:
      tags:
        - Contatos
      summary: Contact conversas
      description: Obter conversas associadas a esse contato
      operationId: contactConversations
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: number
          description: ID do contato
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/contact_conversations_response'
        '403':
          description: Acesso negado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request_error'
        '404':
          description: Contato não encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bad_request_error'
      security:
        - userApiKey: []
components:
  parameters:
    account_id:
      in: path
      name: account_id
      schema:
        type: integer
      required: true
      description: O ID numérico da conta
  schemas:
    contact_conversations_response:
      type: object
      properties:
        payload:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/conversation'
              - type: object
                properties:
                  meta:
                    type: object
                    properties:
                      sender:
                        type: object
                        properties:
                          additional_attributes:
                            type: object
                            description: Os atributos adicionais do remetente
                          availability_status:
                            type: string
                            description: O status de disponibilidade do remetente
                          email:
                            type:
                              - string
                              - 'null'
                            description: O e-mail do remetente
                          id:
                            type: number
                            description: ID do remetente
                          name:
                            type: string
                            description: O nome do remetente
                          phone_number:
                            type:
                              - string
                              - 'null'
                            description: O número de telefone do remetente
                          blocked:
                            type: boolean
                            description: Se o remetente está bloqueado
                          identifier:
                            type:
                              - string
                              - 'null'
                            description: O identificador do remetente
                          thumbnail:
                            type:
                              - string
                              - 'null'
                            description: URL do avatar do contato
                          custom_attributes:
                            type: object
                            description: Os atributos personalizados do remetente
                          last_activity_at:
                            type: number
                            description: A última atividade do remetente
                          created_at:
                            type: number
                            description: A data de criação do remetente
                      channel:
                        type: string
                        description: Tipo de Canal
                      assignee:
                        $ref: '#/components/schemas/user'
                      hmac_verified:
                        type: boolean
                        description: Se o hmac é verificado
          description: Lista de conversas do contato
    bad_request_error:
      title: data
      type: object
      properties:
        description:
          type: string
        errors:
          type: array
          items:
            $ref: '#/components/schemas/request_error'
    conversation:
      type: object
      properties:
        id:
          type: number
          description: ID da conversa
        messages:
          type: array
          items:
            $ref: '#/components/schemas/message'
        account_id:
          type: number
          description: ID da conta
        uuid:
          type: string
          description: UUID da conversa
        additional_attributes:
          type: object
          description: O objeto contendo atributos adicionais relacionados à conversa
        agent_last_seen_at:
          type: number
          description: A última atividade do agente
        assignee_last_seen_at:
          type: number
          description: A última atividade do responsável
        can_reply:
          type: boolean
          description: Se a conversa pode ser respondida
        contact_last_seen_at:
          type: number
          description: A última atividade em do contato
        custom_attributes:
          type: object
          description: >-
            O objeto para salvar atributos personalizados para a conversa,
            aceita chave e valor de atributos personalizados
        inbox_id:
          type: number
          description: ID da caixa de entrada
        labels:
          type: array
          items:
            type: string
          description: Os rótulos da conversa
        muted:
          type: boolean
          description: Se a conversa está silenciada
        snoozed_until:
          type:
            - number
            - 'null'
          description: O horário em que a conversa deixará de ser silenciada
        status:
          type: string
          enum:
            - open
            - resolved
            - pending
          description: O status da conversa
        created_at:
          type: number
          description: O horário em que a conversa foi criada
        updated_at:
          type: number
          description: O horário em que a conversa foi atualizada
        timestamp:
          type: number
          description: O horário em que a conversa foi criada
        first_reply_created_at:
          type:
            - number
            - 'null'
          description: O horário em que a primeira resposta foi criada
        unread_count:
          type: number
          description: O número de mensagens não lidas
        last_non_activity_message:
          oneOf:
            - $ref: '#/components/schemas/message'
            - type: 'null'
          description: A última mensagem de não atividade
        last_activity_at:
          type: number
          description: A última atividade da conversa
        priority:
          type:
            - string
            - 'null'
          description: A prioridade da conversa
        waiting_since:
          type:
            - number
            - 'null'
          description: O horário em que a conversa estava em espera
        sla_policy_id:
          type:
            - number
            - 'null'
          description: O ID da política de SLA
        applied_sla:
          type: object
          description: O SLA aplicado
        sla_events:
          type: array
          items:
            type: object
            description: Objetos de eventos de SLA
    user:
      type: object
      properties:
        id:
          type: number
        access_token:
          type: string
        account_id:
          type: number
        available_name:
          type: string
        avatar_url:
          type: string
        confirmed:
          type: boolean
        display_name:
          type:
            - string
            - 'null'
        message_signature:
          type:
            - string
            - 'null'
        email:
          type: string
        hmac_identifier:
          type: string
        inviter_id:
          type:
            - number
            - 'null'
        name:
          type: string
        provider:
          type: string
        pubsub_token:
          type: string
        role:
          type: string
          enum:
            - agent
            - administrator
        ui_settings:
          type: object
        uid:
          type: string
        type:
          type:
            - string
            - 'null'
        custom_attributes:
          type: object
          description: >-
            Disponível para usuários criados por meio das APIs da plataforma e
            que possuem atributos personalizados associados.
        accounts:
          type: array
          items:
            type: object
            properties:
              id:
                type: number
              name:
                type: string
              status:
                type: string
              active_at:
                type:
                  - string
                  - 'null'
                format: date-time
              role:
                type: string
                enum:
                  - administrator
                  - agent
              permissions:
                type: array
                items:
                  type: string
              availability:
                type: string
              availability_status:
                type: string
              auto_offline:
                type: boolean
              custom_role_id:
                type:
                  - number
                  - 'null'
              custom_role:
                type:
                  - object
                  - 'null'
    request_error:
      type: object
      properties:
        field:
          type: string
        message:
          type: string
        code:
          type: string
    message:
      type: object
      properties:
        id:
          type: number
          description: O ID da mensagem
        content:
          type: string
          description: O conteúdo de texto da mensagem
        account_id:
          type: number
          description: O ID da conta
        inbox_id:
          type: number
          description: O ID da caixa de entrada
        conversation_id:
          type: number
          description: O ID da conversa
        message_type:
          type: integer
          enum:
            - 0
            - 1
            - 2
            - 3
          description: O tipo da mensagem
        created_at:
          type: integer
          description: O horário em que a mensagem foi criada
        updated_at:
          type:
            - integer
            - string
          description: O horário em que a mensagem foi atualizada
        private:
          type: boolean
          description: As sinalizações (flags) que mostram se a mensagem é privada ou não
        status:
          type:
            - string
            - 'null'
          enum:
            - sent
            - delivered
            - read
            - failed
            - null
          description: O status da mensagem
        source_id:
          type:
            - string
            - 'null'
          description: O ID de origem da mensagem
        content_type:
          type:
            - string
            - 'null'
          enum:
            - text
            - input_text
            - input_textarea
            - input_email
            - input_select
            - cards
            - form
            - article
            - incoming_email
            - input_csat
            - integrations
            - sticker
            - voice_call
            - null
          description: O tipo de mensagem de modelo
        content_attributes:
          type: object
          description: Os atributos de conteúdo para cada content_type
        sender_type:
          type:
            - string
            - 'null'
          enum:
            - Contact
            - User
            - AgentBot
            - Captain::Assistant
            - null
          description: O tipo de remetente
        sender_id:
          type:
            - number
            - 'null'
          description: O ID do remetente
        external_source_ids:
          type: object
          description: Os IDs de origem externa da mensagem
        additional_attributes:
          type: object
          description: Os atributos adicionais da mensagem
        processed_message_content:
          type:
            - string
            - 'null'
          description: O conteúdo da mensagem processada
        sentiment:
          type:
            - object
            - 'null'
          description: O sentimento da mensagem
        conversation:
          type:
            - object
            - 'null'
          description: O objeto da conversa
        attachment:
          type:
            - object
            - 'null'
          description: O objeto de arquivo anexado à imagem
        sender:
          type: object
          description: Objeto Usuário/Agente/AgentBot
  securitySchemes:
    userApiKey:
      type: apiKey
      in: header
      name: api_access_token
      description: >-
        Este token pode ser obtido visitando a página de perfil ou por meio do
        console rails. Fornece acesso a endpoints com base nos níveis de
        permissões do usuário. Este token pode ser salvo por um sistema externo
        quando o usuário é criado via API, para realizar atividades em nome do
        usuário.

````