Variáveis de ambiente do Chatwoot
149 variáveis em 18 categorias
As categorias com mais variáveis têm página própria. As menores aparecem completas no fim desta página. Cada variável traz tipo, valor padrão, valores aceitos, situação e o link para a fonte oficial.A lista sai da documentação e do código do Chatwoot, conferidos em 12 de novembro de 2026.
- Versão de referência
- v4.19.1
- Aplicação e implantação
ASSET_CDN_HOSTCW_API_ONLY_SERVERDEFAULT_LOCALE
- APM e monitoramento
DD_TRACE_AGENT_URLELASTIC_APM_SECRET_TOKENELASTIC_APM_SERVER_URL
- Apps móveis e notificações push
ANDROID_BUNDLE_IDANDROID_SHA256_CERT_FINGERPRINTENABLE_PUSH_RELAY_SERVER
- Armazenamento de arquivos
ACTIVE_STORAGE_SERVICEAWS_ACCESS_KEY_IDAWS_REGION
- Banco de dados
DATABASE_URLPOSTGRES_DATABASEPOSTGRES_HOST
- Busca avançada
ELASTICSEARCH_API_KEYOPENSEARCH_API_KEYOPENSEARCH_AWS_ACCESS_KEY_ID
- Canais e integrações
FB_APP_IDFB_APP_SECRETFB_VERIFY_TOKEN
- Desenvolvimento
LETTER_OPENERWEBPACKER_DEV_SERVER_PUBLIC
- Email de entrada
ACTION_MAILBOX_SES_SNS_TOPICEMAIL_PROCESSING_TIMEOUT_SECONDSMAILER_INBOUND_EMAIL_DOMAIN
- Envio de email
MAILER_SENDER_EMAILSMTP_ADDRESSSMTP_AUTHENTICATION
- IA e monitores de conversa
CONVERSATION_MONITORS_ATTRIBUTESCONVERSATION_MONITORS_LIMITCONVERSATION_MONITORS_MODEL
- Login social e OAuth
AZURE_APP_IDAZURE_APP_SECRETGOOGLE_OAUTH_CALLBACK_URL
- Logs
LOG_LEVELLOG_SIZELOGRAGE_ENABLED
- Pagamentos
STRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRET
- Redis
REDIS_ALFRED_SIZEREDIS_OPENSSL_VERIFY_MODEREDIS_PASSWORD
- Resolução automática
AUTO_RESOLVE_CRONAUTO_RESOLVE_MIN_MINUTES
- Segurança e limites de requisição
ACTIVE_RECORD_ENCRYPTION_DETERMINISTIC_KEYACTIVE_RECORD_ENCRYPTION_KEY_DERIVATION_SALTACTIVE_RECORD_ENCRYPTION_PRIMARY_KEY
- Sidekiq e desempenho
ENABLE_SIDEKIQ_CLOUDWATCHENABLE_SIDEKIQ_DEQUEUE_LOGGERRAILS_MAX_THREADS
Aplicação e implantação
Host da CDN que entrega os assets estáticos. Defina quando os assets passarem por uma CDN.
- Tipo
- URL
- Padrão
- sem padrão
Roda o Chatwoot só como servidor de API. Com
true, os endpoints do painel web ficam desativados.- Tipo
- Booleano
- Padrão
false
Idioma padrão. As páginas sem autenticação usam este idioma. Toda account nova começa com ele no lugar de
en.- Tipo
- Texto
- Padrão
en
Controla o cadastro de accounts novas.
true, o padrão, permite o cadastro.falsedesativa todos os endpoints de cadastro.api_onlyesconde a tela de cadastro, que continua disponível pela API de accounts.- Tipo
- Enum
- Padrão
false- Valores
truefalseapi_only
FRONTEND_URL- Ativa
- Obrigatória
- Fonte oficial de FRONTEND_URL
URL pública da instalação do Chatwoot, usada nos links do app.
- Tipo
- URL
- Padrão
http://0.0.0.0:3000
URL dedicada às páginas da central de ajuda.
- Tipo
- URL
- Padrão
http://0.0.0.0:3000
API key da MaxMind para baixar a base GeoLite2 City.
- Tipo
- Segredo
- Padrão
- sem padrão
RAILS_ENV- Ativa
- Obrigatória
- Fonte oficial de RAILS_ENV
Ambiente do Rails. Em produção, defina
production.- Tipo
- Texto
- Padrão
development
Apps móveis e notificações push
Bundle ID do app Android. Altere só se você usa um build próprio do app móvel.
- Tipo
- Texto
- Padrão
com.chatwoot.app
Impressão digital SHA-256 do certificado do app Android, gerada com o
keytool. Altere só se você usa um build próprio do app móvel.- Tipo
- Texto
- Padrão
AC:73:8E:DE:EB:56:EA:CC:10:87:02:A7:65:37:7B:38:D4:5D:D4:53:F8:3B:FB:D3:C6:28:64:1D:AA:08:1E:D8
Encaminha as notificações push dos apps móveis oficiais por um servidor do Chatwoot.
- Tipo
- Booleano
- Padrão
true
Server key do Firebase Cloud Messaging para notificações push nos apps móveis.
- Tipo
- Segredo
- Padrão
- sem padrão
App ID do app iOS. Altere só se você usa um build próprio do app móvel.
- Tipo
- Texto
- Padrão
L7YLMN4634.com.chatwoot.app
Identificador do app na App Store, usado no Smart App Banner do Safari.
- Tipo
- Texto
- Padrão
1495796682
Chave privada VAPID das notificações push no navegador.
- Tipo
- Segredo
- Padrão
- sem padrão
Chave pública VAPID das notificações push no navegador.
- Tipo
- Texto
- Padrão
- sem padrão
Banco de dados
URI de conexão com o PostgreSQL. É a alternativa às variáveis
POSTGRES_*separadas.- Tipo
- URL
- Padrão
- sem padrão
Nome do banco PostgreSQL. O valor pode ficar vazio. Em produção, o padrão é
chatwoot_production.- Tipo
- Texto
- Padrão
chatwoot_production
Host do PostgreSQL. Dispensável quando
DATABASE_URLestá configurada.- Tipo
- Texto
- Padrão
postgres
Senha do usuário do PostgreSQL. Dispensável quando
DATABASE_URLestá configurada.- Tipo
- Segredo
- Padrão
- sem padrão
Porta do PostgreSQL. Dispensável quando
DATABASE_URLestá configurada.- Tipo
- Número
- Padrão
- sem padrão
Tempo limite das consultas no PostgreSQL. O padrão é 14 segundos. Altere só quando necessário.
- Tipo
- Texto
- Padrão
14s
Usuário do PostgreSQL. Dispensável quando
DATABASE_URLestá configurada.- Tipo
- Texto
- Padrão
postgres
Busca avançada
API key do Elastic Cloud para a busca avançada, sem o prefixo
ApiKey. Pode ser usada no lugar deOPENSEARCH_API_KEY.- Tipo
- Segredo
- Padrão
- sem padrão
API key do OpenSearch ou do Elastic Cloud para a busca avançada, sem o prefixo
ApiKey.- Tipo
- Segredo
- Padrão
- sem padrão
Access key ID da AWS para o OpenSearch gerenciado pela AWS.
- Tipo
- Segredo
- Padrão
- sem padrão
Define a região AWS usada na conexão com o serviço OpenSearch gerenciado.
- Tipo
- Texto
- Padrão
us-east-1
Secret access key da AWS para o OpenSearch gerenciado pela AWS.
- Tipo
- Segredo
- Padrão
- sem padrão
URL do OpenSearch ou de um serviço compatível com Elasticsearch. Definir esta variável ativa a busca avançada.
- Tipo
- URL
- Padrão
- sem padrão
Número de dias que a busca alcança para trás. O limite vale para a busca de mensagens e para o filtro de data de conversas, contatos e artigos. O padrão é 90.
- Tipo
- Número
- Padrão
90
Desenvolvimento
Abre os emails no navegador com o letter_opener, no lugar de enviá-los. Use só em desenvolvimento.
- Tipo
- Booleano
- Padrão
- sem padrão
Endereço público do servidor de desenvolvimento do Webpacker, pensado para o GitHub Codespaces.
- Tipo
- Texto
- Padrão
- sem padrão
Email de entrada
ARN do tópico SNS usado pelo Action Mailbox para receber emails pelo Amazon SES, no formato
arn:aws:sns:<região>:<account-id>:<tópico>. Configure só quandoRAILS_INBOUND_EMAIL_SERVICEforses.- Tipo
- Texto
- Padrão
- sem padrão
Tempo máximo, em segundos, para processar um único email recebido por IMAP.
- Tipo
- Número
- Padrão
60
Domínio dos emails de resposta quando a continuidade de conversa por email está ativa.
- Tipo
- Texto
- Padrão
- sem padrão
Signing key do Mailgun para validar os emails recebidos, com
RAILS_INBOUND_EMAIL_SERVICE=mailgun.- Tipo
- Segredo
- Padrão
- sem padrão
API key do Mandrill para validar os emails recebidos, com
RAILS_INBOUND_EMAIL_SERVICE=mandrill.- Tipo
- Segredo
- Padrão
- sem padrão
Senha escolhida por você para o webhook de entrada de emails do Action Mailbox, usada na URL do webhook.
- Tipo
- Segredo
- Padrão
- sem padrão
Canal de entrada dos emails recebidos:
relaypara Exim, Postfix e Qmail, oumailgun,mandrill,postmark,sendgrideses.- Tipo
- Enum
- Padrão
- sem padrão
- Valores
relaymailgunmandrillpostmarksendgridses
IA e monitores de conversa
Lista das chaves de atributos personalizados de contato e de conversa que os monitores de conversa do plano Enterprise recebem como informação do cliente.
- Tipo
- Lista
- Padrão
- sem padrão
Limite dos monitores de conversa do plano Enterprise. O recurso
conversation_monitorsprecisa ser ativado à parte na account.- Tipo
- Número
- Padrão
20
Modelo usado pelos monitores de conversa do plano Enterprise. A chave do OpenRouter fica em Super Admin > Settings > Captain.
- Tipo
- Texto
- Padrão
typesafe/jev-1.13
Login social e OAuth
Application ID do app da Microsoft usado no login OAuth com a Microsoft.
- Tipo
- Texto
- Padrão
- sem padrão
Segredo do app da Microsoft usado no login OAuth com a Microsoft.
- Tipo
- Segredo
- Padrão
- sem padrão
URL de callback do login com Google, no formato
https://<seu-domínio>/omniauth/google_oauth2/callback. O endpoint não pode ser alterado.- Tipo
- URL
- Padrão
- sem padrão
Client ID do OAuth do Google, copiado do Google API Console, para o login com Google.
- Tipo
- Texto
- Padrão
- sem padrão
Client secret do OAuth do Google, copiado do Google API Console, para o login com Google.
- Tipo
- Segredo
- Padrão
- sem padrão
Logs
Nível de log do Rails:
debug,info,warn,error,fatalouunknown. Em produção, o padrão éinfo.- Tipo
- Enum
- Padrão
info- Valores
debuginfowarnerrorfatalunknown
Tamanho máximo do arquivo de log, em megabytes.
- Tipo
- Número
- Padrão
500
Usa o lograge no lugar do logger padrão do Rails.
- Tipo
- Booleano
- Padrão
- sem padrão
Envia os logs para a saída padrão. Desative para gravar os logs em arquivo.
- Tipo
- Booleano
- Padrão
true
Pagamentos
Fornece a secret key usada pelo Chatwoot para autenticar as chamadas à API do Stripe.
- Tipo
- Segredo
- Padrão
- sem padrão
Segredo de assinatura dos webhooks do Stripe.
- Tipo
- Segredo
- Padrão
- sem padrão
Redis
Tamanho do pool de conexões Alfred com o Redis, na seção de housekeeping e desempenho.
- Tipo
- Número
- Padrão
10
Modo de verificação OpenSSL da conexão com o Redis.
nonecontorna a falha do Redis premium do Heroku.- Tipo
- Texto
- Padrão
none
Senha do Redis usada pelo servidor do app e pelo Sidekiq.
- Tipo
- Segredo
- Padrão
- sem padrão
Nome do master no Redis Sentinel, exigido com Sentinel. O padrão é
mymaster.- Tipo
- Texto
- Padrão
mymaster
Senha dos Sentinels. Sem ela, o Chatwoot usa
REDIS_PASSWORD. Deixe vazia quando os Sentinels não têm senha.- Tipo
- Segredo
- Padrão
- sem padrão
Lista de Sentinels do Redis no formato
host1:porta1,host2:porta2.- Tipo
- Lista
- Padrão
- sem padrão
URL de conexão com o Redis, no formato
redis://:senha@host:porta/banco.- Tipo
- URL
- Padrão
redis://redis:6379
Tamanho do pool de conexões Velma com o Redis, na seção de housekeeping e desempenho.
- Tipo
- Número
- Padrão
10
Resolução automática
Agenda cron do job de resolução automática de conversas. O padrão roda a cada 5 minutos.
- Tipo
- Texto
- Padrão
*/5 * * * *
Tempo mínimo de inatividade, em minutos, que cada account do Chatwoot pode configurar na resolução automática. O padrão é 10.
- Tipo
- Número
- Padrão
10
Uma VPS para desenvolver com agentes
Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.
Link de parceiro da Promovaweb.