Skip to content

Latest commit

 

History

History
233 lines (171 loc) · 4.15 KB

INSTRUÇÕES_USO.md

File metadata and controls

233 lines (171 loc) · 4.15 KB

🚀 Evolution API - Instalação Local Concluída!

✅ Status da Instalação

SUCESSO! A Evolution API foi instalada e está funcionando localmente no Docker.

Serviços Ativos:

  • ✅ Evolution API: http://localhost:8080
  • ✅ PostgreSQL: localhost:5432
  • ✅ Redis: localhost:6379

🌐 Acessos Importantes

1. API Base

http://localhost:8080

2. Manager (Interface Web)

http://localhost:8080/manager

3. Documentação Swagger

http://localhost:8080/docs

4. Documentação Oficial

https://doc.evolution-api.com

🔑 Configuração de Autenticação

IMPORTANTE: Antes de usar em produção, altere a API Key no arquivo .env:

# Arquivo: .env
AUTHENTICATION_API_KEY=SUA_API_KEY_AQUI_TROQUE_POR_UMA_SEGURA

Para gerar uma API Key segura:

openssl rand -hex 32

📱 Como Criar uma Instância do WhatsApp

1. Via API (Exemplo com curl):

curl -X POST "http://localhost:8080/instance/create" \
  -H "Content-Type: application/json" \
  -H "apikey: SUA_API_KEY_AQUI_TROQUE_POR_UMA_SEGURA" \
  -d '{
    "instanceName": "minha_instancia",
    "token": "meu_token_da_instancia",
    "qrcode": true,
    "integration": "WHATSAPP-BAILEYS"
  }'

2. Via Manager (Interface Web):

  1. Acesse: http://localhost:8080/manager
  2. Clique em "Criar Instância"
  3. Preencha os dados necessários
  4. Escaneie o QR Code com o WhatsApp

🔄 Comandos Úteis do Docker

Parar os Serviços:

docker-compose down

Iniciar os Serviços:

docker-compose up -d

Ver Status dos Containers:

docker-compose ps

Ver Logs da API:

docker-compose logs api -f

Reiniciar Apenas a API:

docker-compose restart api

🗃️ Banco de Dados

Credenciais do PostgreSQL:

  • Host: localhost
  • Port: 5432
  • Database: evolution_db
  • Username: user
  • Password: pass

Para acessar via terminal:

docker exec -it postgres psql -U user -d evolution_db

📁 Estrutura de Dados

Volumes Docker:

  • Instâncias: evolution_instances - Armazena dados das instâncias
  • Redis: evolution_redis - Cache do Redis
  • PostgreSQL: postgres_data - Dados do banco

Para backup dos dados:

# Backup do banco
docker exec postgres pg_dump -U user evolution_db > evolution_backup.sql

# Backup das instâncias
docker cp evolution_api:/evolution/instances ./instances_backup

🔧 Integrações Disponíveis

Para habilitar integrações, edite o arquivo .env:

Webhook:

WEBHOOK_GLOBAL_ENABLED=true
WEBHOOK_GLOBAL_URL=https://seu-webhook.com/webhook

Typebot:

TYPEBOT_ENABLED=true

Chatwoot:

CHATWOOT_ENABLED=true

OpenAI:

OPENAI_ENABLED=true
OPENAI_API_KEY_GLOBAL=sua_api_key_openai

🚨 Solução de Problemas

1. Se a API não iniciar:

# Ver logs detalhados
docker-compose logs api

# Reiniciar serviços
docker-compose restart

2. Se o banco não conectar:

# Verificar se o PostgreSQL está rodando
docker-compose ps postgres

# Reiniciar apenas o banco
docker-compose restart postgres

3. Se o Redis não conectar:

# Verificar Redis
docker-compose ps redis

# Testar conexão
docker exec redis redis-cli ping

4. Limpar tudo e recomeçar:

# CUIDADO: Isso vai apagar todos os dados!
docker-compose down -v
docker-compose up -d

📚 Recursos Adicionais

Postman Collection:

Comunidade:

Documentação Completa:

⚡ Próximos Passos

  1. Criar sua primeira instância via Manager ou API
  2. Escanear o QR Code para conectar o WhatsApp
  3. Testar envio de mensagens via API
  4. Configurar webhooks (se necessário)
  5. Explorar as integrações disponíveis

🎉 Sua Evolution API está pronta para uso!

Para suporte, consulte a documentação oficial ou acesse os canais da comunidade.