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

# Enviar menu de lista

> Envia uma mensagem de menu em que o destinatário toca em `buttonText` para abrir seções de linhas selecionáveis.



## OpenAPI

````yaml openapi.evolution-go.pt.json POST /send/list
openapi: 3.1.0
info:
  title: Evolution GO Layer
  version: 1.0.0
  description: >-
    Camada de API do Pilot Status — Evolution GO. Base URL
    `https://pilotstatus.com.br/api/layer/evolution-go`. Autentique com o header
    `apikey` (sua chave `ps_` do Pilot Status) ou `Authorization: Bearer`.
    Endpoints de instância/sessão NÃO estão disponíveis na camada.
servers:
  - url: https://pilotstatus.com.br/api/layer/evolution-go
security:
  - apiKey: []
tags:
  - name: Chamada (voz)
  - name: Chat
  - name: Comunidade
  - name: Grupo
  - name: Etiqueta (label)
  - name: Mensagem
  - name: Newsletter / Canais
  - name: Envio (balanceado)
  - name: Usuário / Contatos
paths:
  /send/list:
    post:
      tags:
        - Envio (balanceado)
      summary: Enviar menu de lista
      description: >-
        Envia uma mensagem de menu em que o destinatário toca em `buttonText`
        para abrir seções de linhas selecionáveis.
      operationId: post__send_list
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                number:
                  type: string
                  description: MSISDN ou JID do destinatário.
                  example: '5511999999999'
                title:
                  type: string
                  description: Texto do cabeçalho/título.
                  example: Menu
                description:
                  type: string
                  description: Texto do corpo.
                  example: Choose an option
                buttonText:
                  type: string
                  description: Rótulo do botão que abre a lista.
                  example: Open menu
                footerText:
                  type: string
                  description: Texto do rodapé.
                  example: Pilot Status
                sections:
                  type: array
                  description: >-
                    Objetos de seção: `{ title, rows: [{ title, description,
                    rowId }] }`.
                  items:
                    type: object
                  example:
                    - title: Drinks
                      rows:
                        - title: Coffee
                          description: Hot brewed
                          rowId: drink_coffee
                        - title: Tea
                          description: Green tea
                          rowId: drink_tea
                id:
                  type: string
                  description: Identificador de mensagem fornecido pelo cliente.
                delay:
                  type: integer
                  description: Milissegundos a aguardar antes de enviar.
                mentionedJid:
                  type: string
                  description: JID(s) a mencionar.
                mentionAll:
                  type: boolean
                  description: Menciona todos os participantes (grupos).
                formatJid:
                  type: boolean
                  description: Formata automaticamente `number` em um JID (padrão `true`).
                quoted:
                  type: object
                  description: 'Referência de resposta: `{ "messageId", "participant" }`.'
              required:
                - number
                - title
                - description
                - buttonText
                - footerText
                - sections
      responses:
        '200':
          description: Sucesso — corpo de resposta nativo do provedor.
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Standard Evolution GO send envelope (gin.H). The passthrough
                  layer returns this native body verbatim.
                properties:
                  message:
                    type: string
                    description: Fixed status label; always "success" on HTTP 200.
                  data:
                    type: object
                    description: >-
                      List-menu message send result. Serialized
                      MessageSendStruct (no JSON tags → PascalCase keys
                      Info/Message/MessageContextInfo).
                    properties:
                      Info:
                        type: object
                        description: >-
                          whatsmeow types.MessageInfo — metadata of the
                          just-sent message (MessageSource fields are
                          promoted/flattened). No JSON tags, so keys use Go
                          field names (PascalCase). JID fields (Chat/Sender/…)
                          implement MarshalText and serialize as strings.
                        properties:
                          Chat:
                            type: string
                            description: >-
                              Recipient JID (user "<num>@s.whatsapp.net" or
                              group "<id>@g.us").
                          Sender:
                            type: string
                            description: >-
                              Sender JID = this connected number (own device,
                              includes device suffix).
                          IsFromMe:
                            type: boolean
                            description: Always true for messages sent through this API.
                          IsGroup:
                            type: boolean
                            description: Whether Chat is a group.
                          AddressingMode:
                            type: string
                            description: 'Addressing mode: "", "pn" (phone number) or "lid".'
                          SenderAlt:
                            type: string
                            description: >-
                              Alternative sender address (LID/PN); empty string
                              when unused.
                          RecipientAlt:
                            type: string
                            description: >-
                              Alternative recipient address; empty string when
                              unused.
                          BroadcastListOwner:
                            type: string
                            description: Broadcast-list owner JID; empty for normal chats.
                          BroadcastRecipients:
                            type:
                              - array
                              - 'null'
                            items:
                              type: object
                            description: Broadcast recipients; null for normal sends.
                          ID:
                            type: string
                            description: Server message ID assigned to the sent message.
                          ServerID:
                            type: integer
                            description: Newsletter/server sequence ID; 0 for normal chats.
                          Type:
                            type: string
                            description: >-
                              Internal message type label; "ListMessage" for
                              list menus.
                          PushName:
                            type: string
                            description: Sender push name; empty on send.
                          Timestamp:
                            type: string
                            format: date-time
                            description: Send time (RFC 3339).
                          Category:
                            type: string
                            description: Message category; empty on send.
                          Multicast:
                            type: boolean
                            description: Whether the message was multicast.
                          MediaType:
                            type: string
                            description: Media type label; empty for non-media.
                          Edit:
                            type: string
                            description: Edit attribute; empty for new messages.
                          MsgBotInfo:
                            type: object
                            description: Bot edit metadata (zero-valued on normal sends).
                            properties:
                              EditType:
                                type: string
                              EditTargetID:
                                type: string
                              EditSenderTimestampMS:
                                type: string
                                format: date-time
                          MsgMetaInfo:
                            type: object
                            description: >-
                              Meta targeting metadata (zero-valued on normal
                              sends).
                            properties:
                              TargetID:
                                type: string
                              TargetSender:
                                type: string
                              TargetChat:
                                type: string
                              DeprecatedLIDSession:
                                type:
                                  - boolean
                                  - 'null'
                              ThreadMessageID:
                                type: string
                              ThreadMessageSenderJID:
                                type: string
                          VerifiedName:
                            type:
                              - object
                              - 'null'
                            description: Business verified-name details; null when absent.
                          DeviceSentMeta:
                            type:
                              - object
                              - 'null'
                            description: Own-device send metadata; null when absent.
                      Message:
                        type: object
                        description: >-
                          Echo of the sent waE2E.Message proto (encoding/json,
                          proto lowerCamelCase tags). Only the sub-message for
                          this endpoint is populated.
                        properties:
                          documentWithCaptionMessage:
                            type: object
                            description: >-
                              List menus are delivered wrapped in a
                              FutureProofMessage.
                            properties:
                              message:
                                type: object
                                properties:
                                  listMessage:
                                    type: object
                                    properties:
                                      title:
                                        type: string
                                      description:
                                        type: string
                                      buttonText:
                                        type: string
                                      listType:
                                        type: integer
                                        description: List type enum; 1 = SINGLE_SELECT.
                                      footerText:
                                        type: string
                                      sections:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            title:
                                              type: string
                                            rows:
                                              type: array
                                              items:
                                                type: object
                                                properties:
                                                  title:
                                                    type: string
                                                  description:
                                                    type: string
                                                  rowID:
                                                    type: string
                      MessageContextInfo:
                        type: object
                        description: >-
                          Quoted-message context echoed back
                          (waE2E.ContextInfo). Empty strings when the send was
                          not a reply.
                        properties:
                          stanzaID:
                            type: string
                            description: Quoted message ID; empty when not replying.
                          participant:
                            type: string
                            description: >-
                              Quoted message author JID; empty when not
                              replying.
                          quotedMessage:
                            type: object
                            description: Placeholder quoted message.
                            properties:
                              conversation:
                                type: string
              example:
                message: success
                data:
                  Info:
                    Chat: 5511999999999@s.whatsapp.net
                    Sender: 5511888888888:23@s.whatsapp.net
                    IsFromMe: true
                    IsGroup: false
                    AddressingMode: ''
                    SenderAlt: ''
                    RecipientAlt: ''
                    BroadcastListOwner: ''
                    BroadcastRecipients: null
                    ID: 3EB0C767D26A1D8A3C2B
                    ServerID: 0
                    Type: ListMessage
                    PushName: ''
                    Timestamp: '2026-07-10T13:45:30Z'
                    Category: ''
                    Multicast: false
                    MediaType: ''
                    Edit: ''
                    MsgBotInfo:
                      EditType: ''
                      EditTargetID: ''
                      EditSenderTimestampMS: '0001-01-01T00:00:00Z'
                    MsgMetaInfo:
                      TargetID: ''
                      TargetSender: ''
                      TargetChat: ''
                      DeprecatedLIDSession: null
                      ThreadMessageID: ''
                      ThreadMessageSenderJID: ''
                    VerifiedName: null
                    DeviceSentMeta: null
                  Message:
                    documentWithCaptionMessage:
                      message:
                        listMessage:
                          title: Our services
                          description: Pick one of the options below
                          buttonText: Open menu
                          listType: 1
                          footerText: Pilot Status
                          sections:
                            - title: Support
                              rows:
                                - title: Talk to an agent
                                  description: Human support
                                  rowID: row-agent
                                - title: FAQ
                                  description: Common questions
                                  rowID: row-faq
                  MessageContextInfo:
                    stanzaID: ''
                    participant: ''
                    quotedMessage:
                      conversation: ''
        default:
          description: Erro — erro do provedor ou da camada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  error:
                    type: string
                  message:
                    type: string
                  response:
                    type: object
              example:
                status: 400
                error: Bad Request
                message: Invalid payload
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: >-
        Your Pilot Status API key (ps_...). Evolution GO also accepts
        `Authorization: Bearer <key>`.

````