{"section":"tutorials","requestedLocale":"pt","requestedSlug":"integracao-com-o-microsoft-teams","locale":"pt","slug":"integracao-com-o-microsoft-teams","path":"docs/pt/tutorials/vtex-cx-platform/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 o VTEX CX Platform\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 no VTEX CX Platform\n5. Criação da Aplicação na AppStudio;\n6. Publicar a Aplicação no Teams.\n\n### 1. Comunicação com o VTEX CX Platform\n\nNo Microsoft Teams, a comunicação do Chatbot com o VTEX CX Platformpela URL de callback. Essa URL deve ser pega assim que a integração do canal do Teams no VTEX CX VTEX CX Platform\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\nNa seção de Registros de aplicativo, selecione **Novo Registro:**\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\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\nDentro do aplicativo, selecione **Certificados e segredos**:\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\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 no VTEX CX Platform\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**.\n\nNa etapa da **Microsoft App ID**, selecione **Usar registro de aplicativo existente**:\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**.\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\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\nEm **Configuração**, insira a URL de call-back fornecida pela equipe de Onboarding no **Ponto de extremidade de mensagens**, e clique em **Aplicar**.\n\nEm **Canais**, adicione o canal do **Microsoft Teams**, depois clique em Salvar:\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### 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\n2º Clique em Aplicativos.\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##### 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\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.\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##### 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\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**.\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\nAo clicarmos em publicar, abrirá um pop-up \\- (**Publicar seu aplicativo**) Clique na opção (**Publicar para sua organização**)\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\nEm seguida clique em Manage apps. Após isso, deve-se clicar em Search by name.\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\nA tela seguinte será para publicar a App. Clique em **Publish**.\n\nUm pop-up de confirmação aparecerá na tela, clique em **Publish** novamente.\n\nApós o procedimento, a informação sobre **pendentes para aprovação** fica zerada.\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**:"}