Precisa montar deep links no New Teams mas a URL não mostra mais o identificador do chat? Este guia prático ensina, passo a passo e sem PowerShell, como descobrir o Chat ID de conversas privadas e de grupo usando opções nativas, Power Automate e DevTools.
Visão geral e por que isso importa
O Chat ID é o identificador único de cada conversa no Microsoft Teams (conversas privadas ou em grupo). Ele é necessário para tarefas como compor deep links reutilizáveis, automatizar notificações, indexar conversas em uma base de referência ou mesmo documentar onde decisões foram tomadas. No New Teams, a URL da interface já não exibe o ID como antes; e a opção “Copiar link” pode não aparecer no desktop dependendo do tenant, política ou versão. A boa notícia: ainda há formas rápidas e que não exigem privilégios de administrador nem instalação de módulos do PowerShell.
O que mudou no New Teams
Na versão nova do aplicativo, a Microsoft redesenhou menus e rotas de navegação. Em muitos ambientes, a ação “Copiar link” deixou de aparecer ao clicar nos três pontos (mais ações) de uma mensagem no cliente desktop, embora alguns usuários ainda a vejam no Teams na Web. Isso não significa que o Chat ID sumiu: ele continua presente no link da mensagem, nos metadados carregados pelo cliente e disponível via conectores como o Power Automate.
Estado do problema
- A ação “Copiar link” existiu, mas pode não aparecer no desktop para parte dos usuários.
- No Teams na Web, vários relatos indicam que a opção ainda surge em chats. Se surgir no seu ambiente, é o caminho mais rápido.
- Todos os métodos abaixo funcionam com permissões de usuário padrão, sem precisar instalar ou usar PowerShell.
Métodos que funcionam hoje sem PowerShell
Copiar link de uma mensagem
Se a opção estiver disponível no seu cliente:
- Abra o chat desejado e passe o mouse sobre qualquer mensagem.
- Clique em … (Mais ações) → Copiar link.
- Cole o link em um editor de texto. Você verá o Chat ID embutido.
O identificador costuma vir logo após /message/
e começa com 19:
. Às vezes aparece codificado como 19%3A
(o %3A
é apenas o caractere :
codificado).
Exemplo de link de mensagem (encurtado):
https://teams.microsoft.com/l/message/19%3AabcDEFghiJKLmnop%40unq.gbl.spaces/1700000000000?tenantId=...
O Chat ID aqui é:
19:abcDEFghiJKLmnop@unq.gbl.spaces
Dica de decodificação rápida: troque manualmente %3A
por :
e %40
por @
. Se preferir automatizar, veja exemplos de URL decode mais adiante.
Power Automate com a ação de postagem
Método prático para descobrir o ID de um chat específico sem enviar nada de fato (basta preparar a ação e olhar o código):
- Acesse o Power Automate e crie ou edite um fluxo rascunho.
- Adicione a ação Post message in a chat or channel do conector Microsoft Teams e conecte sua conta.
- No campo de destinatário, selecione o chat desejado no dropdown.
- Alterne para Code View (Exibição de código).
- No JSON exibido, localize o campo que representa o destinatário do chat (geralmente
body/recipient
ou similar). O valor é o Chat ID.
Trecho típico do Code View (exemplo ilustrativo):
{
"body": {
"recipient": "19:abcDEFghiJKLmnop@unq.gbl.spaces",
"message": "Teste"
}
}
Você pode excluir o fluxo em seguida; a ação serviu apenas para revelar o identificador.
Power Automate para listar vários chats automaticamente
Se precisa registrar muitos IDs de uma vez com o mínimo de cliques, crie um fluxo que capture metadados do chat assim que você interagir com ele e grave em uma planilha ou lista.
- Crie um fluxo com um gatilho de mensagem do Teams que você possa disparar manualmente em conversas.
- Para cada evento, grave em SharePoint/Excel/Dataverse o Nome do chat, o Chat ID e um deep link pronto para uso.
- Depois de passar pelos chats relevantes, você terá um cadastro completo de IDs e links reutilizáveis.
Modelo de colunas sugeridas:
Nome do chat | Chat ID | Deep link | Observações |
---|---|---|---|
Projeto Alfa | 19:abcDEFghiJKLmnop@unq.gbl.spaces | Link de mensagem copiado ou link do chat | Grupo do projeto |
Financeiro & Compras | 19:qrstUVWxYz123456@unq.gbl.spaces | Link de mensagem do anúncio | Chat com fornecedores |
Inspeção pelo navegador com DevTools
Funciona bem quando você usa o Teams no navegador e quer extrair o ID diretamente do DOM.
- Abra o Teams no navegador.
- Clique com o botão direito em qualquer área e escolha Inspecionar para abrir o DevTools.
- Ative o seletor de elementos e clique no chat desejado na barra lateral.
- No painel de elementos, observe o contêiner selecionado: frequentemente há um atributo ou id que inclui o Chat ID no formato
19:…
.
Se preferir, use a aba Network e filtre por “message” ou “chat”; muitas chamadas incluem o 19:…
nos valores de payload.
Uso do Teams na Web
Mesmo quando a opção sumiu no desktop, vários ambientes ainda exibem “Copiar link” no Teams na Web. Se aparecer, use-a para capturar a URL da mensagem e extrair o Chat ID como mostrado acima.
Padrões do Chat ID e decodificação de URL
Compreender o formato do ID ajuda a reconhecer o que é um chat e o que é um canal.
Tipo | Padrão típico | Observações |
---|---|---|
Chat privado ou em grupo | 19:<hash>@unq.gbl.spaces | Quase sempre começa com 19:. O sufixo @unq.gbl.spaces é comum. |
Canal | Não usa Chat ID | Deep link para canal usa teamId e channelId, não o 19:. |
Se o ID vier codificado na URL, basta decodificar:
19%3AabcDEF%40unq.gbl.spaces → 19:abcDEF@unq.gbl.spaces
Exemplos de URL decode rápidos:
// JavaScript (console do navegador)
decodeURIComponent("19%3AabcDEF%40unq.gbl.spaces");
// → "19:abcDEF@unq.gbl.spaces"
// PowerShell (quando disponível)
\[System.Web.HttpUtility]::UrlDecode("19%3AabcDEF%40unq.gbl.spaces")
// → 19\:abcDEF\@unq.gbl.spaces
Como gerar e usar deep links
Na prática, há duas rotas úteis:
- Guardar o link da mensagem (copiado do chat): ele já abre a conversa exatamente naquele ponto. É a saída mais confiável e rápida.
- Salvar a dupla “Nome do chat + Chat ID”: permite produzir referências internas, planilhas e automações que apontem para o chat. Quando você precisar, recupere o link de qualquer mensagem do mesmo chat ou gere links específicos no Power Automate.
Modelo didático de link de mensagem de chat (simplificado para estudo):
https://teams.microsoft.com/l/message/19%3A<ChatIdCodificado>/<Timestamp>?tenantId=<Tenant>&allowXTenantAccess=false
Importante: copiar o link de uma mensagem é suficiente para navegação. Se seu objetivo é apenas abrir aquele chat, não há necessidade de montar a URL manualmente.
Comparativo rápido dos métodos
Método | Permissões | Onde fazer | Velocidade | Prós | Contras |
---|---|---|---|---|---|
Copiar link de mensagem | Usuário padrão | Desktop ou Web | Muito alta | Um clique, ID já no link | Depende da opção aparecer |
Power Automate, Code View | Usuário padrão | Navegador | Alta | Confiável, sem enviar a mensagem | Precisa criar um fluxo rascunho |
Power Automate, lista de chats | Usuário padrão | Navegador | Muito alta para grandes volumes | Cria um cadastro completo | Requer configurar persistência |
DevTools no navegador | Usuário padrão | Navegador | Média | Independe da UI do Teams | Exige familiaridade com DOM/Network |
Teams na Web | Usuário padrão | Navegador | Alta | Menu “Copiar link” costuma voltar | Comportamento pode variar por tenant |
Erros comuns e como evitar
- Confundir chat com canal: canais usam teamId/channelId, não o 19:. Se o seu link contém
channelId=
, você não está em um chat privado. - Usar o ID sem decodificar: se o link traz
19%3A…
, decodifique os caracteres percent-encodados para19:…
quando for documentar. - Acreditar que a ausência do menu impede o processo: quando “Copiar link” não aparece, o Power Automate e o DevTools resolvem.
- Ignorar políticas do tenant: alguns ambientes limitam exibição de metadados. Se um método falhar, use alternativas listadas aqui.
Dicas práticas e observações úteis
- Formato típico: chats privados e de grupo começam com
19:
. - IDs codificados:
%3A
é:
,%40
é@
. - Deep link da mensagem: serve como marcador confiável para voltar ao ponto da conversa.
- Sem administrador: todos os métodos descritos exigem permissões padrão de usuário.
- Interface evolui: se a opção sumir no desktop, tente a versão Web, o Power Automate ou o DevTools.
Passo a passo detalhado no Power Automate para catálogo de IDs
Este roteiro cria um cadastro prático de chats em uma lista do SharePoint ou planilha do Excel.
- Estrutura de destino: crie uma lista/planilha com colunas Nome do chat, Chat ID, Deep link, Data de captura, Observações.
- Criar o fluxo: inicie um fluxo a partir de um gatilho relacionado ao Teams (por exemplo, acionado sob demanda).
- Ação de seleção: adicione a ação Post message in a chat or channel apenas para selecionar o chat alvo no dropdown.
- Extrair o ID: alterne para Code View e leia o campo
recipient
. Copie o valor. - Gravar: insira uma ação de gravação que registre o
recipient
, o nome amigável do chat e um deep link (o próprio link de mensagem ou um link operacional que você já tenha). - Repetir: rode o fluxo para cada chat que deseja catalogar. Em poucos minutos, você terá uma base confiável.
Exemplo de construção de link de referência dentro do fluxo (apenas para documentação; use o link real da mensagem sempre que possível):
concat(
'Chat ID: ',
outputs('Acao_Teams').body.recipient,
' | Nome: ',
triggerBody()?['chatDisplayName']
)
Inspeção avançada com DevTools
Ao usar o navegador, você tem duas estratégias principais:
- DOM: selecione o item do chat na barra lateral. O elemento selecionado ou um antepassado costuma conter um atributo com o
19:…
. - Network: filtre chamadas quando abrir o chat. Requests de mensagens e eventos de chat normalmente carregam o ID no corpo da requisição ou no caminho.
Dicas para agilizar:
- Use o atalho de teclado do DevTools para o seletor de elementos e passeie pelos itens até achar o contêiner com o ID.
- Se a resposta vier em JSON, utilize o visualizador do DevTools para buscar por
"19:"
ou por"recipient"
.
Expressões úteis para extrair o ID
Se você tem um link de mensagem e quer apenas o identificador, estas expressões resolvem na maioria dos casos:
// Padrão geral: pega 19: até o primeiro /, ?, & ou fim da string
Regex: (19:[^\/\?&]+)
// Em links codificados:
Regex: (19%3A\[^/?&]+)
// Extração em JavaScript:
const url = '[https://teams.microsoft.com/l/message/19%3Aabc123%40unq.gbl.spaces/1700](https://teams.microsoft.com/l/message/19%3Aabc123%40unq.gbl.spaces/1700)?...';
const encodedId = (url.match(/19%3A\[^/?&]+/)||\[])\[0];
const chatId = decodeURIComponent(encodedId); // 19\:abc123\@unq.gbl.spaces
Boas práticas de organização
- Padronize um repositório: mantenha a planilha ou lista com Chat ID, nome do chat e um link de referência.
- Contexto primeiro: quando registrar um link, anote também por que aquele chat importa (ex.: decisões de projeto, fornecedores, time X).
- Validade: revise periodicamente, pois nomes de chats podem mudar. O ID permanece estável, mas sua classificação pode evoluir.
- Privacidade: evite expor IDs e links fora do círculo que precisa deles, já que podem apontar para conversas sensíveis.
Perguntas frequentes
É possível obter o Chat ID sem abrir o chat?
Em geral, você precisa ter ao menos uma interação com o chat para capturar o link de uma mensagem, selecionar no Power Automate ou observar o carregamento no cliente Web.
Funciona para conversas com usuários externos?
Sim, desde que a conversa exista no seu cliente e as políticas do tenant permitam as operações citadas.
Serve para canais de equipe?
Para canais, utilize teamId e channelId. O Chat ID (o que começa com 19:
) é típico de conversas privadas ou em grupo.
Preciso mesmo de deep link?
Se sua meta é somente voltar ao chat, guardar qualquer link de mensagem daquele chat basta. O link já abrirá o chat no ponto exato.
Fluxo de trabalho recomendado
- Tente a opção “Copiar link” no Teams na Web. Se aparecer, copie e extraia o
19:…
. - Se não estiver disponível, use o Power Automate para selecionar o chat na ação de postagem e leia o
recipient
no Code View. - Se preferir investigar, utilize o DevTools no navegador.
- Para volume, monte um fluxo que registre automaticamente Nome do chat + Chat ID + deep link em SharePoint/Excel.
Checklist final
- Conseguiu um link de mensagem? Procure por
/message/19%3A
e decodifique. - Sem link? Selecione o chat em uma ação do Teams no Power Automate e confira o
recipient
no código. - Precisa de muitos IDs? Implante o fluxo de catálogo e gere a base em lote.
- Lembre-se: canais não usam Chat ID.
Escolha rápida
Poucos chats e pressa: tente o Teams na Web → Copiar link. Se não aparecer, abra o Power Automate e use a Code View para ler o recipient
.
Muitos chats de uma vez: crie um fluxo que grave Nome do chat, Chat ID e Deep link em SharePoint/Excel. Em minutos você terá um catálogo pronto.
Exemplos completos para referência
Exemplo de link de mensagem de chat (trecho reduzido para clareza):
https://teams.microsoft.com/l/message/19%3AabcDEFghiJKLmnop%40unq.gbl.spaces/1700000000000
?tenantId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
&allowXTenantAccess=false
Exemplo de registro na planilha:
| Nome do chat | Chat ID | Deep link |
|-----------------------|---------------------------------------|--------------------------------|
| Projeto Alfa | 19:abcDEFghiJKLmnop@unq.gbl.spaces | Link de mensagem do kickoff |
| Financeiro & Compras | 19:qrstUVWxYz123456@unq.gbl.spaces | Link do alerta de orçamento |
Conclusão
Embora o New Teams não exiba mais o Chat ID na URL e a ação “Copiar link” possa variar por ambiente, existem métodos simples e confiáveis para obter esse identificador sem PowerShell ou permissões elevadas. No dia a dia, a forma mais rápida é copiar o link de qualquer mensagem e extrair o 19:…
. Quando a UI não ajuda, o Power Automate revela o ID no Code View em segundos; para grandes volumes, um fluxo de catálogo cria sua base de IDs e links automaticamente. Se preferir investigar manualmente, o DevTools do navegador mostra o identificador no DOM ou nas requisições. Com essas abordagens, você padroniza referências, acelera navegação e documenta conversas de forma organizada e segura.