> ## 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 cartões de carrossel

> Envia um carrossel de rolagem horizontal; cada cartão tem a própria imagem, texto e botões.



## OpenAPI

````yaml openapi.evolution-go.pt.json POST /send/carousel
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/carousel:
    post:
      tags:
        - Envio (balanceado)
      summary: Enviar cartões de carrossel
      description: >-
        Envia um carrossel de rolagem horizontal; cada cartão tem a própria
        imagem, texto e botões.
      operationId: post__send_carousel
      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: Featured products
                description:
                  type: string
                  description: Texto do corpo.
                  example: Swipe to browse
                footerText:
                  type: string
                  description: Texto do rodapé.
                  example: Pilot Status
                cards:
                  type: array
                  description: >-
                    Objetos de cartão: `{ text, thumbnailUrl, footerText,
                    buttons: [Button] }`.
                  items:
                    type: object
                  example:
                    - text: Product A
                      thumbnailUrl: https://example.com/a.jpg
                      footerText: In stock
                      buttons:
                        - type: url
                          displayText: Buy
                          url: https://shop.example.com/a
                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
                - footerText
                - cards
      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: >-
                      Carousel (cards) 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; "CarouselMessage" for
                              carousels.
                          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:
                          interactiveMessage:
                            type: object
                            properties:
                              header:
                                type: object
                                properties:
                                  title:
                                    type: string
                              body:
                                type: object
                                properties:
                                  text:
                                    type: string
                              footer:
                                type: object
                                properties:
                                  text:
                                    type: string
                              InteractiveMessage:
                                type: object
                                description: >-
                                  Protobuf oneof wrapper (no JSON tag →
                                  PascalCase key).
                                properties:
                                  CarouselMessage:
                                    type: object
                                    properties:
                                      cards:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            header:
                                              type: object
                                              description: Card media header.
                                              properties:
                                                hasMediaAttachment:
                                                  type: boolean
                                                Media:
                                                  type: object
                                                  description: >-
                                                    Protobuf oneof wrapper for the header
                                                    media.
                                                  properties:
                                                    ImageMessage:
                                                      type: object
                                                      properties:
                                                        URL:
                                                          type: string
                                                        directPath:
                                                          type: string
                                                        mediaKey:
                                                          type: string
                                                          contentEncoding: base64
                                                        mimetype:
                                                          type: string
                                                        fileEncSHA256:
                                                          type: string
                                                          contentEncoding: base64
                                                        fileSHA256:
                                                          type: string
                                                          contentEncoding: base64
                                                        fileLength:
                                                          type: integer
                                            body:
                                              type: object
                                              properties:
                                                text:
                                                  type: string
                                            footer:
                                              type: object
                                              properties:
                                                text:
                                                  type: string
                                            InteractiveMessage:
                                              type: object
                                              description: >-
                                                Protobuf oneof wrapper (no JSON tag →
                                                PascalCase key).
                                              properties:
                                                NativeFlowMessage:
                                                  type: object
                                                  properties:
                                                    buttons:
                                                      type: array
                                                      items:
                                                        type: object
                                                        properties:
                                                          name:
                                                            type: string
                                                            description: >-
                                                              Native flow button name, e.g.
                                                              quick_reply, cta_url, cta_copy,
                                                              cta_call, payment_info.
                                                          buttonParamsJSON:
                                                            type: string
                                                            description: JSON-encoded button parameters.
                      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: CarouselMessage
                    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:
                    interactiveMessage:
                      header:
                        title: Our products
                      body:
                        text: |-
                          Our products

                          Browse the cards below
                      footer:
                        text: Pilot Status
                      InteractiveMessage:
                        CarouselMessage:
                          cards:
                            - header:
                                hasMediaAttachment: true
                                Media:
                                  ImageMessage:
                                    URL: >-
                                      https://mmg.whatsapp.net/o1/v/t62.7118-24/f1/m231/up-oil-card1-aa11
                                    directPath: >-
                                      /o1/v/t62.7118-24/f1/m231/up-oil-card1-aa11
                                    mediaKey: >-
                                      Q2FyZDFtZWRpYWtleWV4YW1wbGV2YWx1ZWJhc2U2NAA=
                                    mimetype: image/jpeg
                                    fileEncSHA256: >-
                                      Y2FyZDFlbmNzaGEyNTZleGFtcGxlYmFzZTY0dmFsdWUA
                                    fileSHA256: >-
                                      Y2FyZDFwbGFpbnNoYTI1NmV4YW1wbGViYXNlNjR2YWwA
                                    fileLength: 18422
                              body:
                                text: Plan Starter
                              footer:
                                text: R$ 99/mo
                              InteractiveMessage:
                                NativeFlowMessage:
                                  buttons:
                                    - name: cta_url
                                      buttonParamsJSON: >-
                                        {"display_text":"Buy","url":"https://pilotstatus.com.br/starter","merchant_url":"https://pilotstatus.com.br/starter"}
                            - body:
                                text: Plan Pro
                              footer:
                                text: R$ 299/mo
                              InteractiveMessage:
                                NativeFlowMessage:
                                  buttons:
                                    - name: quick_reply
                                      buttonParamsJSON: >-
                                        {"display_text":"Talk to
                                        sales","id":"card-pro-sales"}
                  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>`.

````