> ## 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.

# Send text message

> Sends a plain text message; when `linkPreview` is true the server enriches the first URL in `text` with an OpenGraph preview card.



## OpenAPI

````yaml openapi.evolution-go.json POST /send/text
openapi: 3.1.0
info:
  title: Evolution GO Layer
  version: 1.0.0
  description: >-
    Pilot Status API Layer — Evolution GO. Base URL
    `https://pilotstatus.com.br/api/layer/evolution-go`. Authenticate with the
    `apikey` header (your Pilot Status `ps_` key) or `Authorization: Bearer`.
    Instance/session endpoints are NOT available through the layer.
servers:
  - url: https://pilotstatus.com.br/api/layer/evolution-go
security:
  - apiKey: []
tags:
  - name: Call (voice)
  - name: Chat
  - name: Community
  - name: Group
  - name: Label
  - name: Message
  - name: Newsletter / Channels
  - name: Send (load-balanced)
  - name: User / Contacts
paths:
  /send/text:
    post:
      tags:
        - Send (load-balanced)
      summary: Send text message
      description: >-
        Sends a plain text message; when `linkPreview` is true the server
        enriches the first URL in `text` with an OpenGraph preview card.
      operationId: post__send_text
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                number:
                  type: string
                  description: >-
                    Recipient MSISDN or JID (e.g. `5511999999999` or
                    `5511999999999@s.whatsapp.net`, group `...@g.us`).
                  example: '5511999999999'
                text:
                  type: string
                  description: Message body.
                  example: Hello from Pilot Status! https://pilotstatus.com.br
                linkPreview:
                  type: boolean
                  description: >-
                    Fetch OpenGraph metadata for the first URL in `text` and
                    attach a preview.
                  example: true
                id:
                  type: string
                  description: Client-supplied message id for tracking/idempotency.
                delay:
                  type: integer
                  description: Milliseconds to wait (as "typing") before sending.
                  example: 1200
                mentionedJid:
                  type: string
                  description: JID(s) to mention.
                mentionAll:
                  type: boolean
                  description: Mention every participant (groups).
                formatJid:
                  type: boolean
                  description: >-
                    Auto-format `number` into a JID (default `true`); set
                    `false` to send the value as-is.
                quoted:
                  type: object
                  description: 'Reply-to reference: `{ "messageId", "participant" }`.'
                  example:
                    messageId: 3EB0C767D097B7C7A0A1
                    participant: 5511988888888@s.whatsapp.net
              required:
                - number
                - text
      responses:
        '200':
          description: Success — provider-native response body.
          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: >-
                      Text 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; "ExtendedTextMessage"
                              for text.
                          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:
                          extendedTextMessage:
                            type: object
                            properties:
                              text:
                                type: string
                                description: Message body.
                              contextInfo:
                                type: object
                                description: >-
                                  Message-level context info (mentions/quote);
                                  empty object when none.
                                properties: {}
                      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: ExtendedTextMessage
                    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:
                    extendedTextMessage:
                      text: Hello from Pilot Status!
                      contextInfo: {}
                  MessageContextInfo:
                    stanzaID: ''
                    participant: ''
                    quotedMessage:
                      conversation: ''
        default:
          description: Error — provider or layer error.
          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>`.

````