Conecte o Matrix ao WhatsApp, Telegram e Discord com pontes separadas.

Para conectar WhatsApp, Telegram e Discord, execute três pontes separadas, registre cada uma como um serviço de aplicativo e faça login por meio de seu próprio fluxo. O sucesso significa que cada bot reporta uma sessão autenticada e as mensagens de teste trafegam em ambas as direções pelas salas do portal; um bot simplesmente aparecer online não é suficiente.

Este recurso destina-se a administradores de servidores domésticos que permitem serviços de aplicativos. Não é possível adicionar uma ponte auto-hospedada ao matrix.org, a menos que os administradores a disponibilizem; utilize um servidor sob seu controle ou uma ponte hospedada disponível. A documentação do projeto foi verificada em 10 de outubro de 2026.

1. Decida a que você está se conectando e prepare o servidor.

São três serviços distintos, cada um com sua própria configuração, registro, banco de dados e login. O Mautrix utiliza principalmente o recurso de "puppeting": as mensagens trafegam por meio da sua conta remota vinculada e aparecem no Matrix como se fossem dessa conta. Um bot de retransmissão funciona de forma diferente; escolha-o apenas se desejar uma identidade de bot compartilhada em vez da sua conta pessoal.

Você precisa de um servidor doméstico com capacidade para executar serviços de aplicativos, acesso administrativo e conectividade de rede para cada bridge. O Docker possui documentação. Atribua a cada bridge seu próprio diretório de dados e escolha uma tag de versão com suporte; mautrix observa que isso latestpode rastrear o commit mais recente em vez de uma versão específica.

Utilize um banco de dados separado para cada ponte; um servidor PostgreSQL pode ser compartilhado, mas o próprio banco de dados não deve ser compartilhado com outra ponte ou com o Synapse. O SQLite é uma opção para instâncias pequenas. Decida sobre a criptografia de ponta a ponta antes do login, pois habilitá-la posteriormente para salas de portal existentes é difícil.

Listagem do diretório do terminal com pastas separadas para mautrix-whatsapp, mautrix-telegram e mautrix-discord, cada uma mostrando sua própria configuração e arquivo de banco de dados.
Antes de iniciar os contêineres, mantenha a configuração e o banco de dados de cada ponte em seu próprio diretório de trabalho.

2. Configure e registre todos os três serviços de aplicação.

  1. Gere a configuração inicial de cada bridge. Siga as instruções da página de configuração do Docker para essa bridge e execute o contêiner uma vez com seu próprio diretório de dados montado. Edite a configuração gerada antes de iniciá-la normalmente. Preencha o domínio e o endereço do servidor principal, o endereço da bridge, o URI do banco de dados e as permissões. Esses valores são específicos para sua implantação; não copie segredos de exemplo para produção.
  2. Use endereços acessíveis pelo contêiner. Quando o Synapse e as bridges compartilham uma rede Docker, o endereço do servidor principal da bridge pode usar o nome do serviço do Synapse, como `< http://synapse:8008nome_do_serviço>`. O endereço do serviço da aplicação deve apontar de volta para o nome do serviço e a porta de escuta dessa bridge. localhostDentro de um contêiner de bridge, o endereço aponta para o próprio contêiner, não para o Synapse ou outra bridge, o que geralmente interrompe a comunicação. Se o servidor principal estiver fora do Docker, publique ou direcione a porta da bridge necessária.
  3. Gere e instale um arquivo de registro por ponte. Execute o comando de configuração de cada ponte para gerar seu arquivo YAML de registro e, em seguida, coloque os três arquivos em um local onde o Synapse possa lê-los. Em homeserver.yaml, adicione seus caminhos em app_service_config_files, por exemplo:
app_service_config_files:
  - /data/appservices/mautrix-whatsapp-registration.yaml
  - /data/appservices/mautrix-telegram-registration.yaml
  - /data/appservices/mautrix-discord-registration.yaml

Se o Synapse estiver sendo executado em um contêiner Docker, monte os arquivos de registro dentro do contêiner. Reinicie o Synapse após editar a lista. Um erro de digitação no YAML, um caminho incorreto, uma montagem ilegível ou um endereço de ponte incompatível podem impedir o registro ou a inicialização do Synapse. Se você alterar as configurações de ponte relacionadas ao registro posteriormente, regenere o arquivo de registro relevante e reinicie o Synapse novamente.

Editor de código mostrando o arquivo homeserver.yaml do Synapse com três caminhos de registro de serviço de aplicativo separados para WhatsApp, Telegram e Discord.
O Synapse precisa de um caminho de registro legível separado para cada ponte, seguido de uma reinicialização do servidor doméstico.
O painel de status do contêiner lista o Synapse e três contêineres de ponte Mautrix em execução em uma rede Matrix compartilhada.
Verifique se o Synapse e todos os três contêineres de ponte estão sendo executados em uma rede onde seus nomes de serviço são resolvidos.

3. Adicione as credenciais específicas do serviço e faça login.

WhatsApp

Inicie o mautrix-whatsapp e abra uma mensagem direta do Matrix com o bot de ponte, geralmente o `mautrix-whatsapp` @whatsappbot:your.server. Envie login qra mensagem e, em seguida, escaneie o código QR na tela de Dispositivos Vinculados do WhatsApp no ​​seu telefone. Aguarde a confirmação de autenticação do bot; a documentação da ponte informa que as salas do portal podem levar cerca de um minuto para aparecer. O WhatsApp é vinculado como um dispositivo, portanto, esta não é uma conta na nuvem independente. A documentação da ponte informa que os dispositivos vinculados se desconectam se o telefone permanecer offline por mais de duas semanas. Se você não puder manter o telefone ativo, considere se esta ponte atende às suas necessidades de confiabilidade antes de depender dela para conversas importantes.

Telegram

Antes de fazer login no Telegram, crie um aplicativo de API em my.telegram.org/apps e insira o valor de `<nome_do_aplicativo>` api_ide o api_hashvalor de `<nome_do_aplicativo>` na configuração do mautrix-telegram. Esses valores de API permitem que a ponte se conecte à API do Telegram; eles não autenticam uma conta do Telegram por si só. Em seguida, envie uma mensagem @telegrambot:your.serverusando login qro código `<nome_do_aplicativo>`, escaneando-o no aplicativo móvel do Telegram em Configurações, Dispositivos e Vincular Dispositivo de Desktop. A opção de código pode ser entregue a uma sessão existente do Telegram em vez de por SMS, e a ponte pode solicitar sua senha de verificação em duas etapas. Verifique as configurações de preenchimento de dados da ponte antes de fazer login, caso a importação de mensagens antigas seja importante; alterar as expectativas depois que as salas do portal forem criadas pode ser tarde demais.

Discord

Para um servidor, use um bot dedicado do Discord, não a automação da sua conta pessoal: o Discord proíbe bots automatizados e pode encerrar contas. Crie um aplicativo e um bot no Portal do Desenvolvedor, habilite apenas as intenções privilegiadas que a ponte exige e que seu aplicativo pode obter e, em seguida, convide-o com o escopo de bot OAuth2 e as permissões mínimas de canal. O acesso às intenções é controlado por políticas; sem o conteúdo da mensagem ou o acesso aos membros necessários, algumas funções podem não funcionar. No Matrix, envie uma mensagem direta @discordbot:your.servere siga as instruções de login do token do bot do mautrix-discord. Um bot não fornece o mesmo acesso a mensagens diretas pessoais que uma ponte de conta de usuário.

Um editor de configuração de ponte exibindo um endereço de serviço Synapse, um endereço de serviço mautrix-whatsapp e um nome de banco de dados de ponte distinto.
Analise o nome do host do serviço, o ouvinte da ponte e os detalhes exclusivos do banco de dados na configuração de cada ponte.

4. Teste a entrega e ajuste apenas o que o resultado mostrar.

Envie uma mensagem direta para cada bot de ponte e confirme o status de autenticação. Em uma sala do portal por serviço, envie uma mensagem de teste do Matrix e responda pelo aplicativo remoto. Verifique se ambas chegam à sala correta. Para grupos ou canais do Discord, primeiro confirme se a conta de ponte está presente e tem permissões de leitura/publicação. Um login bem-sucedido por si só não comprova a entrega.

Se um bot estiver inativo, verifique seus registros em busca de valores ausentes, erros no banco de dados ou problemas de conectividade com o servidor principal. Se o login funcionar, mas as salas não aparecerem, verifique as configurações do portal e do preenchimento automático. Para mensagens ausentes em canais do Discord, verifique a associação do bot, as permissões e o acesso às intenções. Se o Synapse não iniciar, verifique a indentação do YAML e se os arquivos de registro estão legíveis.

O suporte a recursos varia de acordo com a versão da ponte e o tipo de conta; chamadas, reações, chats criptografados, mídia e importação de histórico podem ser diferentes ou não suportados. Verifique a lista de recursos atual de cada ponte antes de utilizá-la como seu único ponto de acesso. Restrinja o acesso a arquivos de registro e credenciais, faça backup dos dados da ponte com segurança e revogue uma sessão ou token vinculado caso seja exposto.

Use as instruções atuais do Docker da Mautrix , o guia de registro , a referência de configuração e as páginas de autenticação do WhatsApp , Telegram e Discord para comandos específicos da versão. Consulte a política de bots autônomos do Discord .

Deixar um comentário

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Aumente o limite de arquivos do Systemd do Synapse sem complicações.

Diagnostique se o Synapse atingiu seu limite de arquivos abertos por processo, configure um comando systemd para o serviço ou worker correto e verifique o limite em tempo real.

O Element exibe a mensagem “Falha ao descriptografar”? Restaure a chave da sala perdida.

O Element exibe a mensagem “Falha ao descriptografar”? Restaure a chave da sala perdida.

Descubra se o erro está limitado a um navegador ou a um evento específico e, em seguida, use a chave de recuperação do Element ou um dispositivo confiável sem arriscar seu histórico criptografado restante.

Limpe mensagens e arquivos de mídia antigos do Synapse sem perder dados.

Utilize as APIs de limpeza de histórico e mídia do Synapse ou as configurações de retenção para remover dados obsoletos com segurança e, em seguida, verifique a conclusão e a recuperação do espaço em disco.

Crie um bot de eco do Matrix em Python com a biblioteca Simple-Matrix-Bot-Lib.

Crie um bot de eco do Matrix em Python com a biblioteca Simple-Matrix-Bot-Lib.

Instale a biblioteca atual, conecte uma conta Matrix dedicada e execute um pequeno bot !echo com gerenciamento de credenciais mais seguro e um teste claro.

Conecte o Matrix ao WhatsApp, Telegram e Discord com pontes separadas.

Conecte o Matrix ao WhatsApp, Telegram e Discord com pontes separadas.

Configure três bridges Mautrix com registros, logins e testes separados — e evite surpresas com a rede Docker, políticas de conta e sincronização.

Recupere espaço em disco do Synapse Media sem afetar os arquivos compartilhados.

Descubra o que está ocupando espaço no armazenamento do Synapse, defina um período seguro de retenção de mídia e limpe o cache remoto sem excluir arquivos diretamente do disco.

Desativar usuários inativos do Matrix sem excluir o histórico da sala.

Desativar usuários inativos do Matrix sem excluir o histórico da sala.

Analise a atividade do dispositivo, desative contas Synapse inativas confirmadas por meio da API de administração e saiba o que a opção de apagar realmente remove.

Reduza a pressão de memória do PostgreSQL no Matrix Synapse

Descubra se a memória usada pelo PostgreSQL provém de consultas, buffers compartilhados, conexões ou manutenção e, em seguida, faça alterações direcionadas e seguras para o Synapse.

Por que as conexões entre salas do Matrix Synapse estão lentas — e o que verificar

Por que as conexões entre salas do Matrix Synapse estão lentas — e o que verificar

Antes de alterar as configurações do Synapse, verifique se a lentidão na entrada de salas Matrix em um servidor remoto, o recuo da federação, a carga do banco de dados local ou a fila de remetentes de saída estão sendo afetados.

Encerrar cadastros na Matrix ou exigir tokens de convite no Synapse

Impeça a criação de contas abertas em um servidor Synapse auto-hospedado ou mantenha os cadastros apenas por convite com tokens de registro de uso limitado.