# Exemplos de Uso - Uazapi MCP Server
Este arquivo contém exemplos práticos de como usar as ferramentas do MCP server Uazapi.
## Configuração Inicial
Antes de usar, configure suas credenciais:
```bash
export UAZAPI_API_KEY="sua_chave_aqui"
export UAZAPI_INSTANCE_ID="seu_instance_id_aqui"
```
## Exemplos de Prompts
### Enviar Mensagem de Texto
```
Envie a mensagem "Olá! Como posso ajudar você hoje?" para o número +55 11 99999-9999
```
```
Mande um SMS para 5511988887777 dizendo: "Seu pedido foi aprovado!"
```
### Enviar Imagem com Legenda
```
Envie a imagem https://example.com/produto.jpg para +5511999999999 com a legenda "Confira nosso novo produto!"
```
```
Compartilhe a foto em https://site.com/foto.png com o cliente 5511988887777
```
### Enviar Documento
```
Envie o PDF https://example.com/relatorio.pdf para 5511999999999 com o nome "Relatório Mensal"
```
### Listar Contatos
```
Mostre meus 30 primeiros contatos do WhatsApp
```
```
Liste todos os contatos salvos em formato JSON
```
```
Quero ver os contatos a partir do número 20, limite de 50
```
### Listar Conversas
```
Mostre minhas conversas recentes do WhatsApp
```
```
Liste as últimas 40 conversas em formato JSON
```
```
Quais são meus chats mais recentes com mensagens não lidas?
```
## Exemplos de Workflows Complexos
### 1. Campanha de Marketing
```
Eu tenho uma lista de clientes e quero enviar uma mensagem promocional para cada um.
Primeiro, me mostre meus contatos. Depois vou te passar os números específicos para enviar.
```
Depois de ver os contatos:
```
Envie a seguinte mensagem para os números 5511999999999, 5511888888888, 5511777777777:
"🎉 Promoção Especial!
Ganhe 20% de desconto em todos os produtos até sexta-feira.
Use o cupom: PROMO20"
```
### 2. Envio de Comprovante
```
Envie o comprovante de pagamento https://sistema.com/comprovantes/12345.pdf
para o cliente no número 5511999999999 com a mensagem "Segue comprovante do seu pagamento"
```
### 3. Atendimento ao Cliente
```
1. Primeiro, me mostre as conversas recentes com mensagens não lidas
2. Depois me ajude a responder cada uma delas
```
### 4. Envio de Mídia em Lote
```
Preciso enviar a mesma imagem promocional https://cdn.loja.com/promo.jpg
para 5 clientes diferentes. Os números são:
- 5511999999999
- 5511888888888
- 5511777777777
- 5511666666666
- 5511555555555
Use a legenda: "Confira nossa promoção de aniversário! 🎂"
```
## Casos de Uso por Setor
### E-commerce
**Notificação de Pedido Aprovado:**
```
Envie para 5511999999999: "Seu pedido #12345 foi aprovado e está sendo preparado para envio! 📦"
```
**Código de Rastreamento:**
```
Mande para o cliente 5511888888888: "Seu pedido foi enviado! Código de rastreamento: BR123456789. Acompanhe em: https://rastreio.com"
```
### Serviços
**Lembrete de Consulta:**
```
Envie para 5511999999999: "Olá! Lembrete: você tem consulta agendada amanhã às 14h. Confirme sua presença respondendo SIM."
```
**Confirmação de Agendamento:**
```
Notifique 5511888888888: "Seu agendamento foi confirmado! Data: 15/11/2024 às 10h. Local: Rua Exemplo, 123."
```
### Financeiro
**Cobrança:**
```
Envie para 5511999999999: "Olá! A fatura de R$ 150,00 vence amanhã (10/11). Pague pelo link: https://pag.com/fatura123"
```
**Confirmação de Pagamento:**
```
Mande para 5511888888888 o comprovante https://sistema.com/comprovante.pdf com a mensagem "Pagamento recebido! Obrigado."
```
### Educação
**Envio de Material:**
```
Compartilhe a apostila https://escola.com/materiais/apostila-mat.pdf com o aluno 5511999999999
e adicione: "Material da aula de hoje. Bons estudos! 📚"
```
**Lembrete de Prova:**
```
Avise os alunos nos números 5511999999999, 5511888888888:
"Lembrete: Prova de Matemática na sexta-feira. Revise os capítulos 5 a 8!"
```
## Tratamento de Erros
### Número Inválido
```
Envie "Olá" para 123
# Erro esperado: "Phone number too short (must be at least 10 digits with country code)"
```
### URL Inválida
```
Envie a imagem em ftp://site.com/foto.jpg para 5511999999999
# Erro esperado: "Media URL must start with http:// or https://"
```
### Autenticação Incorreta
```
# Com credenciais inválidas ou não configuradas
Mostre meus contatos
# Erro esperado: "Error: Authentication not configured. Please set UAZAPI_API_KEY..."
```
## Dicas de Uso
### 1. Formatação de Números
O servidor aceita vários formatos e normaliza automaticamente:
- ✅ `5511999999999`
- ✅ `+55 11 99999-9999`
- ✅ `+55 (11) 99999-9999`
- ✅ `55 11 9 9999-9999`
### 2. URLs de Mídia
- Devem ser públicas (acessíveis sem autenticação)
- Devem usar HTTPS
- Formatos suportados variam por tipo (jpg, png, mp4, pdf, etc.)
### 3. Paginação
Para listas grandes, use paginação:
```
# Primeira página
Mostre 20 contatos
# Segunda página
Mostre 20 contatos a partir do offset 20
# Terceira página
Mostre 20 contatos a partir do offset 40
```
### 4. Escolher Formato de Resposta
```
# Formato Markdown (padrão, melhor para leitura)
Liste meus contatos
# Formato JSON (melhor para processamento)
Liste meus contatos em formato JSON
```
## Expansão Futura
Quando novos endpoints forem adicionados, você poderá:
### Grupos
```
Crie um grupo chamado "Equipe Marketing" com os membros 5511999999999, 5511888888888
```
```
Adicione o número 5511777777777 ao grupo "Equipe Marketing"
```
```
Envie "Reunião amanhã às 10h" para o grupo "Equipe Marketing"
```
### Status
```
Atualize meu status do WhatsApp para "Disponível para atendimento"
```
### Mensagens Avançadas
```
Envie minha localização atual para 5511999999999
```
```
Compartilhe o contato de João Silva (5511888888888) com 5511999999999
```
---
**Nota**: Este MCP server está em desenvolvimento ativo. Mais ferramentas serão adicionadas conforme a documentação da API Uazapi for implementada.