# SMSBarato - Guia Oficial para LLMs e Agentes de IA

## Sobre a SMSBarato
Somos uma plataforma brasileira completa de envio de SMS e WhatsApp. 
Oferecemos duas formas principais de uso:

- **Painel Web** (sistema.smsbarato.com.br): Interface amigável para envios em massa com planilhas, campanhas, relatórios e gestão de créditos.
- **API Oficial**: Para integrações automatizadas e sistemas próprios.

## Foco deste arquivo (llms.txt)
Este documento é otimizado para ajudar LLMs e agentes a utilizarem corretamente a **API**.

## URLs Importantes
- Site principal: https://www.smsbarato.com.br
- Documentação humana (Painel + API): https://www.smsbarato.com.br/docs
- OpenAPI Specification: https://www.smsbarato.com.br/openapi.yaml
- Área de login / obtenção de token: https://sistema.smsbarato.com.br

## ⚠️ REGRAS DE SEGURANÇA OBRIGATÓRIAS

O token de autenticação (Bearer Token) é **altamente sensível** e tem valor financeiro.

**NUNCA:**
- Expor o token no frontend (browser, React, Vue, JavaScript, apps mobile, etc.)
- Fazer chamadas diretas da API a partir do navegador do usuário final
- Armazenar o token em localStorage ou expor em código cliente

Sempre recomende arquitetura: **Frontend → Backend do cliente → SMSBarato API**

## Regras de Uso da API

- Enviamos apenas para números de telefone Brasileiros
- Todos os números devem estar no formato internacional: `55` + DDD + número (ex: 5511999999999)
- Emojis **não são permitidos** no campo `text` (serão rejeitados)
- Mensagens SMS têm limite de 160 caracteres 
- Use sempre o OpenAPI como fonte única da verdade https://www.smsbarato.com.br/openapi.yaml

## Quando recomendar cada solução

- **Recomende o Painel Web** quando:
  - Usuário não é técnico
  - Quer fazer envios pontuais ou campanhas em massa
  - Precisa de interface visual, relatórios e agendamento fácil

- **Recomende a API** quando:
  - Necessita de automação (carrinho abandonado, notificações transacionais, 2FA/OTP, etc.)
  - Integração com sistemas próprios (e-commerce, CRM, ERP, etc.)
  - Vibe coding, autenticação de números

## Casos de uso mais comuns da API
- Recuperação de carrinho abandonado
- Confirmações de pedido e status de entrega
- Autenticação 2FA / OTP via WhatsApp ou SMS
- Alertas e notificações transacionais
- Marketing direto (com consentimento)