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

# Enviar texto

> Envie uma mensagem de texto, com ou sem pré-visualização de link.

Envia uma mensagem de texto simples para um cliente com a [janela de 24 horas](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#janela-de-24-horas) aberta. URLs no texto viram links clicáveis automaticamente.

> [!NOTE]
>
> O destinatário pode ser informado pelo **número de telefone** (`to`) ou pelo **ID do usuário** (`recipient`). Se os dois forem enviados, vale o `to`; para enviar pelo ID do usuário, deixe o `to` em branco. Veja a diferença em [Destinatário](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#destinatário).

## Formatação

O texto aceita a formatação do WhatsApp:

| Formato | Como escrever | Resultado |
| - | - | - |
| Negrito | `*texto*` | **texto** |
| Itálico | `_texto_` | *texto* |
| Tachado | `~texto~` | ~~texto~~ |
| Monoespaçado | ` ```texto``` ` | `texto` |

Para quebrar linha, use `\n` dentro do texto.

## Responder citando uma mensagem

Informe o `wamid` da mensagem recebida em `context.message_id`. A resposta aparece vinculada à mensagem original na conversa:

```json theme={null}
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "text",
  "context": { "message_id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA=" },
  "text": { "body": "Seu pedido já saiu para entrega." }
}
```

Veja mais detalhes na [documentação de mensagens de texto da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/text-messages).


## OpenAPI

````yaml api-reference/whatsapp/specs/texto.json POST /v1/{phone_number_id}/messages
openapi: 3.1.0
info:
  title: Datafy API — Enviar texto
  version: 1.0.0
servers:
  - url: https://cloud.datafyapi.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /v1/{phone_number_id}/messages:
    post:
      summary: Enviar texto
      operationId: enviarTexto
      parameters:
        - name: phone_number_id
          in: path
          required: true
          schema:
            type: string
          description: ID do número que envia a mensagem. Descubra com `GET /me`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MensagemTexto'
            example:
              messaging_product: whatsapp
              recipient_type: individual
              to: '5511999999999'
              type: text
              text:
                preview_url: false
                body: Olá! Como podemos ajudar?
      responses:
        '200':
          description: Envio aceito pela Meta. Não confirma a entrega.
          content:
            application/json:
              example:
                messaging_product: whatsapp
                contacts:
                  - input: '5511999999999'
                    wa_id: '5511999999999'
                messages:
                  - id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA=
        '400':
          description: Erro retornado pela Meta.
          content:
            application/json:
              example:
                error:
                  message: The parameter to is required.
                  type: OAuthException
                  code: 100
                  fbtrace_id: AbCdEfGhIjK
        '401':
          description: Token ausente ou inválido.
          content:
            application/json:
              example:
                statusCode: 401
                message: Token inválido ou não encontrado.
components:
  schemas:
    MensagemTexto:
      type: object
      required:
        - messaging_product
        - to
        - type
        - text
      properties:
        messaging_product:
          type: string
          enum:
            - whatsapp
          description: Sempre `whatsapp`.
          default: whatsapp
          example: whatsapp
        recipient_type:
          type: string
          enum:
            - individual
          description: Sempre `individual`.
          default: individual
          example: individual
        to:
          type: string
          description: >-
            Número do destinatário com código do país e DDD, como
            `5511999999999`. Tem prioridade sobre `recipient`: para enviar pelo
            ID do usuário, deixe em branco.
          example: '5511999999999'
        recipient:
          type: string
          description: >-
            ID do usuário no WhatsApp (BSUID), recebido nos webhooks em
            `from_user_id` e `contacts[].user_id`, como
            `BR.13491208655302741918`. Usado quando `to` não é informado.
        type:
          type: string
          enum:
            - text
          description: Sempre `text`.
          default: text
          example: text
        text:
          $ref: '#/components/schemas/Texto'
        context:
          $ref: '#/components/schemas/Contexto'
    Texto:
      type: object
      required:
        - body
      description: Conteúdo da mensagem.
      properties:
        body:
          type: string
          maxLength: 4096
          description: Texto da mensagem, com até 4.096 caracteres.
          example: Olá! Como podemos ajudar?
        preview_url:
          type: boolean
          default: false
          description: >-
            Exibe a pré-visualização da primeira URL do texto. A URL precisa
            começar com `http://` ou `https://`.
          example: false
    Contexto:
      type: object
      description: Responde citando uma mensagem anterior da conversa.
      properties:
        message_id:
          type: string
          description: ID (`wamid`) da mensagem que será citada.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token gerado no painel da Datafy ao criar o canal. Formato:
        `sk_live_xxx`.

````

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