evolution-api [BUG] QR Code não aparece

📋 Bug Description

Pela manhã, realizei um teste de envio de imagem, mas o sistema não estava retornando o mediaURL. Para tentar corrigir, desconectei a instância; no entanto, ao reconectá-la, o QRCode deixou de ser exibido.

Tentei limpar todo o ambiente e realizar uma nova instalação, mas identifiquei nos logs que o processo entra em loop contínuo. Também alterei o parâmetro CONFIG_SESSION_PHONE_VERSION, ajustando-o de acordo com a versão do meu WhatsApp Web, porém o problema persiste.

🔄 Steps to Reproduce

1 - Conectar uma nova instancia

✅ Expected Behavior

Aparecer o QR Code

❌ Actual Behavior

🌍 Environment

OS: Ubuntu 24.04
Evolution API version: 2.3.6
Database: PostgreSQL 14
Connection type: Baileys
Usando K8S

📋 Logs

[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:25     INFO   [ChannelStartupService]  [string]  Redis enabled
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:25     INFO   [ChannelStartupService]  [string]  Browser: Evolution API,Chrome,6.8.0-78-generic
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:26     INFO   [ChannelStartupService]  [string]  Baileys version: 2.3000.1027934701
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:26     INFO   [ChannelStartupService]  [string]  Group Ignore: false
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:26     INFO   [ChannelStartupService]  [string]  Redis enabled
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:26     INFO   [ChannelStartupService]  [string]  Browser: Evolution API,Chrome,6.8.0-78-generic
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:26     INFO   [ChannelStartupService]  [string]  Baileys version: 2.3000.1027934701
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:26     INFO   [ChannelStartupService]  [string]  Group Ignore: false
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:27     INFO   [ChannelStartupService]  [string]  Redis enabled
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:27     INFO   [ChannelStartupService]  [string]  Browser: Evolution API,Chrome,6.8.0-78-generic
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:27     INFO   [ChannelStartupService]  [string]  Baileys version: 2.3000.1027934701
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:27     INFO   [ChannelStartupService]  [string]  Group Ignore: false
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:27     INFO   [ChannelStartupService]  [string]  Redis enabled
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:27     INFO   [ChannelStartupService]  [string]  Browser: Evolution API,Chrome,6.8.0-78-generic
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:27     INFO   [ChannelStartupService]  [string]  Baileys version: 2.3000.1027934701
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:27     INFO   [ChannelStartupService]  [string]  Group Ignore: false
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:28     INFO   [ChannelStartupService]  [string]  Redis enabled
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:28     INFO   [ChannelStartupService]  [string]  Browser: Evolution API,Chrome,6.8.0-78-generic
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:28     INFO   [ChannelStartupService]  [string]  Baileys version: 2.3000.1027934701
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:28     INFO   [ChannelStartupService]  [string]  Group Ignore: false
[Evolution API]  [Teste]  v2.3.6  428   -  Thu Nov 13 2025 12:26:28     INFO   [ChannelStartupService]  [string]  Redis enabled

📝 Additional Context

No response

Nov 13 '25 15:11 Alfr3d022

https://www.youtube.com/watch?v=Sc9cFEr8_bY

Assista, mude e resolva!

Nov 13 '25 17:11 rcarnavalli

Estou com o mesmo problema, setup com Dokploy e Cloudflare proxy. O erro também acontece quando desabilito o Cloudflare completamente

docker-compose.yml

services:
  evolution-api:
    image: atendai/evolution-api:latest
    restart: always
    volumes:
      - evolution-instances:/evolution/instances

    environment:
      - SERVER_URL=${SERVER_URL}
      - AUTHENTICATION_TYPE=${AUTHENTICATION_TYPE}
      - AUTHENTICATION_API_KEY=${AUTHENTICATION_API_KEY}
      - AUTHENTICATION_EXPOSE_IN_FETCH_INSTANCES=${AUTHENTICATION_EXPOSE_IN_FETCH_INSTANCES}
      - LANGUAGE=${LANGUAGE}
      - CONFIG_SESSION_PHONE_CLIENT=${CONFIG_SESSION_PHONE_CLIENT}
      - CONFIG_SESSION_PHONE_NAME=${CONFIG_SESSION_PHONE_NAME}
      - TELEMETRY=${TELEMETRY}
      - TELEMETRY_URL=${TELEMETRY_URL}
      - DATABASE_ENABLED=${DATABASE_ENABLED}
      - DATABASE_PROVIDER=${DATABASE_PROVIDER}
      - DATABASE_CONNECTION_URI=${DATABASE_CONNECTION_URI}
      - DATABASE_SAVE_DATA_INSTANCE=${DATABASE_SAVE_DATA_INSTANCE}
      - DATABASE_SAVE_DATA_NEW_MESSAGE=${DATABASE_SAVE_DATA_NEW_MESSAGE}
      - DATABASE_SAVE_MESSAGE_UPDATE=${DATABASE_SAVE_MESSAGE_UPDATE}
      - DATABASE_SAVE_DATA_CONTACTS=${DATABASE_SAVE_DATA_CONTACTS}
      - DATABASE_SAVE_DATA_CHATS=${DATABASE_SAVE_DATA_CHATS}
      - DATABASE_SAVE_DATA_LABELS=${DATABASE_SAVE_DATA_LABELS}
      - DATABASE_SAVE_DATA_HISTORIC=${DATABASE_SAVE_DATA_HISTORIC}
      - CACHE_REDIS_ENABLED=${CACHE_REDIS_ENABLED}
      - CACHE_REDIS_URI=${CACHE_REDIS_URI}
      - CACHE_REDIS_PREFIX_KEY=${CACHE_REDIS_PREFIX_KEY}
      - CACHE_REDIS_SAVE_INSTANCES=${CACHE_REDIS_SAVE_INSTANCES}
      - CONFIG_SESSION_PHONE_VERSION=2.3000.1023204200

    depends_on:
      - evolution-postgres
      - evolution-redis
    dns:
      - 8.8.8.8
      - 8.8.4.4
    sysctls:
      net.ipv6.conf.all.disable_ipv6: 1
      net.ipv6.conf.default.disable_ipv6: 1

  evolution-postgres:
    image: postgres:16-alpine
    restart: always
    volumes:
      - evolution-postgres-data:/var/lib/postgresql/data

    environment:
      - POSTGRES_DB=${POSTGRES_DATABASE}
      - POSTGRES_USER=${POSTGRES_USERNAME}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}

  evolution-redis:
    image: redis:alpine
    restart: always
    volumes:
      - evolution-redis-data:/data


networks:
  dokploy-network:
    external: true


volumes:
  evolution-instances:
  evolution-postgres-data:
  evolution-redis-data:

Nov 13 '25 22:11 Gabrielribeiroic

Boa madrugada, espero vir contribuir com esse comentario aqui, eu andei procurando alguma solução aqui mesmo na aba de issues e achei algo que funcionou comigo, atualmente eu estou utilizando a imagem mais recente no docker da evolution 'evoapicloud/evolution-api:v2.3.6', e uma das soluções propostas foi alterar o servidor dns do seu servidor, caso esteja utilizando, no meu caso eu utilizo a hostinger, eu alterei o servidor dns para 4.4.8.8 8.8.8.8 e voltou a funcionar, porém vou disponibilizar a minha .env também caso precisem, e outra se estiver com problema com uns toasts vermelhos aparecendo na tela, deslogue da dashboard e logue novamente ( manager do evolution ) e isso vai resolver esse problema.

SERVER_TYPE=http SERVER_PORT=8080 SERVER_URL={seu servidor aqui}

SENTRY_DSN=

CORS_ORIGIN=* CORS_METHODS=GET,POST,PUT,DELETE CORS_CREDENTIALS=true

LOG_LEVEL=ERROR,WARN,DEBUG,INFO,LOG,VERBOSE,DARK,WEBHOOKS,WEBSOCKET LOG_COLOR=true LOG_BAILEYS=error

EVENT_EMITTER_MAX_LISTENERS=50

DEL_INSTANCE=false

DATABASE_PROVIDER=postgresql DATABASE_CONNECTION_URI={seu banco aqui} DATABASE_CONNECTION_CLIENT_NAME=evolution_exchange DATABASE_SAVE_DATA_INSTANCE=true DATABASE_SAVE_DATA_NEW_MESSAGE=true DATABASE_SAVE_MESSAGE_UPDATE=true DATABASE_SAVE_DATA_CONTACTS=true DATABASE_SAVE_DATA_CHATS=true DATABASE_SAVE_DATA_LABELS=true DATABASE_SAVE_DATA_HISTORIC=true DATABASE_SAVE_IS_ON_WHATSAPP=true DATABASE_SAVE_IS_ON_WHATSAPP_DAYS=7 DATABASE_DELETE_MESSAGE=true

RABBITMQ_ENABLED=false RABBITMQ_URI=amqp://localhost RABBITMQ_EXCHANGE_NAME=evolution RABBITMQ_GLOBAL_ENABLED=false RABBITMQ_EVENTS_APPLICATION_STARTUP=false RABBITMQ_EVENTS_INSTANCE_CREATE=false RABBITMQ_EVENTS_INSTANCE_DELETE=false RABBITMQ_EVENTS_QRCODE_UPDATED=false RABBITMQ_EVENTS_MESSAGES_SET=false RABBITMQ_EVENTS_MESSAGES_UPSERT=false RABBITMQ_EVENTS_MESSAGES_EDITED=false RABBITMQ_EVENTS_MESSAGES_UPDATE=false RABBITMQ_EVENTS_MESSAGES_DELETE=false RABBITMQ_EVENTS_SEND_MESSAGE=false RABBITMQ_EVENTS_CONTACTS_SET=false RABBITMQ_EVENTS_CONTACTS_UPSERT=false RABBITMQ_EVENTS_CONTACTS_UPDATE=false RABBITMQ_EVENTS_PRESENCE_UPDATE=false RABBITMQ_EVENTS_CHATS_SET=false RABBITMQ_EVENTS_CHATS_UPSERT=false RABBITMQ_EVENTS_CHATS_UPDATE=false RABBITMQ_EVENTS_CHATS_DELETE=false RABBITMQ_EVENTS_GROUPS_UPSERT=false RABBITMQ_EVENTS_GROUP_UPDATE=false RABBITMQ_EVENTS_GROUP_PARTICIPANTS_UPDATE=false RABBITMQ_EVENTS_CONNECTION_UPDATE=false RABBITMQ_EVENTS_REMOVE_INSTANCE=false RABBITMQ_EVENTS_LOGOUT_INSTANCE=false RABBITMQ_EVENTS_CALL=false RABBITMQ_EVENTS_TYPEBOT_START=false RABBITMQ_EVENTS_TYPEBOT_CHANGE_STATUS=false

SQS_ENABLED=false SQS_ACCESS_KEY_ID= SQS_SECRET_ACCESS_KEY= SQS_ACCOUNT_ID= SQS_REGION=

WEBSOCKET_ENABLED=false WEBSOCKET_GLOBAL_EVENTS=false

PUSHER_ENABLED=false PUSHER_GLOBAL_ENABLED=false PUSHER_GLOBAL_APP_ID= PUSHER_GLOBAL_KEY= PUSHER_GLOBAL_SECRET= PUSHER_GLOBAL_CLUSTER= PUSHER_GLOBAL_USE_TLS=true PUSHER_EVENTS_APPLICATION_STARTUP=true PUSHER_EVENTS_QRCODE_UPDATED=true PUSHER_EVENTS_MESSAGES_SET=true PUSHER_EVENTS_MESSAGES_UPSERT=true PUSHER_EVENTS_MESSAGES_EDITED=true PUSHER_EVENTS_MESSAGES_UPDATE=true PUSHER_EVENTS_MESSAGES_DELETE=true PUSHER_EVENTS_SEND_MESSAGE=true PUSHER_EVENTS_CONTACTS_SET=true PUSHER_EVENTS_CONTACTS_UPSERT=true PUSHER_EVENTS_CONTACTS_UPDATE=true PUSHER_EVENTS_PRESENCE_UPDATE=true PUSHER_EVENTS_CHATS_SET=true PUSHER_EVENTS_CHATS_UPSERT=true PUSHER_EVENTS_CHATS_UPDATE=true PUSHER_EVENTS_CHATS_DELETE=true PUSHER_EVENTS_GROUPS_UPSERT=true PUSHER_EVENTS_GROUPS_UPDATE=true PUSHER_EVENTS_GROUP_PARTICIPANTS_UPDATE=true PUSHER_EVENTS_CONNECTION_UPDATE=true PUSHER_EVENTS_LABELS_EDIT=true PUSHER_EVENTS_LABELS_ASSOCIATION=true PUSHER_EVENTS_CALL=true PUSHER_EVENTS_TYPEBOT_START=false PUSHER_EVENTS_TYPEBOT_CHANGE_STATUS=false

WA_BUSINESS_TOKEN_WEBHOOK=evolution WA_BUSINESS_URL=https://graph.facebook.com WA_BUSINESS_VERSION=v20.0 WA_BUSINESS_LANGUAGE=en_US

WEBHOOK_GLOBAL_ENABLED=false WEBHOOK_GLOBAL_URL= WEBHOOK_GLOBAL_WEBHOOK_BY_EVENTS=false WEBHOOK_EVENTS_APPLICATION_STARTUP=false WEBHOOK_EVENTS_QRCODE_UPDATED=true WEBHOOK_EVENTS_MESSAGES_SET=true WEBHOOK_EVENTS_MESSAGES_UPSERT=true WEBHOOK_EVENTS_MESSAGES_EDITED=true WEBHOOK_EVENTS_MESSAGES_UPDATE=true WEBHOOK_EVENTS_MESSAGES_DELETE=true WEBHOOK_EVENTS_SEND_MESSAGE=true WEBHOOK_EVENTS_CONTACTS_SET=true WEBHOOK_EVENTS_CONTACTS_UPSERT=true WEBHOOK_EVENTS_CONTACTS_UPDATE=true WEBHOOK_EVENTS_PRESENCE_UPDATE=true WEBHOOK_EVENTS_CHATS_SET=true WEBHOOK_EVENTS_CHATS_UPSERT=true WEBHOOK_EVENTS_CHATS_UPDATE=true WEBHOOK_EVENTS_CHATS_DELETE=true WEBHOOK_EVENTS_GROUPS_UPSERT=true WEBHOOK_EVENTS_GROUPS_UPDATE=true WEBHOOK_EVENTS_GROUP_PARTICIPANTS_UPDATE=true WEBHOOK_EVENTS_CONNECTION_UPDATE=true WEBHOOK_EVENTS_REMOVE_INSTANCE=false WEBHOOK_EVENTS_LOGOUT_INSTANCE=false WEBHOOK_EVENTS_LABELS_EDIT=true WEBHOOK_EVENTS_LABELS_ASSOCIATION=true WEBHOOK_EVENTS_CALL=true WEBHOOK_EVENTS_TYPEBOT_START=false WEBHOOK_EVENTS_TYPEBOT_CHANGE_STATUS=false WEBHOOK_EVENTS_ERRORS=false WEBHOOK_EVENTS_ERRORS_WEBHOOK=

CONFIG_SESSION_PHONE_CLIENT=Evolution API CONFIG_SESSION_PHONE_NAME=Chrome

QRCODE_LIMIT=30 QRCODE_COLOR=#175197

TYPEBOT_ENABLED=false TYPEBOT_API_VERSION=latest

CHATWOOT_ENABLED=true CHATWOOT_MESSAGE_READ=true CHATWOOT_MESSAGE_DELETE=true CHATWOOT_BOT_CONTACT=true CHATWOOT_IMPORT_DATABASE_CONNECTION_URI={seu banco aqui} CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE=true

OPENAI_ENABLED=false DIFY_ENABLED=false

CACHE_REDIS_ENABLED=true CACHE_REDIS_URI={conecte seu banco} CACHE_REDIS_TTL=604800 CACHE_REDIS_PREFIX_KEY=evolution CACHE_REDIS_SAVE_INSTANCES=false CACHE_LOCAL_ENABLED=false

S3_ENABLED=false S3_ACCESS_KEY= S3_SECRET_KEY= S3_BUCKET=evolution S3_PORT=443 S3_ENDPOINT=s3.domain.com S3_REGION=eu-west-3 S3_USE_SSL=true

AUTHENTICATION_API_KEY={Sua chave aqui} AUTHENTICATION_EXPOSE_IN_FETCH_INSTANCES=true

LANGUAGE=en

PROXY_HOST= PROXY_PORT=80 PROXY_PROTOCOL=http PROXY_USERNAME= PROXY_PASSWORD=

Nov 15 '25 07:11 GuilhermeBotingnon

Fiz a instalação da API em Docker localmente na minha máquina e tentei diversas alterações nas variáveis de ambiente mas meu QR Code não aparece. No momento tenho o seguinte trecho do .env: CONFIG_SESSION_PHONE_CLIENT=Evolution API CONFIG_SESSION_PHONE_NAME=Chrome CONFIG_SESSION_PHONE_VERSION=2.3000.1023181082

Caso esse version seja outro, como eu encontro o valor atualizado? Vocês tem alguma idéia de como resolver? Tenho no docker a api evolution + n8n + ngrok, redis e postgres.

Nov 18 '25 21:11 edson-martins

@edson-martins eu estava com esse problema nas versões anteriores, se possivel utiliza a imagem mais recente! coloquei meu .env abaixo, altere as informações de login do banco e também na env, altere para .env-evolution, deve estar no mesmo nivel de onde está seu docker-compose.yml, caso você esteja usando portainer ou outro assim, altere a o serviço de env_file: -.env-evolution

para -> .env

também, caso tenha uma vps, altere as configurações de DNS da mesma para -> 4.4.8.8 8.8.8.8

pra mim funcionou, recomendo também quando iniciar o container deslogue da plataforma /manager, e logue novamente, isso me ajudou com problemas referentes a fetch.

evolution-api: image: 'evoapicloud/evolution-api:v2.3.6' container_name: 'evolution_api' restart: always env_file: - .env-evolution volumes: - 'evolution_store:/evolution/store' - 'evolution_instances:/evolution/instances' networks: - traefik-net labels: - 'traefik.enable=true' - 'traefik.http.routers.evolution.rule=Host(evolution.botinhodominios.site)' - 'traefik.http.services.evolution.loadbalancer.server.port=8080' - 'traefik.http.routers.evolution.tls.certresolver=letsencrypt'

Atualmente eu utilizo o traefik para certificados, porém utiliza essa imagem aí, e atualmente meu .env é

SERVER_TYPE=http SERVER_PORT=8080 SERVER_URL={seu servidor aqui}

SENTRY_DSN=

CORS_ORIGIN=* CORS_METHODS=GET,POST,PUT,DELETE CORS_CREDENTIALS=true

LOG_LEVEL=ERROR,WARN,DEBUG,INFO,LOG,VERBOSE,DARK,WEBHOOKS,WEBSOCKET LOG_COLOR=true LOG_BAILEYS=error

EVENT_EMITTER_MAX_LISTENERS=50

DEL_INSTANCE=false

DATABASE_PROVIDER=postgresql DATABASE_CONNECTION_URI={seu banco aqui} DATABASE_CONNECTION_CLIENT_NAME=evolution_exchange DATABASE_SAVE_DATA_INSTANCE=true DATABASE_SAVE_DATA_NEW_MESSAGE=true DATABASE_SAVE_MESSAGE_UPDATE=true DATABASE_SAVE_DATA_CONTACTS=true DATABASE_SAVE_DATA_CHATS=true DATABASE_SAVE_DATA_LABELS=true DATABASE_SAVE_DATA_HISTORIC=true DATABASE_SAVE_IS_ON_WHATSAPP=true DATABASE_SAVE_IS_ON_WHATSAPP_DAYS=7 DATABASE_DELETE_MESSAGE=true

RABBITMQ_ENABLED=false RABBITMQ_URI=amqp://localhost RABBITMQ_EXCHANGE_NAME=evolution RABBITMQ_GLOBAL_ENABLED=false RABBITMQ_EVENTS_APPLICATION_STARTUP=false RABBITMQ_EVENTS_INSTANCE_CREATE=false RABBITMQ_EVENTS_INSTANCE_DELETE=false RABBITMQ_EVENTS_QRCODE_UPDATED=false RABBITMQ_EVENTS_MESSAGES_SET=false RABBITMQ_EVENTS_MESSAGES_UPSERT=false RABBITMQ_EVENTS_MESSAGES_EDITED=false RABBITMQ_EVENTS_MESSAGES_UPDATE=false RABBITMQ_EVENTS_MESSAGES_DELETE=false RABBITMQ_EVENTS_SEND_MESSAGE=false RABBITMQ_EVENTS_CONTACTS_SET=false RABBITMQ_EVENTS_CONTACTS_UPSERT=false RABBITMQ_EVENTS_CONTACTS_UPDATE=false RABBITMQ_EVENTS_PRESENCE_UPDATE=false RABBITMQ_EVENTS_CHATS_SET=false RABBITMQ_EVENTS_CHATS_UPSERT=false RABBITMQ_EVENTS_CHATS_UPDATE=false RABBITMQ_EVENTS_CHATS_DELETE=false RABBITMQ_EVENTS_GROUPS_UPSERT=false RABBITMQ_EVENTS_GROUP_UPDATE=false RABBITMQ_EVENTS_GROUP_PARTICIPANTS_UPDATE=false RABBITMQ_EVENTS_CONNECTION_UPDATE=false RABBITMQ_EVENTS_REMOVE_INSTANCE=false RABBITMQ_EVENTS_LOGOUT_INSTANCE=false RABBITMQ_EVENTS_CALL=false RABBITMQ_EVENTS_TYPEBOT_START=false RABBITMQ_EVENTS_TYPEBOT_CHANGE_STATUS=false

SQS_ENABLED=false SQS_ACCESS_KEY_ID= SQS_SECRET_ACCESS_KEY= SQS_ACCOUNT_ID= SQS_REGION=

WEBSOCKET_ENABLED=false WEBSOCKET_GLOBAL_EVENTS=false

PUSHER_ENABLED=false PUSHER_GLOBAL_ENABLED=false PUSHER_GLOBAL_APP_ID= PUSHER_GLOBAL_KEY= PUSHER_GLOBAL_SECRET= PUSHER_GLOBAL_CLUSTER= PUSHER_GLOBAL_USE_TLS=true PUSHER_EVENTS_APPLICATION_STARTUP=true PUSHER_EVENTS_QRCODE_UPDATED=true PUSHER_EVENTS_MESSAGES_SET=true PUSHER_EVENTS_MESSAGES_UPSERT=true PUSHER_EVENTS_MESSAGES_EDITED=true PUSHER_EVENTS_MESSAGES_UPDATE=true PUSHER_EVENTS_MESSAGES_DELETE=true PUSHER_EVENTS_SEND_MESSAGE=true PUSHER_EVENTS_CONTACTS_SET=true PUSHER_EVENTS_CONTACTS_UPSERT=true PUSHER_EVENTS_CONTACTS_UPDATE=true PUSHER_EVENTS_PRESENCE_UPDATE=true PUSHER_EVENTS_CHATS_SET=true PUSHER_EVENTS_CHATS_UPSERT=true PUSHER_EVENTS_CHATS_UPDATE=true PUSHER_EVENTS_CHATS_DELETE=true PUSHER_EVENTS_GROUPS_UPSERT=true PUSHER_EVENTS_GROUPS_UPDATE=true PUSHER_EVENTS_GROUP_PARTICIPANTS_UPDATE=true PUSHER_EVENTS_CONNECTION_UPDATE=true PUSHER_EVENTS_LABELS_EDIT=true PUSHER_EVENTS_LABELS_ASSOCIATION=true PUSHER_EVENTS_CALL=true PUSHER_EVENTS_TYPEBOT_START=false PUSHER_EVENTS_TYPEBOT_CHANGE_STATUS=false

WA_BUSINESS_TOKEN_WEBHOOK=evolution WA_BUSINESS_URL=https://graph.facebook.com WA_BUSINESS_VERSION=v20.0 WA_BUSINESS_LANGUAGE=en_US

WEBHOOK_GLOBAL_ENABLED=false WEBHOOK_GLOBAL_URL= WEBHOOK_GLOBAL_WEBHOOK_BY_EVENTS=false WEBHOOK_EVENTS_APPLICATION_STARTUP=false WEBHOOK_EVENTS_QRCODE_UPDATED=true WEBHOOK_EVENTS_MESSAGES_SET=true WEBHOOK_EVENTS_MESSAGES_UPSERT=true WEBHOOK_EVENTS_MESSAGES_EDITED=true WEBHOOK_EVENTS_MESSAGES_UPDATE=true WEBHOOK_EVENTS_MESSAGES_DELETE=true WEBHOOK_EVENTS_SEND_MESSAGE=true WEBHOOK_EVENTS_CONTACTS_SET=true WEBHOOK_EVENTS_CONTACTS_UPSERT=true WEBHOOK_EVENTS_CONTACTS_UPDATE=true WEBHOOK_EVENTS_PRESENCE_UPDATE=true WEBHOOK_EVENTS_CHATS_SET=true WEBHOOK_EVENTS_CHATS_UPSERT=true WEBHOOK_EVENTS_CHATS_UPDATE=true WEBHOOK_EVENTS_CHATS_DELETE=true WEBHOOK_EVENTS_GROUPS_UPSERT=true WEBHOOK_EVENTS_GROUPS_UPDATE=true WEBHOOK_EVENTS_GROUP_PARTICIPANTS_UPDATE=true WEBHOOK_EVENTS_CONNECTION_UPDATE=true WEBHOOK_EVENTS_REMOVE_INSTANCE=false WEBHOOK_EVENTS_LOGOUT_INSTANCE=false WEBHOOK_EVENTS_LABELS_EDIT=true WEBHOOK_EVENTS_LABELS_ASSOCIATION=true WEBHOOK_EVENTS_CALL=true WEBHOOK_EVENTS_TYPEBOT_START=false WEBHOOK_EVENTS_TYPEBOT_CHANGE_STATUS=false WEBHOOK_EVENTS_ERRORS=false WEBHOOK_EVENTS_ERRORS_WEBHOOK=

CONFIG_SESSION_PHONE_CLIENT=Evolution API CONFIG_SESSION_PHONE_NAME=Chrome

QRCODE_LIMIT=30 QRCODE_COLOR=#175197

TYPEBOT_ENABLED=false TYPEBOT_API_VERSION=latest

CHATWOOT_ENABLED=true CHATWOOT_MESSAGE_READ=true CHATWOOT_MESSAGE_DELETE=true CHATWOOT_BOT_CONTACT=true CHATWOOT_IMPORT_DATABASE_CONNECTION_URI={seu banco aqui} CHATWOOT_IMPORT_PLACEHOLDER_MEDIA_MESSAGE=true

OPENAI_ENABLED=false DIFY_ENABLED=false

CACHE_REDIS_ENABLED=true CACHE_REDIS_URI={conecte seu banco} CACHE_REDIS_TTL=604800 CACHE_REDIS_PREFIX_KEY=evolution CACHE_REDIS_SAVE_INSTANCES=false CACHE_LOCAL_ENABLED=false

S3_ENABLED=false S3_ACCESS_KEY= S3_SECRET_KEY= S3_BUCKET=evolution S3_PORT=443 S3_ENDPOINT=s3.domain.com S3_REGION=eu-west-3 S3_USE_SSL=true

AUTHENTICATION_API_KEY={Sua chave aqui, gere ela e coloque, vai ser importante para entrar na conta e usar depois} AUTHENTICATION_EXPOSE_IN_FETCH_INSTANCES=true

LANGUAGE=en

PROXY_HOST= PROXY_PORT=80 PROXY_PROTOCOL=http PROXY_USERNAME= PROXY_PASSWORD=

Nov 18 '25 21:11 GuilhermeBotingnon

to mais perdido que cego em tiroteio nada funciona pra mim o que é .env?

Nov 19 '25 22:11 rudarecordsdemo-creator

@rudarecordsdemo-creator Pensa em como se fosse um arquivo onde você coloca suas informações 'unicas' e o programa utiliza elas em forma de variáveis, geralmente. env significa enviroment, seria configuração do seu ambiente, em específico o Evolution nas etapas de instalação dele, disponibiliza todos os parâmetros que um env pode ter, disponibilizando pra você alterar conforme sua necessidade, cria arquivo e coloca o nome de .env cola esse cara todo, e salva, sempre que seu ambiente do evolution subir, vai utilizar esses dados, se mesmo assim você está perdido, da uma olhada na documentação da evolution, a parte de instalação e procura aprender oque significa cada coisa e como faz um setup de docker!

Nov 19 '25 22:11 GuilhermeBotingnon

Pra mim resolveu adicionar o dns na stack. Também removi aquele lance da config version do env. Enfim, o erro handle da evo é meio bugado, poderia ser melhor, mas ainda assim é a melhor ferramenta para wpp.

Nov 23 '25 23:11 mendoncart

Pessoal, estava tendo o mesmo problema, e a dica do @GuilhermeBotingnon deu certo tah? Estou subindo o serviço com o docker, e alterei a imagem de "evoapicloud/evolution-api:latest" pra "evoapicloud/evolution-api:v2.3.6"

Nov 29 '25 21:11 Erlonidas

@Erlonidas Fico feliz por ter dado certo, também estou lutando pra resolver uns bugs e como companheiros devs que somos, eu consigo compartilhar mimha experiência e ajudar cm oque sei!

Nov 29 '25 23:11 GuilhermeBotingnon