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

# Listar ligações em andamento

> Lista as ligações em andamento da integração, incluindo as que tocam para os atendentes. Use `answeredBy` e `queued` para saber com quem cada uma está.



## OpenAPI

````yaml GET /call/list
openapi: 3.1.0
info:
  title: OpenAPI Multchats
  description: Multchats API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.multchats.com/v2
security:
  - bearerAuth: []
paths:
  /call/list:
    get:
      tags:
        - Calls
      summary: Listar ligações em andamento
      description: >-
        Lista as ligações em andamento da integração, incluindo as que tocam
        para os atendentes. Use `answeredBy` e `queued` para saber com quem cada
        uma está.
      parameters:
        - name: integrationId
          in: query
          required: true
          description: ID da integração (tipo HyperMeow com ligações)
          schema:
            type: string
            pattern: ^c[a-z0-9]{24}$
      responses:
        '200':
          description: Ligações listadas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCallsResponse'
        '400':
          description: >-
            Erro na requisição. Código: `CALL_NOT_SUPPORTED` (a integração não
            faz ligações)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ListCallsResponse:
      type: object
      properties:
        success:
          description: Indica se a operação foi bem-sucedida
          type: boolean
          default: true
        calls:
          type: array
          items:
            $ref: '#/components/schemas/Call'
    Error:
      required:
        - success
        - message
      type: object
      properties:
        success:
          description: Indica se a operação foi bem-sucedida
          type: boolean
          default: false
        message:
          description: Mensagem de erro (quando success é false)
          type: string
          default: Erro ao enviar mensagem
    Call:
      type: object
      properties:
        callId:
          description: ID da ligação
          type: string
        integrationId:
          description: ID da integração
          type: string
        direction:
          description: Sentido da ligação
          type: string
          enum:
            - incoming
            - outgoing
        chatId:
          description: WhatsApp ID do contato
          type: string
        peer:
          description: ID do contato na ligação
          type: string
        isVideo:
          description: Se é uma chamada de vídeo
          type: boolean
        state:
          description: Estado da ligação
          type: string
          enum:
            - ringing
            - connecting
            - active
            - ended
        reason:
          description: Motivo do encerramento, quando terminou
          type: string
        startedAt:
          description: Início da ligação (Unix, ms)
          type: integer
        answeredAt:
          description: Quando foi atendida (Unix, ms); 0 se ainda não foi
          type: integer
        endedAt:
          description: Quando terminou (Unix, ms); 0 se não terminou
          type: integer
        chatInternalId:
          description: ID da conversa do contato, quando existe
          type:
            - string
            - 'null'
        contactName:
          description: Nome do contato
          type:
            - string
            - 'null'
        contactPicture:
          description: Foto do contato
          type:
            - string
            - 'null'
        answeredBy:
          description: >-
            Com quem está a ligação: `api` para a API, o ID do atendente, ou
            null se ninguém atendeu
          type:
            - string
            - 'null'
        queued:
          description: Se a ligação foi transferida para a fila pela API
          type: boolean
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.