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

# Mensagens

> Visão geral dos endpoints de envio de mensagens via WhatsApp

## Descrição

Esta seção cobre todos os endpoints de envio de mensagens da Bliper API. Com eles é possível enviar textos, imagens, áudios, vídeos, documentos, localizações, contatos, stickers, GIFs, enquetes, botões interativos e muito mais.

## Comportamento padrão dos endpoints de envio

Todos os endpoints de envio retornam **HTTP 202 Accepted** com o seguinte corpo:

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

| Campo       | Descrição                   |
| ----------- | --------------------------- |
| `messageId` | ID da mensagem no WhatsApp  |
| `id`        | Mesmo valor que `messageId` |

## Campos opcionais comuns

A maioria dos endpoints de envio aceita os seguintes campos opcionais no body:

| Campo          | Tipo   | Descrição                                                          |
| -------------- | ------ | ------------------------------------------------------------------ |
| `delayMessage` | number | Aguarda N milissegundos antes de enviar a mensagem                 |
| `delayTyping`  | number | Simula o status "digitando..." por N milissegundos antes de enviar |
| `messageId`    | string | ID de uma mensagem anterior para citar/responder                   |

## Formato do número de telefone

O campo `phone` deve estar no formato **DDI + DDD + número**, sem espaços, traços ou o símbolo `+`.

```
5511999999999
```

* `55` = DDI do Brasil
* `11` = DDD de São Paulo
* `999999999` = número do celular

## Autenticação

Todos os endpoints exigem o header `Client-Token` com o seu token de cliente.

```
Client-Token: SEU_CLIENT_TOKEN
```

<Note>O `INSTANCE_ID` e o `INSTANCE_TOKEN` também fazem parte da URL de cada endpoint e identificam a instância WhatsApp que será utilizada.</Note>