Início
» Como fazer
»
Conecte o Matrix ao WhatsApp, Telegram e Discord com pontes separadas.
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.
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.
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.
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.
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:
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.
O Synapse precisa de um caminho de registro legível separado para cada ponte, seguido de uma reinicialização do servidor doméstico.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.
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.