# Enviar mensagem de texto

`POST /send/text`

Pasta: **Enviar Mensagem**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Enviar mensagem de texto

Envia uma mensagem de texto simples para um contato, grupo ou canal (`@newsletter`). Use quando só precisa de texto — sem mídia nem botões.

## Endpoint

```http
POST {{baseUrl}}/send/text
```

## Autenticação

Envie o token da instância no header:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| number | string | Sim* | Destinatário: telefone (ex. 5511999999999), JID `@s.whatsapp.net`, grupo `@g.us` ou canal `@newsletter` |
| chatid | string | Sim* | Alternativa a number (mesmo significado) |
| text | string | Sim | Conteúdo da mensagem |
| spoiler | bool | Não | Envolve a mensagem em spoiler |
| ai | bool | Não | Marca como mensagem AI (ícone; só DM no modo web) |
| secure_meta_service_label | bool | Não | Força label de qualidade Meta (web) |
| group_status | bool | Não | Envia como status de grupo (prefira /send/group-status) |
| channel_status | bool | Não | Envia como status de canal (prefira /send/channel-status) |
| is_lottie | bool | Não | Não se aplica a texto puro; ignorado na prática |
| external_ad_reply | object | Não | Preview estilo anúncio/CTWA no ContextInfo |
| external_ad_reply.title | string | Não | Título do card |
| external_ad_reply.body | string | Não | Subtítulo/descrição |
| external_ad_reply.source_url | string | Não | Link ao tocar |
| external_ad_reply.media_url | string | Não | URL da mídia do ad (fallback: source_url) |
| external_ad_reply.media_type | int | Não | 1=imagem (padrão), 2=vídeo |
| external_ad_reply.thumbnail_url | string | Não | URL da miniatura |
| external_ad_reply.thumbnail_base64 | string | Não | Miniatura em base64 ou data URI |
| external_ad_reply.render_larger_thumbnail | bool | Não | Exibe thumbnail grande |
| external_ad_reply.show_ad_attribution | bool | Não | Mostra badge de anúncio |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/send/text" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{"number": "{{remoteJid}}", "text": "Olá! Tudo bem?", "spoiler": false, "ai": false, "secure_meta_service_label": false}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": {
    "id": "3EB0A1B2C3D4E5F6",
    "timestamp": "2026-07-17T12:34:56Z",
    "sender": "5511888888888@s.whatsapp.net"
  }
}
```

## Erros comuns

- `text is required` — campo text vazio
- `missing token` / 401 — header token ausente ou inválido
- Instância desconectada — conecte antes de enviar
- Número inválido / não existe no WhatsApp

## Observações

- Informe `number` ou `chatid` (pelo menos um).
- Para canal, use o JID completo: `120363...@newsletter`.
- Resposta padrão: `{ success, message: { id, timestamp, sender } }`.

## Corpo (exemplo)

```json
{
  "number": "{{remoteJid}}",
  "text": "Olá! Tudo bem?",
  "spoiler": false,
  "ai": false,
  "secure_meta_service_label": false
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/send/text" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "{{remoteJid}}",
  "text": "Olá! Tudo bem?",
  "spoiler": false,
  "ai": false,
  "secure_meta_service_label": false
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=enviar-mensagem/enviar-mensagem-de-texto)