WebChat para Microsoft Teams — o guia completo
Este guia acompanha você por todo o WebChat: da instalação no Microsoft Teams à abertura e ao teste no backend e à configuração dos canais de entrada — widget do site, WhatsApp, Instagram — até a sua própria IA com Azure AI Foundry e Power Automate. Cada canal chega em tempo real ao canal certo do Microsoft Teams. Pay per Channel, configurado em minutos.
▶Veja tudo sobre o WebChat neste vídeo (12 min)Como o WebChat funciona: uma solicitação pelo widget do site é roteada para o canal certo do Microsoft Teams — os dois lados mostram a mesma conversa, a equipe responde com “@WebChat …” direto do Microsoft Teams.
Três blocos, uma plataforma
O WebChat traz todos os canais para o Microsoft Teams. Opcionalmente, adicione a sua própria IA — orquestrada pelo Power Automate, respondida por um agente do Foundry.
Três fases até um WebChat produtivo
1WebChat & Microsoft Teams
- Adicionar o WebChat no Microsoft Teams
- Abrir e testar o backend
- Configurar o WebChat
- Liberar mais administradores
- Solução de problemas
2Configurar canais de entrada
WebChat & Microsoft Teams
Instalar, testar no backend, configurar e liberar administradores.
Adicionar o WebChat no Microsoft Teams
Você pode procurar o WebChat diretamente no Microsoft Teams em “Aplicativos” — ou pelo Microsoft Marketplace. Em seguida, o app é atribuído ao canal desejado.
Procurar “WebChat” no Microsoft Marketplace
Ou abra diretamente o item webch.at/webchat diretamente. Cobrança Pay per Channel em vez de por usuário.
Instalar o app no Microsoft Teams
Na página de detalhes do app no Microsoft Teams, selecione “Adicionar”.
A página de detalhes do app WebChat no Microsoft Teams.
Selecionar um canal
Escolha o canal do Microsoft Teams onde as solicitações de clientes devem chegar.
Escolher o canal de destino para as solicitações recebidas.
O WebChat se anuncia no canal do Microsoft Teams
Após a instalação, o WebChat publica automaticamente sua primeira mensagem no canal escolhido — com um cartão de configuração e um botão “Configurar”.
Após a instalação, o WebChat se anuncia pela primeira vez no canal do Microsoft Teams (recriação).
Abrir e testar o backend
Você gerencia canais e configurações no backend do WebChat — conectado via Microsoft Entra (SSO). Teste o percurso completo até o Microsoft Teams e de volta.
Abrir o backend via SSO
webchat.inwebco.com — login via Microsoft Entra, sem credenciais separadas.
Selecionar um canal — você cai direto na aba LiveTest
Abra na lista de canais o que você acabou de criar no Microsoft Teams. Você cai direto na aba “LiveTest” — no canto inferior direito está o seu widget, pelo qual pode enviar uma mensagem de cliente de teste a qualquer momento. Basta preencher o formulário, clicar em “Iniciar chat” e escrever a primeira mensagem.
Após selecionar o canal, a aba “LiveTest” abre direto (backend, visão desktop).
Alternar para o Microsoft Teams
Envie uma mensagem de teste no LiveTest e alterne para o Microsoft Teams: a solicitação aparece em tempo real como thread no canal, incluindo um cartão de contato. Com “@WebChat message …” você responde ao cliente; sem menção, permanece comunicação interna.
No Microsoft Teams: a solicitação como thread — respondida com “@WebChat message …”.
De volta no LiveTest: a resposta chegou
A resposta do Microsoft Teams aparece na aba “LiveTest” — o percurso completo (cliente → Microsoft Teams → resposta) funciona.
A resposta do Microsoft Teams chegou ao chat do LiveTest.
Configurar o WebChat
Na aba “Configuração” você ajusta a aparência e o comportamento do widget. O canal já está ativo — cada ajuste aparece na hora no LiveTest.
A aba “Configuração” no backend — todas as configurações do canal num só lugar.
Trecho das configurações em detalhe
Modo e cores determinam a aparência do widget, Quick-Replies oferecem respostas rápidas na primeira mensagem, Indicador de digitação e inatividade mantêm a conversa viva, e o formulário inicial coleta dados de contato antes do primeiro contato.
Modo e cores
Quick-Reply-Buttons
Visibilidade do indicador de digitação
Campo do formulário inicial
Textos e remetente
Fonte
Liberar mais administradores
Por padrão, apenas a pessoa que configurou o WebChat pode alterar configurações. Adicione mais administradores na aba “Admin”.
A aba “Admin” no backend com a lista de administradores e “Adicionar admin”.
Em “Adicionar admin” insira um endereço de e-mail e salve — a pessoa deve ser membro do canal do Microsoft Teams (acesso via Entra) e poderá então alterar as configurações deste canal.
Solução de problemas
Os obstáculos mais comuns — e como resolvê-los.
Apenas “Solicitar aprovação” em vez de “Adicionar”?
🔒
WebChat
A aprovação pelo administrador no Centro de administração do Microsoft Teams libera o WebChat em toda a empresa.
O login por SSO falha?
Login no backend via Microsoft Entra (logon único).
Mais perguntas
O widget não aparece no site
Verifique se o script está antes da tag body de fechamento e se o canal está em “Ativo” no backend. Se integrado via Google Tag Manager, publique o contêiner.
WhatsApp ou Instagram não conecta
O WhatsApp requer uma conta do WhatsApp Business (Meta); o Instagram, uma conta profissional/comercial vinculada a uma página do Facebook. Conclua totalmente o login guiado na respectiva aba.
O fluxo não salva
Sem uma licença Power Automate Premium, os conectores premium falham. Atribua a licença e salve e publique novamente.
O agente não responde
Verifique se o nome do agente e o número de versão fixo na config do fluxo estão corretos e se a assinatura pay-as-you-go do Azure está ativa.
Mais ajuda e links
Configurar canais de entrada
Conectar o widget do site, o WhatsApp e o Instagram — receber mensagens e responder direto do Microsoft Teams.
Colocar o widget no site
Um único script insere o widget — diretamente no código-fonte ou, sem acesso ao código, pelo Google Tag Manager.
Copiar o código de incorporação
Na aba “Incorporar”, copie o código do script para a área de transferência.
A aba “Incorporar” no backend com “Copiar para a área de transferência”.
Inserir antes do fim do body
Coloque o script logo antes da tag body de fechamento do seu site.
Publicar e carregar
Salve/publique a página — o widget aparece no canto inferior direito.
O widget do WebChat posicionado no canto inferior direito do site.
Alternativa: incorporação pelo Google Tag Manager
Sem acesso ao código-fonte, você insere o script como uma tag HTML personalizada no Google Tag Manager.
Abrir o Google Tag Manager
Acesse tagmanager.google.com e selecione o contêiner do seu site (o contêiner do GTM precisa estar incorporado uma vez no site).
Criar uma nova tag “HTML personalizado”
No Google Tag Manager: “Tags” → “Nova” → escolha o tipo de tag “HTML personalizado” e cole o código de incorporação do WebChat exatamente — incluindo as tags <script>. Mantenha a opção “Oferecer suporte a document.write” desativada.
Criar um acionador “Visualização de página” e atribuí-lo à tag
No Tag Manager, em “Acionadores”, crie um acionador do tipo “Visualização de página” e atribua-o à tag HTML personalizada. “Todas as páginas” carrega o widget em todo o site; ou direcione-o com uma condição — p. ex. “A URL da página contém /contato”: então todas as subpáginas desse caminho recebem exatamente este widget.
Visualizar, testar e publicar
Use “Visualizar” para verificar se o widget carrega na página. Depois “Enviar” → “Publicar” — o widget está no ar, sem alterar o código-fonte do site.
Conectar e configurar o WhatsApp
Na aba “WhatsApp Business” você conecta a sua conta do WhatsApp Business (Meta) por um login guiado.
Abrir a aba “WhatsApp Business”
No backend do canal desejado, abra a aba “WhatsApp Business”.
A aba “WhatsApp Business” no backend (visão desktop).
Entrar com o Facebook
Conexão pelo WhatsApp Business Manager (Meta). É necessária uma conta do WhatsApp Business. O pop-up que aparece é um processo definido pela Meta — basta seguir os passos na janela.
Verificar e registrar o número
Fluxo guiado: login → verificação → registro → conectado. Para a verificação você recebe uma ligação com um código. Depois, o número, o link de compartilhamento e o QR code ficam prontos (veja a aba acima).
Configurar
Ajuste o nome, o número e o botão “Chat on WhatsApp” na área de configuração.
Escrever uma mensagem no WhatsApp, responder do Microsoft Teams
Assim que conectado: escaneie o QR code gerado, o WhatsApp abre e você pode escrever uma mensagem na hora — ela chega em tempo real ao canal certo do Microsoft Teams.
Uma solicitação pelo WhatsApp é roteada automaticamente para o canal certo do Microsoft Teams — a equipe responde ao cliente com “@WebChat …”.
Conectar o Instagram
Na aba “Instagram” você vincula uma conta profissional/comercial do Instagram.
Abrir o Instagram no navegador e entrar
Entre no navegador com o perfil desejado.
Abrir a aba “Instagram Business” e clicar em “Conectar”
No backend do canal desejado, abra a aba “Instagram Business” e clique em “Conectar” — o login da Meta é iniciado.
A aba “Instagram Business” no backend (visão desktop).
Vincular e confirmar a conta
Confirme o acesso no diálogo da Meta — o WebChat recebe um token de acesso e mostra a conta conectada.
O token permanece válido
O token é renovado automaticamente enquanto a conta permanecer conectada.
Receber um DM do Instagram, responder do Microsoft Teams
Um DM do Instagram (p. ex. reação a um anúncio) chega ao canal de Marketing — respondido diretamente do Microsoft Teams.
Configurar a sua própria IA
Criar um agente do Foundry, controlá-lo pelo Power Automate e testá-lo em todos os canais.
Criar um agente de IA
A IA roda como agente próprio no seu tenant (ai.azure.com): criar um projeto, criar um agente de prompt com um modelo, adicionar a pesquisa na web como grounding, publicar.
Criar um projeto
No menu de projetos do Foundry, crie um novo projeto (ou abra um existente).
Criar um agente
Crie um agente de prompt e escolha um modelo. Recomendamos um agente próprio por canal.
Microsoft Foundry — a visão geral dos agentes.
Definir o prompt do sistema
Defina papel, tom e regras de escalonamento — p. ex. “Você é o agente de suporte da empresa X, responda com cordialidade; escale para a equipe em caso de intenção de compra ou reclamação.”
Grounding: ativar a pesquisa na web
Adicione a pesquisa na web como grounding e insira os domínios/URLs permitidos (p. ex. webchat.cloud) para que o agente responda somente a partir das suas fontes — não do conhecimento geral do modelo.
O diálogo “Adicionar ferramenta de pesquisa na web”: conectar a Pesquisa Bing personalizada aos seus domínios (nomes de exemplo neutros).
Conectar arquivos de conhecimento
Adicione os seus próprios documentos (PDF, FAQ, listas de preços) como armazenamento vetorial. Quanto mais restrito o grounding, mais precisas e comprováveis as respostas — o agente cita as fontes.
Testar no playground
Antes de publicar: experimente o agente direto no playground do Foundry e verifique como ele responde — ajuste prompt, grounding e tom.
O agente no playground do Foundry: envie solicitações de teste, verifique respostas e fontes.
Publicar e anotar nome/versão
Salve e publique o agente. Anote o nome do agente e a versão publicada — você precisa de ambos na parte 10 para o fluxo do Power Automate. Use sempre um número de versão fixo, não “latest”.
Configurar o fluxo de controle
make.powerautomate.com — crie as conexões, defina o acionador por palavra-chave, cole o código do fluxo como escopo e insira a config do agente.
Criar as conexões
Crie Microsoft Teams, Content Conversion e Azure AI Agent Service. Você obtém o endpoint do Azure AI Agent Service no Foundry pelo menu do projeto → “Detalhes do projeto”.
As três conexões no Power Automate: Microsoft Teams ([email protected] — o WebChat publica com este usuário no Microsoft Teams), WebChat-Foundry-Agents (Azure AI Foundry Agent Service — endpoint dos detalhes do projeto no Foundry) e Content Conversion.
No Foundry, em “Detalhes do projeto”, estão o endpoint do projeto e a região — insira-os na conexão do Azure AI Agent Service.
Configurar o acionador por palavra-chave
“Quando palavras-chave são mencionadas” no canal de destino. Por padrão, o WebChat envia a palavra-chave pp — não a remova. Para personalizá-la, defina um valor próprio na aba de backend “Power Platform” e insira exatamente esse valor aqui como palavra-chave. A palavra-chave é enviada mesmo quando você desativa a exibição dela — assim não aparece em cada mensagem. No início, a exibição fica ativada de propósito para o mecanismo ficar visível.
Acionador “When keywords are mentioned”: Message type = Channel, escolha a entrada Team e Channels item e defina a palavra-chave (padrão “pp”).
A palavra-chave do acionador (padrão “pp”) pode ser ajustada na aba de backend “Power Platform”.
Colar o código do fluxo
Copie o código de fluxo preparado de webch.at/json. No designer, abaixo do acionador, clique com o botão direito no “+” para inserir uma nova ação e use “Minha área de transferência” para colar o escopo copiado — todo o fluxo (condição → agente de IA → Adaptive Card) é inserido junto. Depois atribua a cada ação a conexão correspondente.
Primeiro baixe/copie o JSON de webch.at/json. Depois, abaixo do acionador, clique em “+” (ou botão direito) → “Colar” para inserir o escopo completo.
Inserir a config do agente
Na ação Inicializar variável, insira Config_agent_name e Config_agent_version da parte 9 (número de versão fixo, não “latest”). Adicione mais nós via “+” ou botão direito → “Adicionar ação” (p. ex. lembrete, escalonamento, menção de hot-lead). Por fim, salve e publique.
Testar: iniciar uma conversa no LiveTest
Inicie uma conversa de teste na aba “LiveTest” — o agente de IA responde automaticamente. A mesma conversa aparece no canal do Microsoft Teams, onde a equipe pode assumir a qualquer momento.
LiveTest: o visitante pergunta — o agente de IA (Foundry) responde em tempo real.
A mesma conversa ocorre no canal do Microsoft Teams “Support” — o agente de IA responde via @WebChat, a equipe pode assumir a qualquer momento.
Opcional: dados ao vivo como Adaptive Card
Opcionalmente, você pode criar mais Adaptive Cards no Power Automate e incorporá-los à conversa — para oferecer ao agente informações internas, dados ao vivo de CRM/ERP ou outros fluxos de trabalho direto no canal do Microsoft Teams.
Testar o agente em todas as fontes
Um agente, todos os canais: dispare solicitações pelo widget, WhatsApp e Instagram e verifique o comportamento no Microsoft Teams um a um.
Exemplos: escalonamento, hot-lead e controle do bot
Esses comportamentos são configurados pelas variáveis de config do workflow no Power Automate (parte 10) — p. ex. intervalo de lembrete, menção de escalonamento e detecção de hot-lead.
WebChatEscalonamentoWebChatHot-leadWebChatLembreteControle do chatbotAlternável por conversa (human-in-the-loop)Checklist
- ✓Resposta: envie uma mensagem de cliente de teste → o agente responde no canal.
- ✓Escalonamento: a transferência é informada à equipe, o bot é desativado, cartão de ativação + lembrete publicados.
- ✓Reativar: ligue o bot novamente pelo cartão de ativação.
- ✓Hot-lead: teste a intenção de compra → menção à equipe + alerta de lead, o bot permanece ativo.
- ✓Teste de concorrência: várias mensagens em rápida sucessão → vem uma resposta, sem respostas múltiplas.
Um chatbot de suporte com IA para o Microsoft Teams — sem uma segunda caixa de entrada
O WebChat leva em tempo real as solicitações do WhatsApp, Instagram, TikTok e do widget do site ao canal certo do Microsoft Teams. O roteamento inteligente atribui automaticamente cada solicitação ao departamento responsável — produto ao suporte, carreiras ao RH, campanhas ao marketing. Sem troca de ferramenta, sem segundo login, sem segunda caixa de entrada.
A IA roda como agente do Azure AI Foundry próprio no seu tenant: sem dependência de fornecedor, total rastreabilidade pelos logs de auditoria da Microsoft e human-in-the-loop. O Power Automate orquestra respostas, escalonamento e lembretes; os Adaptive Cards mostram dados ao vivo de CRM e ERP direto no chat. Permissões e identidades vêm inteiramente do Microsoft Entra.
O WebChat é instalado como qualquer app do Microsoft Teams direto do Microsoft Teams ou do Microsoft Marketplace, e cobrado Pay per Channel em vez de por usuário — com usuários ilimitados por canal. A configuração básica fica pronta em menos de dez minutos; o chatbot de IA você adiciona depois via Foundry e Power Automate. Todos os preços em webch.at/precos.
