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

# Enviar Texto

> Envia uma mensagem de texto para um contato ou grupo

## Descrição

Envia uma mensagem de texto simples para um número de WhatsApp ou grupo. Suporta citação de mensagens anteriores, menção de contatos e simulação de digitação.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "phone": "5511999999999",
  "message": "Olá!",
  "messageId": "ID_PARA_REPLY",
  "delayMessage": 1000,
  "delayTyping": 2000,
  "mentioned": ["5511888888888"]
}
```

| Campo          | Tipo   | Obrigatório | Descrição                                                            |
| -------------- | ------ | ----------- | -------------------------------------------------------------------- |
| `phone`        | string | Sim         | Número do destinatário no formato DDI+DDD+número (ex: 5511999999999) |
| `message`      | string | Sim         | Texto da mensagem                                                    |
| `messageId`    | string | Não         | ID de uma mensagem anterior para citar/responder                     |
| `delayMessage` | number | Não         | Aguarda N milissegundos antes de enviar a mensagem                   |
| `delayTyping`  | number | Não         | Simula o status "digitando..." por N milissegundos antes de enviar   |
| `mentioned`    | array  | Não         | Lista de números de telefone para mencionar na mensagem              |

## Response

### Sucesso (202)

```json theme={null}
{
  "messageId": "3EB0C767D02DCC481523",
  "id": "3EB0C767D02DCC481523"
}
```

## Exemplo cURL

### Texto simples

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-text' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Olá! Como posso ajudar?"
  }'
```

### Texto com reply (citando mensagem anterior)

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-text' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999",
    "message": "Respondendo sua pergunta...",
    "messageId": "3EB0C767D02DCC481523"
  }'
```

### Mensagem para grupo com menção

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/send-text' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "5511999999999-1234567890@g.us",
    "message": "@5511888888888 você foi mencionado!",
    "mentioned": ["5511888888888"]
  }'
```

<Note>Para grupos, o campo `phone` deve conter o ID do grupo no formato `NÚMERO-TIMESTAMP@g.us`.</Note>