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

# Visão Geral

> Envie diferentes tipos de mensagens via WhatsApp

# Mensagens

A API suporta diversos tipos de mensagens do WhatsApp, desde texto simples até
mensagens interativas com botões e listas.

## Tipos de Mensagem

<CardGroup cols={3}>
  <Card title="Texto" icon="type" href="/api-reference/messages/send-text">
    Mensagens de texto simples com suporte a menções e formatação.
  </Card>

  <Card title="Imagem" icon="image" href="/api-reference/messages/send-image">
    Fotos e imagens com legenda opcional.
  </Card>

  <Card title="Vídeo" icon="video" href="/api-reference/messages/send-video">
    Vídeos com legenda e opção de GIF.
  </Card>

  <Card title="Áudio" icon="mic" href="/api-reference/messages/send-audio">
    Áudios e mensagens de voz (PTT).
  </Card>

  <Card title="Documento" icon="file" href="/api-reference/messages/send-document">
    PDFs, planilhas e outros arquivos.
  </Card>

  <Card title="Sticker" icon="sticky-note" href="/api-reference/messages/send-sticker">
    Figurinhas/adesivos.
  </Card>

  <Card title="Localização" icon="map-pin" href="/api-reference/messages/send-location">
    Compartilhar localização no mapa.
  </Card>

  <Card title="Contato (vCard)" icon="id-card" href="/api-reference/messages/send-vcard">
    Envie um contato no formato vCard.
  </Card>

  <Card title="Reação" icon="smile" href="/api-reference/messages/send-reaction">
    Reagir a mensagens com emoji.
  </Card>
</CardGroup>

## Formato do Destinatário

O campo `to` aceita os seguintes formatos:

| Tipo   | Formato                                             | Exemplo                        |
| ------ | --------------------------------------------------- | ------------------------------ |
| Número | DDI + DDD + Número                                  | `5511999999999`                |
| JID    | nú[mero@s.whatsapp.net](mailto:mero@s.whatsapp.net) | `5511999999999@s.whatsapp.net` |
| Grupo  | [id@g.us](mailto:id@g.us)                           | `120363123456789012@g.us`      |

<Note>
  Sempre use o número completo com código do país. Para o Brasil, use `55`
  seguido do DDD e número.
</Note>

## Campos Comuns

Todos os endpoints de mensagem aceitam estes campos opcionais:

<ParamField body="sessionId" type="string" required>
  ID da sessão que enviará a mensagem.
</ParamField>

<ParamField body="to" type="string" required>
  Destinatário (número ou JID).
</ParamField>

<ParamField body="quoted" type="object">
  Responder a uma mensagem específica.

  ```json theme={"system"}
  {
    "messageId": "3EB0ABC123...",
    "participant": "5511888888888@s.whatsapp.net"
  }
  ```
</ParamField>

<ParamField body="mentions" type="string[]">
  Array de JIDs para mencionar (@) na mensagem.
</ParamField>

<ParamField body="viewOnce" type="boolean" default="false">
  Mensagem que desaparece após ser vista.
</ParamField>

## Resposta Padrão

Todos os endpoints de envio retornam:

```json theme={"system"}
{
  "messageId": "3EB0ABC123DEF456789...",
  "status": "sent",
  "to": "5511999999999@s.whatsapp.net",
  "timestamp": "2024-01-15T10:30:00.000Z"
}
```

## Limites de Mídia

| Tipo      | Tamanho Máximo |
| --------- | -------------- |
| Imagem    | 16 MB          |
| Vídeo     | 64 MB          |
| Áudio     | 16 MB          |
| Documento | 100 MB         |
| Sticker   | 500 KB         |

<Warning>
  Arquivos maiores que os limites serão rejeitados com erro `MEDIA_TOO_LARGE`.
</Warning>