> ## 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 mensagens agendadas

> Lista mensagens agendadas com filtros por conversa, inbox e status. `page` padrão 1, `limit` padrão 20.



## OpenAPI

````yaml https://api.jurichat.com/docs/client/openapi.json get /scheduled-message/
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:
  /scheduled-message/:
    get:
      tags:
        - ScheduledMessages
      summary: Listar mensagens agendadas
      description: >-
        Lista mensagens agendadas com filtros por conversa, inbox e status.
        `page` padrão 1, `limit` padrão 20.
      parameters:
        - schema:
            anyOf:
              - type: string
              - type: number
            default: 1
          in: query
          name: page
          required: false
          description: Número da página.
        - schema:
            anyOf:
              - type: string
              - type: number
            default: 20
          in: query
          name: limit
          required: false
          description: Quantidade de itens por página.
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: conversationId
          required: false
          description: Filtra pelo ID da conversa.
        - schema:
            type: string
            pattern: ^[cC][^\s-]{8,}$
          in: query
          name: inboxId
          required: false
          description: Filtra pelo ID da inbox.
        - schema:
            type: string
            enum:
              - PENDING
              - SENT
              - CANCELLED
          in: query
          name: status
          required: false
          description: Filtra pelo status do agendamento.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: ID do agendamento.
                        conversationId:
                          type: string
                          description: ID da conversa vinculada.
                        userId:
                          type: string
                          nullable: true
                          description: >-
                            ID do usuário que criou o agendamento (null quando
                            criado por automação).
                        content:
                          description: Conteúdo da mensagem agendada.
                        type:
                          type: string
                          description: Tipo da mensagem (texto, imagem, etc.).
                        metadata:
                          nullable: true
                          description: Dados adicionais da mensagem. Null se não houver.
                        scheduledAt:
                          type: string
                          format: date-time
                          description: Data e hora programada para o envio.
                        status:
                          type: string
                          enum:
                            - PENDING
                            - SENT
                            - CANCELLED
                          description: Status do agendamento.
                        sentAt:
                          type: string
                          format: date-time
                          nullable: true
                          description: >-
                            Data e hora do envio efetivo. Null se ainda não
                            enviado.
                        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.
                        conversation:
                          type: object
                          properties:
                            id:
                              type: string
                              description: ID da conversa.
                            person:
                              type: object
                              properties:
                                id:
                                  type: string
                                  description: ID do contato.
                                name:
                                  type: string
                                  nullable: true
                                  description: Nome do contato. Null se não informado.
                                phoneNumber:
                                  type: string
                                  nullable: true
                                  description: Número de telefone do contato.
                              required:
                                - id
                                - name
                                - phoneNumber
                              additionalProperties: false
                              nullable: true
                              description: >-
                                Contato da conversa individual. Null para
                                grupos.
                            group:
                              type: object
                              properties:
                                id:
                                  type: string
                                  description: ID do grupo.
                                name:
                                  type: string
                                  description: Nome do grupo.
                              required:
                                - id
                                - name
                              additionalProperties: false
                              nullable: true
                              description: Dados do grupo. Null para conversas individuais.
                            integration:
                              type: object
                              properties:
                                id:
                                  type: string
                                  description: ID da integração.
                                channel:
                                  type: string
                                  description: >-
                                    Canal da integração (WHATSAPP,
                                    LITE_WHATSAPP, etc.).
                              required:
                                - id
                                - channel
                              additionalProperties: false
                              description: Integração vinculada à conversa.
                          required:
                            - id
                            - person
                            - group
                          additionalProperties: false
                      required:
                        - id
                        - conversationId
                        - userId
                        - type
                        - scheduledAt
                        - status
                        - sentAt
                        - createdAt
                        - updatedAt
                        - conversation
                      additionalProperties: false
                    description: Itens da página atual.
                  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.

````