Guia de configuração

Como preparar os dois canais de envio do VYRO.

1. Subir a Evolution API v2 numa VPS (API não oficial)

Você precisa de uma VPS (Ubuntu 22.04, 2 vCPU e 4 GB de RAM já atendem bem) com Docker instalado. Conecte-se por SSH e rode:

curl -fsSL https://get.docker.com | sh
mkdir -p /opt/evolution && cd /opt/evolution

Crie o arquivo docker-compose.yml:

services:
  evolution:
    image: atendai/evolution-api:v2.1.1
    restart: always
    ports:
      - "8080:8080"
    environment:
      - SERVER_URL=https://evolution.seudominio.com
      - AUTHENTICATION_API_KEY=troque-por-uma-chave-bem-longa
      - DATABASE_ENABLED=true
      - DATABASE_PROVIDER=postgresql
      - DATABASE_CONNECTION_URI=postgresql://postgres:senhaforte@postgres:5432/evolution
      - CACHE_REDIS_ENABLED=true
      - CACHE_REDIS_URI=redis://redis:6379/6
      - CONFIG_SESSION_PHONE_VERSION=2.3000.1023204200
    depends_on: [postgres, redis]

  postgres:
    image: postgres:15
    restart: always
    environment:
      - POSTGRES_PASSWORD=senhaforte
      - POSTGRES_DB=evolution
    volumes: ["pgdata:/var/lib/postgresql/data"]

  redis:
    image: redis:7
    restart: always

volumes:
  pgdata:

Suba os serviços:

docker compose up -d

Aponte um domínio para a VPS e coloque um proxy com HTTPS na frente (Nginx Proxy Manager, Caddy ou Traefik) — o WhatsApp exige HTTPS válido. Depois, em Configurações do VYRO, informe o endereço (https://evolution.seudominio.com) e a chave AUTHENTICATION_API_KEY, e clique em “Testar conexão”.

Pronto: em Instâncias você cria quantos números quiser e conecta cada um pelo QR Code. O webhook de status e respostas é configurado automaticamente.

2. Configurar a API oficial da Meta

  1. Crie uma conta no Meta for Developers e um app do tipo “Business”.
  2. Adicione o produto WhatsApp e vincule sua conta comercial (WABA).
  3. Copie o Phone Number ID e o WhatsApp Business Account ID.
  4. Gere um token permanente: crie um usuário do sistema em Business Settings, dê a ele as permissões whatsapp_business_messaging e whatsapp_business_management e gere o token sem expiração.
  5. Cadastre tudo em API Oficial no VYRO e clique em “Testar conexão”.
  6. Em Webhooks do app, cole a URL mostrada na página e o Verify Token da conta; assine o campo messages.
  7. Crie e aprove seus modelos (templates) no painel da Meta e use “Sincronizar modelos”.

No canal oficial só é possível iniciar conversas com modelos aprovados — por isso a campanha pede o modelo e o mapeamento das variáveis.

3. Boas práticas para não ser bloqueado

  • Aqueça números novos: comece com 20–50 envios por dia e aumente devagar.
  • Use intervalos aleatórios (20–60s) e pausas a cada 40–60 envios.
  • Envie apenas dentro da janela de horário comercial.
  • Use spintax para variar o texto e evitar mensagens idênticas.
  • Inclua sempre uma forma de sair: “responda SAIR para não receber mais”.
  • Fale só com quem autorizou o contato.