> For the complete documentation index, see [llms.txt](https://docs.otima.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otima.io/whatsapp/recursos-de-api/mensagens.md).

# Mensagens

A API permite envio de mensagens dentro da janela de atendimento de 24 horas após a última interação do usuário.

Todas as requisições devem ser feitas utilizando autenticação Bearer Token.

### Envios <a href="#envios" id="envios"></a>

URL Base de envio de template:

```http
POST https://sync-core-api.otima.io/whatsapp/provider/{{NUMERO_AQUI}}/send-message
```

### Tipos de Mensagem: <a href="#tipos-de-mensagem" id="tipos-de-mensagem"></a>

#### Texto <a href="#texto" id="texto"></a>

Envio de mensagem simples em formato texto.

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "text",
  "text": {
    "body": "Olá, esta é uma mensagem de teste."
  }
}
```

#### Imagem <a href="#imagem" id="imagem"></a>

Envio de imagens

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "image",
  "image": {
    "link": "https://exemplo.com/imagem.jpg"
  }
}
```

#### Video <a href="#video" id="video"></a>

Envio de videos

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "video",
  "video": {
    "link": "https://exemplo.com/video.mp4"
  }
}
```

#### Documento <a href="#documento" id="documento"></a>

Envio de documentos

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "document",
  "document": {
    "link": "https://exemplo.com/arquivo.pdf"
  }
}
```

#### Audio <a href="#audio" id="audio"></a>

Envio de audios

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "audio",
  "audio": {
    "link": "https://exemplo.com/audio.ogg"
  }
}
```

#### Localização <a href="#localizacao" id="localizacao"></a>

Envio de localização geográfica.

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "location",
  "location": {
    "latitude": -23.550520,
    "longitude": -46.633308,
    "name": "São Paulo",
    "address": "Praça da Sé - São Paulo - SP"
  }
}
```

#### Sticker <a href="#sticker" id="sticker"></a>

Envio de sticker estático ou animado.

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "sticker",
  "sticker": {
    "link": "https://exemplo.com/sticker.webp"
  }
}
```

#### Contato <a href="#contato" id="contato"></a>

Envio de cartão de contato.

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "João Silva",
        "first_name": "João",
        "last_name": "Silva"
      },
      "phones": [
        {
          "phone": "5511999999999",
          "type": "CELL"
        }
      ]
    }
  ]
}
```

#### Mensagem Interativa - Botões <a href="#mensagem-interativa-botoes" id="mensagem-interativa-botoes"></a>

Envio de mensagem com botões de resposta rápida.

```json
{
  "messaging_product": "whatsapp",
  "to": "5511999999999",
  "type": "interactive",
  "interactive": {
    "type": "button",
    "body": {
      "text": "Escolha uma opção:"
    },
    "action": {
      "buttons": [
        {
          "type": "reply",
          "reply": {
            "id": "opcao_1",
            "title": "Opção 1"
          }
        },
        {
          "type": "reply",
          "reply": {
            "id": "opcao_2",
            "title": "Opção 2"
          }
        }
      ]
    }
  }
}
```

#### Resposta padrão de envio da mensagem: <a href="#resposta-padrao-de-envio-da-mensagem" id="resposta-padrao-de-envio-da-mensagem"></a>

```json
{
    "contacts": [
        {
            "input": "5511999999999",
            "wa_id": "5511999999999"
        }
    ],
    "messages": [
        {
            "id": "wamid.HBgfNTU0Mzk5MDU2MDQxgQIAERgSMzFCOTYyMTI1ctZCrDQ3RkY4AA==",
            "message_status": "accepted"
        }
    ],
    "message": "A mensagem foi enviada com sucesso!"
}
```
