# Exemplos de Uso da API WhatsApp Bot

## 1. Enviar apenas mensagem de texto

### JSON (application/json)
```bash
curl -X POST http://localhost:3000/send-message \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer @@EQTL2025" \
  -d '{
    "grupo": "SQL QUERY",
    "mensagem": "🚨 *Desarme - OE 40118-7-2025 Uruaçu*\n🗣️ Afetação: *365* clientes\n\nInício: 16/07/2025 às 10:00:57\nPonto Operacional: 23 AN-GOIANESIA\nAlimentador: SE GOIANESIA - Alimentador 1\n👷 Equipes Atendendo: 2\n\n> *882042* – Em deslocamento\n> *URC001M* – Atribuída"
  }'
```

## 2. Enviar apenas imagem com legenda

### Form-Data (multipart/form-data)
```bash
curl -X POST http://localhost:3000/send-message \
  -H "Authorization: Bearer @@EQTL2025" \
  -F "grupo=SQL QUERY" \
  -F "legenda=📷 *Situação atual da rede*\nStatus: _Atendimento em andamento_" \
  -F "imagem=@caminho/para/sua/imagem.jpg"
```

## 🔧 **CORREÇÃO - Use este comando exato:**

```bash
curl --request POST \
  --url http://localhost:3000/send-message \
  --header 'Authorization: Bearer @@EQTL2025' \
  --header 'content-type: multipart/form-data' \
  --form 'grupo=SQL QUERY' \
  --form 'mensagem=🚨 *Desarme - OE 40118-7-2025 Uruaçu*\n🗣️ Afetação: *365* clientes\n\nInício: 16/07/2025 às 10:00:57\nPonto Operacional: 23 AN-GOIANESIA\nAlimentador: SE GOIANESIA - Alimentador 1\n👷 Equipes Atendendo: 2\n\n> *882042* – Em deslocamento\n> *URC001M* – Atribuída\n\n@5511999999999 favor verificar situação' \
  --form 'legenda=📸 *Foto da situação atual*\nStatus: _Em atendimento_\n@5562987654321 confira a imagem' \
  --form 'imagem=@C:\Users\U21055201\Downloads\Screenshot_1.png'
```

**✅ FUNCIONAMENTO CONFIRMADO:**
- ✅ Quebras de linha (`\n`) agora funcionam corretamente
- ✅ Formatação em negrito (`*texto*`) funciona
- ✅ Citações (`> texto`) funcionam  
- ✅ Upload de imagens funciona
- ✅ Legendas com formatação funcionam
- ✅ **NOVO:** Menções (`@5511999999999`) funcionam

## Formatações Suportadas

| Formatação | Sintaxe | Exemplo |
|------------|---------|---------|
| **Negrito** | `*texto*` | `*Urgente*` |
| _Itálico_ | `_texto_` | `_Em andamento_` |
| ~~Riscado~~ | `~texto~` | `~Cancelado~` |
| `Monoespaço` | ``` ```texto``` ``` | ``` ```Código``` ``` |
| Quebra de linha | `\n` | `Linha 1\nLinha 2` |
| **👥 Mencionar** | `@número` | `@5511999999999` |

## 👥 **NOVO: Funcionalidade de Menções**

### Formatos aceitos:
- `@5511999999999` - Número completo com código do país
- `@11999999999` - Número sem código (adiciona 55 automaticamente)
- `@+5511999999999` - Número com sinal +

### Como usar:
```bash
# Apenas mensagem com menção
curl -X POST http://localhost:3000/send-message \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer @@EQTL2025" \
  -d '{
    "grupo": "SQL QUERY",
    "mensagem": "🚨 *Emergência*\n\n@5511999999999 favor verificar urgente\n@5562987654321 acompanhar situação"
  }'

# Imagem com menção na legenda
curl --request POST \
  --url http://localhost:3000/send-message \
  --header 'Authorization: Bearer @@EQTL2025' \
  --form 'grupo=SQL QUERY' \
  --form 'legenda=📸 Situação atual\n@5511999999999 confira a foto' \
  --form 'imagem=@C:\Users\SEU_USUARIO\Downloads\foto.jpg'
```

### O que acontece:
- ✅ Pessoa mencionada recebe notificação
- ✅ Número aparece como link clicável no WhatsApp
- ✅ Funciona tanto em mensagens quanto em legendas
- ✅ Suporta múltiplas menções na mesma mensagem

## Exemplo Completo (JavaScript/Node.js)

```javascript
const FormData = require('form-data');
const fs = require('fs');
const fetch = require('node-fetch');

async function enviarMensagemComImagem() {
  const form = new FormData();
  
  // Dados da mensagem
  form.append('grupo', 'SQL QUERY');
  form.append('mensagem', `🚨 *Desarme - OE 40118-7-2025 Uruaçu*
🗣️ Afetação: *365* clientes

Início: 16/07/2025 às 10:00:57
Ponto Operacional: 23 AN-GOIANESIA
Alimentador: SE GOIANESIA - Alimentador 1
👷 Equipes Atendendo: 2

> *882042* – Em deslocamento
> *URC001M* – Atribuída`);
  
  // Imagem (se existir)
  if (fs.existsSync('./imagem.jpg')) {
    form.append('imagem', fs.createReadStream('./imagem.jpg'));
    form.append('legenda', '📸 *Situação atual*\n_Foto tirada no local_');
  }

  try {
    const response = await fetch('http://localhost:3000/send-message', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer @@EQTL2025'
      },
      body: form
    });

    const result = await response.json();
    console.log('Resultado:', result);
  } catch (error) {
    console.error('Erro:', error);
  }
}

enviarMensagemComImagem();
```

## Exemplo com Python

```python
import requests

# Apenas mensagem
def enviar_mensagem():
    url = "http://localhost:3000/send-message"
    headers = {
        "Authorization": "Bearer @@EQTL2025",
        "Content-Type": "application/json"
    }
    
    data = {
        "grupo": "SQL QUERY",
        "mensagem": """🚨 *Desarme - OE 40118-7-2025 Uruaçu*
🗣️ Afetação: *365* clientes

Início: 16/07/2025 às 10:00:57
Ponto Operacional: 23 AN-GOIANESIA
Alimentador: SE GOIANESIA - Alimentador 1
👷 Equipes Atendendo: 2

> *882042* – Em deslocamento
> *URC001M* – Atribuída"""
    }
    
    response = requests.post(url, json=data, headers=headers)
    print(response.json())

# Com imagem
def enviar_com_imagem():
    url = "http://localhost:3000/send-message"
    headers = {
        "Authorization": "Bearer @@EQTL2025"
    }
    
    files = {
        'imagem': ('foto.jpg', open('caminho/para/imagem.jpg', 'rb'), 'image/jpeg')
    }
    
    data = {
        'grupo': 'SQL QUERY',
        'legenda': '📸 *Situação atual*\n_Foto do local_'
    }
    
    response = requests.post(url, files=files, data=data, headers=headers)
    print(response.json())

enviar_mensagem()
```

## Tipos de Arquivo Suportados

- ✅ JPG/JPEG
- ✅ PNG
- ✅ GIF
- ✅ WEBP
- ❌ Outros formatos (PDF, DOC, etc.)

**Limite:** 10MB por imagem