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

# Listar mensagens da corrida como condutor

> Devolve as mensagens trocadas entre passageiro e condutor de uma corrida, em ordem crescente de `sequencial`, e marca como lidas, pelo condutor, as mensagens retornadas. Só a corrida que aceita o envio como condutor pode ser lida por este endpoint. O nome do passageiro vem com o sobrenome oculto, como no app do condutor.

A mensagem do passageiro aparece aqui: é por este endpoint que você acompanha a conversa.



## OpenAPI

````yaml pages/v2/openapi-corridas.json GET /mensagens/corridas/condutor/{solicitacao_id}
openapi: 3.1.0
info:
  title: API de Integração
  description: API de Integração v2 - Corridas
  license:
    name: MIT
  version: 2.0.0
servers:
  - url: https://api-vendas.taximachine.com.br/api/v2/integracao
  - url: https://api.taximachine.com.br/api/v2/integracao
security:
  - basicAuth: []
    ApiKeyAuth: []
paths:
  /mensagens/corridas/condutor/{solicitacao_id}:
    get:
      summary: Listar mensagens da conversa da corrida como condutor
      description: >-
        Devolve as mensagens trocadas entre passageiro e condutor de uma
        corrida, em ordem crescente de `sequencial`, e marca como lidas, pelo
        condutor, as mensagens retornadas. Só a corrida que aceita o envio como
        condutor pode ser lida por este endpoint. O nome do passageiro vem com o
        sobrenome oculto, como no app do condutor.


        A mensagem do passageiro aparece aqui: é por este endpoint que você
        acompanha a conversa.
      parameters:
        - name: solicitacao_id
          in: path
          required: true
          description: >-
            ID da corrida (solicitação) cuja conversa será lida. Deve ser
            numérico.
          schema:
            type: integer
      responses:
        '200':
          description: Mensagens da conversa, em ordem crescente de sequencial
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      solicitacao_id:
                        type: integer
                      conversa_id:
                        type: integer
                        nullable: true
                        description: Nulo quando a corrida ainda não tem conversa.
                      mensagens:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: integer
                              description: Identificador da mensagem.
                            sequencial:
                              type: integer
                              description: >-
                                Posição da mensagem na conversa. Cresce a cada
                                mensagem nova.
                            texto:
                              type: string
                            data_hora:
                              type: string
                              description: >-
                                Data e hora do envio, no formato `YYYY-MM-DD
                                HH:MM:SS`, na hora local da central.
                              example: '2026-09-22 14:02:11'
                            remetente:
                              type: object
                              properties:
                                tipo:
                                  type: string
                                  enum:
                                    - passageiro
                                    - condutor
                                    - central
                                id:
                                  type: integer
                                  nullable: true
                                  description: >-
                                    ID do passageiro, do condutor ou do gestor,
                                    conforme o tipo.
                                nome:
                                  type: string
                  __links:
                    type: object
                    description: >-
                      Links HATEOAS do domínio, indexados pelo rel. `self`
                      aponta para o próprio endpoint.
              examples:
                conversa:
                  summary: Conversa com mensagens do condutor e do passageiro
                  value:
                    success: true
                    data:
                      solicitacao_id: 639
                      conversa_id: 8
                      mensagens:
                        - id: 12045
                          sequencial: 1
                          texto: Estou a caminho.
                          data_hora: '2026-09-23 15:51:11'
                          remetente:
                            tipo: condutor
                            id: 1
                            nome: Carlos Silva
                        - id: 12046
                          sequencial: 2
                          texto: Cheguei, estou na entrada principal.
                          data_hora: '2026-09-23 15:52:04'
                          remetente:
                            tipo: condutor
                            id: 1
                            nome: Carlos Silva
                        - id: 12047
                          sequencial: 3
                          texto: Desço em 2 minutos.
                          data_hora: '2026-09-23 15:52:19'
                          remetente:
                            tipo: passageiro
                            id: 543
                            nome: Felipe
                    __links:
                      self:
                        href: api/v2/integracao/mensagens/corridas/condutor/{id}
                        metodo: get
                      enviar-mensagem-corrida-condutor:
                        href: api/v2/integracao/mensagens/corridas/condutor
                        metodo: post
                sem_conversa:
                  summary: Corrida em que ninguém escreveu ainda
                  value:
                    success: true
                    data:
                      solicitacao_id: 642
                      conversa_id: null
                      mensagens: []
                    __links:
                      self:
                        href: api/v2/integracao/mensagens/corridas/condutor/{id}
                        metodo: get
                      enviar-mensagem-corrida-condutor:
                        href: api/v2/integracao/mensagens/corridas/condutor
                        metodo: post
        '400':
          description: Erro de regra de negócio
          content:
            application/json:
              schema:
                type: object
              examples:
                corrida_outra_central:
                  summary: >-
                    Central que recebeu o pedido numa corrida de repasse (só a
                    central que atende a corrida fala pelo condutor)
                  value:
                    success: false
                    errors:
                      - code: 0
                        message: >-
                          Só a central que atende a corrida pode trocar
                          mensagens pelo condutor.
                corrida_sem_condutor_do_parceiro:
                  summary: >-
                    Corrida que não foi pedida pelo app do passageiro, ou em que
                    o condutor não é do parceiro
                  value:
                    success: false
                    errors:
                      - code: 0
                        message: A conversa da corrida não está disponível.
                conversa_empresa_condutor:
                  summary: A conversa da corrida é entre empresa e condutor
                  value:
                    success: false
                    errors:
                      - code: 0
                        message: A conversa desta corrida é entre empresa e condutor.
        '401':
          description: Credenciais ausentes ou inválidas
          content:
            application/json:
              schema:
                type: object
              examples:
                gestor_invalido:
                  summary: Usuário ou senha do Basic Auth inválidos
                  value:
                    success: false
                    errors:
                      - code: 401
                        message: Usuário e/ou senhas inválidos.
                api_key_invalida:
                  summary: Api-Key ausente ou sem bandeira
                  value:
                    success: false
                    errors:
                      - code: 401
                        message: Você não está autorizado a acessar este recurso.
        '404':
          description: Corrida não encontrada no escopo do parceiro
          content:
            application/json:
              schema:
                type: object
              example:
                success: false
                errors:
                  - code: 404
                    message: Solicitação não encontrada.
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: Obrigatório. Sua chave API.

````