Variáveis de ambiente: Mensageria
247 variáveis em Mensageria
A lista sai da documentação e do código do Hermes Agent, conferidos em 13 de novembro de 2026. Cada variável traz o link para a página oficial de onde o tipo e o padrão foram tirados.
- Versão de referência
- v0.23.1
- Todas as categorias
- Menu das variáveis do Hermes Agent
Origens de navegador, separadas por vírgula, autorizadas a chamar o servidor de API diretamente. Sem valor, o acesso direto pelo navegador fica desligado.
Liga o servidor de API compatível com a OpenAI.
Endereço de escuta do servidor de API.
Token Bearer de autenticação do servidor de API. Obrigatório quando o servidor está ligado.
Nome do modelo anunciado em
/v1/models. Sem valor, o Hermes usa o nome do perfil.Porta do servidor de API.
Libera todos os usuários.
Usuários autorizados, separados por vírgula.
Telefone ou email usado na entrega de cron e notificações.
Senha do servidor BlueBubbles.
URL do servidor BlueBubbles.
Endereço de escuta do webhook.
Porta de escuta do webhook.
IDs de usuário do DingTalk autorizados a falar com o bot, separados por vírgula.
AppKey do bot DingTalk no portal de desenvolvedores.
AppSecret do bot DingTalk.
ID da conversa padrão para cron e notificações.
Nome exibido do canal principal do DingTalk.
URL fixa do webhook do robô para entrega entre plataformas e por cron.
Libera qualquer usuário do Discord. Use só em desenvolvimento.
Aceita anexos de qualquer tipo de arquivo, além da lista interna. O padrão é false.
Permite ao bot mencionar @everyone e @here. O padrão é false.
Menciona o autor ao responder à mensagem dele. O padrão é true.
Permite ao bot mencionar cargos. O padrão é false.
Permite ao bot mencionar usuários individualmente. O padrão é true.
IDs de canal do Discord, separados por vírgula. Com a lista definida, o bot só responde nesses canais.
IDs de cargo do Discord autorizados a usar o bot, separados por vírgula.
IDs de usuário do Discord autorizados a usar o bot, separados por vírgula.
Cria threads automaticamente para respostas longas quando o canal permite.
Token do bot do Discord.
Política de sincronização dos comandos de barra na inicialização: safe, bulk ou off.
Cria uma thread por mensagem de nível superior nos canais de resposta livre. O padrão é false.
IDs dos canais onde o bot responde sem exigir menção.
Canal padrão do Discord para entrega de cron.
Nome exibido do canal principal do Discord.
IDs dos canais onde o bot nunca responde.
Tamanho máximo em bytes de cada anexo que o gateway guarda. O padrão é 33554432.
Reenvia mensagens perdidas enquanto o bot estava desconectado. O padrão é false.
A documentação mantém a variável por compatibilidade, mas já existe uma opção mais nova.
IDs de canal verificados na recuperação de mensagens perdidas. Sem valor, o Hermes usa os canais de resposta livre.
A documentação mantém a variável por compatibilidade, mas já existe uma opção mais nova.
Máximo de mensagens buscadas por canal em cada varredura. O padrão é 100.
A documentação mantém a variável por compatibilidade, mas já existe uma opção mais nova.
Máximo de reenvios de uma mesma mensagem ao longo das reconexões. O padrão é 3.
A documentação mantém a variável por compatibilidade, mas já existe uma opção mais nova.
Máximo de mensagens reenviadas por varredura. O padrão é 10.
A documentação mantém a variável por compatibilidade, mas já existe uma opção mais nova.
Janela de tempo, em segundos, que a varredura pode cobrir. O padrão é 21600 e o mínimo é 60.
A documentação mantém a variável por compatibilidade, mas já existe uma opção mais nova.
IDs dos canais onde o bot responde sem criar thread.
URL de proxy para as conexões do Discord. Tem precedência sobre HTTPS_PROXY.
Liga reações de emoji durante o processamento. O padrão é true.
Comportamento da referência de resposta: off, first ou all.
Exige menção ao bot antes de responder nos canais do servidor.
Endereço de email do adaptador de email.
Libera todos os remetentes de email de entrada.
Endereços de email autorizados a falar com o bot.
Valor exato de authserv-id no cabeçalho Authentication-Results do servidor receptor.
Destinatário padrão das mensagens proativas por email.
Nome exibido do destinatário principal de email.
Host IMAP do adaptador de email.
Porta IMAP.
Senha, ou senha de aplicativo, do endereço configurado em
EMAIL_ADDRESS.Intervalo de consulta do email, em segundos.
Host SMTP do adaptador de email.
Porta SMTP.
Libera qualquer usuário do Feishu. Use só em desenvolvimento.
Aceita mensagens de outros bots: none, mentions ou all.
IDs de usuário do Feishu autorizados a falar com o bot.
App ID do bot Feishu ou Lark.
App Secret do bot Feishu ou Lark.
Modo de conexão: websocket ou webhook.
Domínio do Feishu: feishu na China ou lark na versão internacional.
Chave opcional de criptografia no modo webhook.
ID do chat do Feishu para cron e notificações.
Nome exibido do canal principal do Feishu.
Exige menção ao bot nas mensagens de grupo. O padrão é true.
Token opcional de verificação no modo webhook.
Libera todos os usuários sem lista de permissão. O padrão é false.
IDs de usuário autorizados em todas as plataformas.
Token Bearer para autenticar no servidor de API remoto no modo proxy.
URL de um servidor de API remoto do Hermes para onde encaminhar as mensagens.
Libera qualquer usuário do Google Chat. Use só em desenvolvimento.
Emails de usuário autorizados a conversar com o bot.
IDs de espaço extras verificados na inicialização para resolver o próprio usuário do bot.
Registra os envelopes do Pub/Sub em nível DEBUG, com dados sensíveis removidos.
Espaço padrão para entrega de cron.
Nome exibido do espaço principal do Google Chat.
Público esperado nos tokens Bearer dos eventos HTTP assinados pelo Google.
Email da service account do Google esperado nos tokens Bearer dos eventos HTTP.
Endpoint HTTP autenticado para eventos de mensagem do Chat, alternativa ao Pub/Sub.
Máximo de bytes em voo no controle de fluxo do Pub/Sub. O padrão é 16 MiB.
Máximo de mensagens em voo no controle de fluxo do Pub/Sub. O padrão é 1.
Projeto do Google Cloud que hospeda o tópico do Pub/Sub.
Caminho do JSON da service account, ou o próprio JSON. Sem valor, o Hermes usa
GOOGLE_APPLICATION_CREDENTIALS.Caminho completo da assinatura do Pub/Sub.
Destino padrão de notificação do plugin Home Assistant.
Token de acesso de longa duração do Home Assistant.
URL do Home Assistant.
Token de acesso do bot no Matrix.
Libera qualquer usuário do Matrix. Use só em desenvolvimento.
Permite que as ferramentas criem salas públicas. O padrão é false.
Permite menções @room de saída. O padrão é false.
IDs das salas do Matrix onde o bot pode responder.
IDs de usuário do Matrix autorizados a falar com o bot.
Exige que a reação de aprovação venha do autor da solicitação original, quando ele é conhecido. O padrão é
true.Tempo limite das solicitações de aprovação por reação no Matrix. O padrão é 300.
Cria threads para mensagens de sala. O padrão é true.
ID de dispositivo fixo do Matrix para manter a chave de criptografia entre reinícios.
Cria threads para mensagens diretas no Matrix. O padrão é false.
Cria uma thread quando o bot é mencionado em uma mensagem direta. O padrão é false.
Comportamento da criptografia ponta a ponta: off, optional ou required.
Liga a criptografia ponta a ponta. O padrão é false.
IDs das salas onde o bot responde sem menção.
ID da sala padrão para cron e notificações.
Nome exibido da sala principal do Matrix.
ID da sala usada para mensagens proativas.
URL do servidor Matrix.
Expressões regulares, separadas por vírgula, de usuários fantasma de bridge a ignorar.
Tamanho máximo de upload e download de mídia no Matrix, em bytes.
Senha do Matrix, alternativa ao token de acesso.
Processa eventos m.notice recebidos. O padrão é false.
Liga reações de emoji durante o processamento. O padrão é true.
Chave de recuperação para verificação cruzada após a troca das chaves do dispositivo.
Caminho de uso único para gravar uma chave de recuperação gerada.
Exige menção nas salas. O padrão é true.
Escopo da sessão em salas de projeto: auto, room ou thread.
ID do usuário do Matrix. Necessário no login por senha, opcional com token de acesso.
Libera qualquer usuário do Mattermost. Use só em desenvolvimento.
Canais onde o bot responde. Com a lista definida, o bot só responde neles.
IDs de usuário do Mattermost autorizados a falar com o bot.
IDs dos canais onde o bot responde sem menção.
ID do canal para mensagens proativas, cron e notificações.
Estilo de resposta: thread ou off para mensagens planas.
Exige menção nos canais. O padrão é true.
Token do bot ou token de acesso pessoal do Mattermost.
URL do servidor Mattermost.
Diretório de trabalho do gateway, mantido por compatibilidade. Prefira terminal.cwd no config.yaml.
A documentação mantém a variável por compatibilidade, mas já existe uma opção mais nova.
Libera todos os usuários do QQ e ignora QQ_ALLOWED_USERS.
openIDs de usuário do QQ autorizados a falar com o bot.
App ID do bot QQ.
App Secret do bot QQ.
IDs de grupo do QQ com acesso por menção.
Substitui o host do portal QQ. Use sandbox.q.qq.com para o gateway de testes.
Liga o modo sandbox do QQ para testes de desenvolvimento.
Chave do provedor externo de transcrição usado quando o ASR interno do QQ não devolve texto.
URL base do provedor externo de transcrição.
Modelo do provedor externo de transcrição.
openID do usuário ou grupo do QQ para cron e notificações.
Nome exibido do canal principal do QQ.
Número do bot no Signal, no formato E.164.
Libera todos os usuários do Signal, sem lista de permissão.
Números E.164 ou UUIDs autorizados, separados por vírgula.
IDs de grupo autorizados, ou asterisco para todos os grupos.
Nome exibido do canal principal do Signal.
Endpoint HTTP do daemon signal-cli.
Ignora stories e atualizações de status do Signal.
Libera qualquer usuário do Slack. Use só em desenvolvimento.
Aceita mensagens de outros bots do Slack: none, mentions ou all.
IDs de usuário do Slack, separados por vírgula.
Token de nível de aplicativo do Slack, necessário no Socket Mode.
Token do bot do Slack.
Canal padrão do Slack para entrega de cron.
Nome exibido do canal principal do Slack.
Permite que um marcador de silêncio encerre respostas de thread sem aviso de silêncio inesperado.
Exige menção explícita nas respostas de thread do Slack.
Libera todos os remetentes de SMS, sem lista de permissão.
Números E.164 autorizados a conversar, separados por vírgula.
Número de telefone para cron e notificações.
Nome exibido do canal principal de SMS.
Desativa a validação de assinatura do Twilio. Use só em desenvolvimento local, nunca em produção.
Endereço de escuta do webhook.
Porta de escuta do webhook de SMS recebido.
URL pública usada na validação de assinatura do Twilio. Precisa ser igual à URL do webhook no console.
Libera qualquer usuário do Telegram. Use só em desenvolvimento.
IDs de tópico ou thread de fórum do Telegram atendidos pelo bot.
IDs de usuário do Telegram autorizados a usar o bot.
Token do bot do Telegram, obtido com o @BotFather.
Exige menção explícita ao bot nas mensagens enviadas por outro bot.
A documentação informa que a variável não é mais lida pelo Hermes.
ID do tópico de fórum que recebe as entregas de cron.
Encaminha menções explícitas apenas ao bot mencionado, antes das alternativas de resposta. O padrão é true.
IDs dos chats onde o bot responde a toda mensagem de grupo, sem exigir menção.
Pares
chat_id:thread_idque indicam os tópicos onde o bot responde sem menção.IDs dos grupos ou fóruns nos quais qualquer membro é autorizado.
IDs de remetente autorizados apenas em grupos e fóruns.
Chat ou canal padrão do Telegram para entrega de cron.
Nome exibido do canal principal do Telegram.
IDs dos tópicos ou threads do Telegram onde o bot nunca responde.
Padrões de expressão regular para palavras de ativação em grupos do Telegram.
URL de proxy para as conexões do Telegram. Tem precedência sobre HTTPS_PROXY.
Liga reações de emoji durante o processamento. O padrão é false.
Comportamento da referência de resposta: off, first ou all.
Exige um gatilho explícito para responder nos grupos do Telegram.
Porta local de escuta do servidor de webhook.
Token secreto devolvido pelo Telegram em cada atualização. Obrigatório quando TELEGRAM_WEBHOOK_URL está definida.
URL HTTPS pública do modo webhook. Substitui o polling.
Account SID do Twilio, compartilhado com a skill de telefonia.
Auth Token do Twilio, usado também na validação de assinatura do webhook.
Número de telefone do Twilio no formato E.164.
Liga o adaptador de plataforma de webhook.
Porta do servidor HTTP que recebe webhooks.
Segredo HMAC global para validar assinaturas de webhook.
IDs de usuário do WeCom autorizados a falar com o bot.
ID do AI Bot do WeCom no console de administração.
Agent ID do aplicativo próprio.
Libera todos os usuários sem lista de permissão.
IDs de usuário da lista de permissão do callback.
Corp ID da empresa no WeCom para o aplicativo de callback.
Segredo da empresa para o aplicativo próprio.
Chave AES de criptografia do callback.
Endereço de escuta do servidor de callback.
Porta do servidor de callback.
Token de verificação do callback.
ID do chat do WeCom para cron e notificações.
Segredo do AI Bot do WeCom.
URL personalizada do WebSocket do WeCom.
Account ID do Weixin obtido no login por QR code pela iLink Bot API.
Libera todos os usuários do Weixin, sem lista de permissão.
IDs de usuário do Weixin autorizados a falar com o bot em mensagem direta.
Substitui a URL base da iLink Bot API do Weixin.
Substitui a URL base do CDN de mídia do Weixin.
Política de mensagem direta: open, allowlist, pairing ou disabled.
IDs de grupo do Weixin autorizados a interagir com o bot.
Política de mensagem de grupo: open, allowlist ou disabled.
ID do chat do Weixin para cron e notificações.
Nome exibido do canal principal do Weixin.
Token de autenticação do Weixin obtido no login por QR code.
Libera todos os remetentes do WhatsApp, sem lista de permissão.
Números de telefone autorizados, com código do país e sem o sinal de mais. Use asterisco para liberar todos.
Token de acesso da Meta. Tokens temporários expiram em 24 horas. Tokens de usuário do sistema são permanentes.
Libera todos os remetentes do WhatsApp Cloud, sem lista de permissão.
Remetentes autorizados quando dm_policy é allowlist.
wa_ids autorizados a falar com o bot, separados por vírgula.
Versão da Graph API da Meta usada nas chamadas.
App ID da Meta, opcional, para integrações de análise.
Segredo hexadecimal de 32 caracteres usado para validar a assinatura dos webhooks.
Política de mensagem direta do adaptador Cloud: open, allowlist ou disabled.
IDs de grupo autorizados quando group_policy é allowlist.
Política de grupo do adaptador Cloud: open, allowlist ou disabled.
wa_id usado como canal principal do bot, inclusive em tarefas de cron.
Phone Number ID da WhatsApp Business Cloud API, com 15 a 17 dígitos.
Segredo compartilhado na verificação do webhook da Meta.
WABA ID (WhatsApp Business Account ID), opcional. Quando definido, os webhooks recebidos precisam corresponder a ele.
Interface onde o servidor de webhook escuta. O padrão é
0.0.0.0.Caminho da URL para onde a Meta envia as mensagens recebidas. O padrão é
/whatsapp/webhook.Porta do servidor de webhook.
Registra os eventos brutos de mensagem na bridge para diagnóstico.
Liga a bridge do WhatsApp.
JIDs de grupo admitidos quando WHATSAPP_GROUP_POLICY é allowlist.
Política de entrada em grupos: pairing, allowlist, open ou disabled.
ID do chat padrão para cron e notificações.
Nome exibido do canal principal do WhatsApp.
Modo de operação: bot, com número separado, ou self-chat, conversando com o próprio número.