🚀 Início Rápido - WhatsApp API SaaS

Guia rápido para começar a usar a aplicação.

📦 Instalação Local

1. Instalar Dependências

npm install

2. Configurar Variáveis de Ambiente

Copie o arquivo .env.example para .env:

cp .env.example .env

Edite o arquivo .env e configure:

PORT=3000
BASE_WEBHOOK_URL=http://localhost:3000/webhook
JWT_SECRET=gerar-chave-forte-aqui
ADMIN_API_KEY=gerar-chave-forte-aqui

Gerar chaves seguras:

# JWT_SECRET
openssl rand -base64 32

# ADMIN_API_KEY
openssl rand -base64 24

3. Iniciar Aplicação

npm start

A aplicação estará disponível em: http://localhost:3000

🌐 Deploy em VPS

Siga o guia completo em: Guia de Deploy VPS

Resumo rápido:

1. Conectar ao servidor VPS
2. Instalar Node.js, PM2, Nginx
3. Enviar código para servidor
4. Configurar variáveis de ambiente
5. Configurar Nginx e SSL
6. Iniciar com PM2

📱 Primeiro Uso

1. Acessar Dashboard

Abra no navegador: http://localhost:3000/dashboard.html

2. Criar Conta

• Clique em "Dashboard" ou acesse /login.html
• Clique em "Registrar"
• Preencha nome, email e senha
• Faça login

3. Criar Instância

• No dashboard, clique em "Nova Instância"
• Digite um nome (ex: "Minha Empresa")
• Opcional: configure webhook URL
• Clique em "Criar Instância"

4. Conectar WhatsApp

• Clique em "QR Code" no menu lateral
• Selecione sua instância
• Clique em "Carregar QR Code"
• Escaneie o QR code com seu WhatsApp
• Aguarde a confirmação de conexão

5. Enviar Primeira Mensagem

• Clique em "Testar Mensagem"
• Selecione sua instância
• Digite o número (formato: 5511999999999)
• Digite a mensagem
• Clique em "Enviar Mensagem"

🔑 Obter Token da Instância

1. No dashboard, vá para "Instâncias"
2. Encontre sua instância
3. Clique no botão de copiar ao lado do token
4. Use este token nas chamadas da API

📡 Usar API

Exemplo com cURL

# Enviar mensagem
curl -X POST https://seu-dominio.com/client/sendMessage/SEU_SESSION_ID \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SEU_TOKEN_AQUI" \
  -d '{
    "chatId": "5511999999999@c.us",
    "contentType": "string",
    "content": "Olá! Mensagem de teste"
  }'

Exemplo com Delphi

Veja a pasta demo/delphi/ para exemplos completos.

📚 Documentação Completa

• Deploy VPS: Guia de Deploy VPS
• Manual API Delphi: Manual de Integração Delphi
• Documentação API: Acesse /api-docs quando ENABLE_SWAGGER_ENDPOINT=TRUE

⚙️ Configurações Importantes

Desenvolvimento

• PORT=3000 - Porta local
• BASE_WEBHOOK_URL=http://localhost:3000/webhook

Produção

• Use HTTPS sempre
• Configure domínio válido
• Use chaves fortes e seguras
• Configure firewall
• Configure backups

🐛 Problemas Comuns

Porta já em uso

# Verificar o que está usando a porta
sudo lsof -i :3000

# Ou mudar a porta no .env
PORT=3001

Erro de Chromium

# Linux: Instalar Chromium
sudo apt install chromium-browser

# Adicionar ao .env
CHROME_BIN=/usr/bin/chromium-browser

Erro de permissões

# Dar permissões para sessões
chmod -R 755 sessions/

✅ Checklist

• Node.js instalado
• Dependências instaladas (npm install)
• Arquivo .env configurado
• Chaves geradas (JWT_SECRET, ADMIN_API_KEY)
• Aplicação iniciada (npm start)
• Dashboard acessível
• Conta criada
• Instância criada
• WhatsApp conectado
• Primeira mensagem enviada

🎉 Pronto!

Sua aplicação WhatsApp API SaaS está funcionando!

Para mais detalhes, consulte os outros arquivos de documentação.