{"section":"tutorials","requestedLocale":"pt","requestedSlug":"integracao-com-o-microsoft-teams","locale":"pt","slug":"integracao-com-o-microsoft-teams","path":"docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams.md","branch":"main","content":"### Integração com o Microsoft Teams\n\nDevido às recentes atualizações nos serviços da Microsoft Azure, o processo de criação e integração de Bots pelo Portal do Azure passou por diversas modificações, tornando necessário o desenvolvimento de uma nova documentação, atualizada, para a integração com o Microsoft Teams. O objetivo desta documentação é orientar os usuários na criação, implementação e integração do Chatbot no ambiente corporativo, Microsoft Azure e Teams, da Raízen.\n\nAs informações e orientações contidas nesta documentação estão sujeitas a alterações conforme futuras atualizações das plataformas e ferramentas da Microsoft.\n\n#### Etapas para integração do chatbot no Teams\n\n1. Comunicação com a Weni;\n2. Registro do aplicativo no Portal da Azure;\n3. Criação do Bot no Portal do Azure;\n4. Habilitar o Canal de Atendimento do Teams na Weni;\n5. Criação da Aplicação na AppStudio;\n6. Publicar a Aplicação no Teams.\n\n#### 1. Comunicação com a Weni\n\nNo Microsoft Teams, a comunicação do Chatbot com a Weni ocorre pela URL de callback. Essa URL deve ser pega assim que a integração do canal do Teams na plataforma Weni ocorrer.\n\n#### 2. Registro do aplicativo no Portal do Azure\n\nA criação do registro do aplicativo no Portal do Azure deve ser realizada pelo cliente, é recomendado que o usuário tenha *permissões administrativas* para criar o Bot. No Portal do Azure, pesquise por **Registros de aplicativo:**\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_1.png)\n\nNa seção de Registros de aplicativo, selecione **Novo Registro:**\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_2.png)\n\nNa aba de **Registrar um aplicativo**, insira o **Nome do Bot**, e escolha a opção:\n\n• Contas em qualquer diretório organizacional (qualquer locatário do Microsoft Entra ID \\- multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox).\n\nNão é necessário inserir informações no campo de **URI de direcionamento (opcional)**. Após esses passos, realize o registro do aplicativo em \"\"**Registrar**\"\":\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_3.png)\n\nApós a criação do aplicativo, acesse o **Registro de aplicativo** e selecione o aplicativo criado. Em Visão geral, copie o **ID do aplicativo (cliente)**, ele será utilizado para a criação e registro do Bot da Azure.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_4.png)\n\nDentro do aplicativo, selecione **Certificados e segredos**:\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_5.png)\n\nEm **Certificados e segredos**, selecione **Novo segredo do cliente**, insira uma **Descrição** e defina o tempo de expiração (**Expira em**, recomendado: 24 meses), clique em **Adicionar:**\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_6.png)\n\nApós a criação do **Segredos do cliente**, é gerado um **Valor** e um **ID secreto**, essas informações serão utilizadas para habilitar o canal de atendimento na Weni.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_7.png)\n\nOBS: É recomendando salvar o **Valor** e o **ID secreto**, essas informações são sigilosas e não é possível visualizar seus valores após atualização da página.\n\n#### 3. Criação do bot no Portal do Azure\n\nA criação do Bot no Portal do Azure deve ser realizada pelo cliente, é recomendado que o usuário tenha permissões administrativas para criar o Bot.\n\nNo campo de pesquisa da página inicial, pesquise por **Azure bot.**\n\nNa seção **Criar um Bot do Azure**, insira um **Identificador do Bot**, selecione a **Assinatura (Avaliação Gratuita)** ou outra de sua opção, também será necessário criar um **Grupo de recursos.** No campo **Novo local do grupo de recursos**, selecione a região **Sul do Brasil**. Altere o **Tipo de preço**, para **Free**, conforme imagem:\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_8.png)\n\nNa etapa da **Microsoft App ID**, selecione **Usar registro de aplicativo existente**:\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_9.png)\n\nEm **ID do aplicativo**, insira o **ID do aplicativo (cliente)**.\n\nApós inserir a **ID do aplicativo**, clique em **Examinar \\+ criar**, após a Azure examinar as credenciais da App ID, clique em **Criar**, conforme imagem:\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_10.png)\n\nCom a implementação do Bot concluída, podemos acessar os recursos (**Ir para o recurso**) e alterar alguns parâmetros importantes do Bot, como: Nome, ícone e descrição.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_11.png)\n\nDentro do Bot, selecione **Perfil de Bot**, escolha um ícone, e o **Nome de exibição** do Bot para os usuários, clique em **Aplicar**.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_12.png)\n\nEm **Configuração**, insira a URL de call-back fornecida pela equipe de Onboarding no **Ponto de extremidade de mensagens**, e clique em **Aplicar**, conforme imagem de exemplo:\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_13.png)\n\nEm **Canais**, adicione o canal do **Microsoft Teams**, depois clique em Salvar:\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_14.png)\n\nUm pop-up sobre os **Termos do Serviço** da Microsoft deve aparecer, com os **Termos de Publicação dos Canais da Microsoft** e **Políticas de Privacidade da Microsoft,** contendo informações de interesse para a equipe de Segurança da Informação.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_15.png)\n\n#### 4. Criação da aplicação na app\n\nNo momento, o usuário apenas consegue interagir com o Chatbot através do **Link para divulgação do Bot**, para que o Chatbot fique disponível para todos os usuários no Teams é Interno necessário a criação do Aplicativo, através do **Portal de desenvolvimento ou Developer Tools** em inglês.\n\nTemos dois passos: **Portal de Desenvolvimento no Microsoft Teams e Microsoft Teams Admin Center**:\n\n• Portal de Desenvolvimento \\= https://teams.microsoft.com ou no aplicativo do Teams\n\n• Microsoft Teams Admin Center \\= https://admin.teams.microsoft.com/dashboard\n\n##### 4.1 Portal do desenvolvimento\n\nPara criar a app utilizando o **Portal do Desenvolvimento**, é necessário seguir os seguintes passos:\n\n1º \\- Acesse o Portal do Desenvolvedor, digitando (Portal de desenvolvimento) no campo pesquisar.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_16.png)\n\n2º Clique em Aplicativos.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_17.png)\n\n3º Clique em \\+NOVO APLICATIVO\n\n4º Abrirá um pop-up para Adiconar o nome do APP.\n\nEsse nome definirá o nome do Chatbot/assistente virtual, após insierir, clique em adicionar.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_18.png)\n\n###### 4.1.1 Informação básica\n\nApós adicionar o nome do Bot, abrirá uma sessão para configuração denominada: Informação Básica.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_19.png)\n\nPreencha o campo **Breve descrição**. Você pode usar o exemplo a seguir: (ex: AssistenteVirtual)\n\n• Preencha o campo **Descrição longa**. Você pode usar o exemplo a seguir: (ex: AssistenteVirtual)\n\n• Preencha o campo **Nome do desenvolvedor ou empresa**. Você pode usar o exemplo a seguir ou se preferir usar o nome da sua empresa: (Raízen)\n\n• Preencha o campo **Site**. Você pode usar o exemplo a seguir ou se preferir usar o site da sua empresa: (https://www.raizen.com.br/)\n\n• Preencha o campo **Política de privacidade**. Você pode usar o exemplo a seguir ou se preferir, usar a política da sua empresa: (**ex**: https://raizen.com/sobre-araizen/politicas-e-procedimentos)\n\n• Preencha o campo **Termos de uso**. Você pode usar o exemplo a seguir ou se preferir, usar o Termo de uso da sua empresa: (https://raizen.com/sobre-a-raizen/politicas-eprocedimentos)\n\n• Preencha o campo **ID do Aplicativo (cliente)**. Esse campo ID do Aplicativo, deve ser preenchido com o **ID do Aplicativo criado na AZURE**. Com esse ID, o aplicativo do Teams integra com o aplicativo do Azue. A imagem a seguir representa a inserção dessa informação.\n\nA imagem a seguir representa a inserção dessa informação.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_20.png)\n\nApós o preenchimento das informações básicas, clique em **salvar**. Em seguida, deve-se configurar algumas informações localizadas abaixo do nome do BOT. Iniciando na aba **Configurar**, onde temos os seguintes pontos.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_21.png)\n\n###### 4.1.2 Marca\n\nPara inserir a Imagem da persona do Bot, clique em Marca, onde abrirá um pop-up para fazer upload das imagens do Bot, o qual tem que obedecer as especificações de tamanho.\n\n###### 4.1.3 Recursos do aplicativo\n\nApós inserir as imagens, clique em **Recursos do aplicativo** e em seguida **Bot**.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_22.png)\n\nEm seguida, será aberta uma tela para configuração de alguns parâmetros do Bot.\n\nNo campo (**Identificar seu bot**), clique em **Insira um ID de bot** e em seguinda preencha com o ID do Aplicativo criado no passo **2 \\- Registro do aplicativo no Portal do Azure**. Os demais campos devem ser selecionados seguindo os exemplos do print da imagem abaixo.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_23.png)\n\nAo concluir as configurações, clique em **Salvar**.\n\n#### 5. Publicar a aplicação no Teams\n\nClique no botão publicar.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_24.png)\n\nAo clicarmos em publicar, abrirá um pop-up \\- (**Publicar seu aplicativo**) Clique na opção (**Publicar para sua organização**)\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_25.png)\n\nApós clicar, abrirá uma janela semelhante à da figura abaixo. Clique no botão **Publicar seu aplicativo.**\n\nLogo em seguida, aparecerá uma mensagem notificando que a **publicação foi enviada** para aprovação.\n\n**O App será enviada para aprovação**, **caso seja aprovado**, estará disponível para os usuários Teams da empresa.\n\n#### 6. Realizar a aprovação da publicação do app no Teams\n\nPara aprovar a App, acesse: https://admin.teams.microsoft.com/dashboard, em seguida, clique em Teams apps.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_26.png)\n\nEm seguida clique em Manage apps. Após isso, deve-se clicar em Search by name.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_27.png)\n\nInserir o nome do Bot que foi criado, conforme exemplo abaixo para a realização do filtro. Em seguida, Clique no nome do BOT.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_28.png)\n\nA tela seguinte será para publicar a App. Clique em **Publish**.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_29.png)\n\nUm pop-up de confirmação aparecerá na tela, clique em **Publish** novamente.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_30.png)\n\nApós o procedimento, a informação sobre **pendentes para aprovação** fica zerada.\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_31.png)\n\nAgora o App está disponível para todos os usuários Teams do ambiente do cliente. Para acessar o aplicativo e começar a conversar com o Chatbot, procure o Catálogo de Aplicativos do Microsoft Teams na barra lateral.\n\nSelecione **Feito para sua organização** e clique em **Adicionar**:\n\n![](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/weni-by-vtex/integrações/integracao-com-o-microsoft-teams_32.png)"}