---
title: Microsoft Teams
slug: aura/microsoft-teams
docTags: 
createdAt: 2025-07-07T20:39:55.891Z
---

A especificação a seguir atua como um guia detalhado para utilização do broker **Microsoft Teams**, fornecendo todas as instruções e orientações necessárias para sua configuração.

:::BlockQuote
Atualmente, o teams não está suportando alguns tipos de arquivos. Imagens estão funcionando normalmente. [Confira mais](https://github.com/microsoft/botbuilder-js/issues/4845)
:::

## Configuração

Para realizar o cadastro do broker, é imprescindível fornecer o **nome**, **identificador (ID)**, **chave secreta (segredo)** e **locatário (tenant)**.

***

*Este manual está dividido em seções para facilitar a localização das informações. As seções são:*

**[Criar Bot](docId\:U2x45XhTvXjYPfCjTwdGL)** 🔹 **[Adquirir Configuração](#adquirindo-configuração)** 🔹 **[Implantar Bot](docId\:U2x45XhTvXjYPfCjTwdGL)** 🔹 **[Importar e Exportar](docId\:U2x45XhTvXjYPfCjTwdGL)**

## Criar Bot

1. Na barra lateral, clique no ícone de **reticências**.

![Menu teams](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bXKS2yqBkOrOAs4CaSIKr_reticencias.png)

1. No campo de pesquisa, digite **Portal de Desenvolvimento** e selecione-o na lista de opções.

![Menu Portal de desenvolvimento](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ToaJSB5CcwK3n2Aq4bsb5_portal.png)

1. Usando o menu, aperte em **Aplicativos > Novo aplicativo**

![NovoApp](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/em006EysJgPCGSk9ACFec_newapp.png)

1. Insira o nome desejado para o seu aplicativo e clique em **Adicione**.

![NomeApp](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/8rMR2lv_XHYtm2P6VXMJM_nomeapp.png)

1. No menu, selecione a opção **Informação básica** e preencha **todos os campos obrigatórios** conforme indicado nas imagens e, ao final, clique no botão Salvar.

![AddInfo](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Hp8b3NHk_FyJoCOYP1zua_addinfos.png)
![AddInfo](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-p5eV3X1VJzenYhf_QdMc_addinfos2.png)
![AddInfo](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/hGXr0O0LqGL5g41K3DHHa_salvarnofinal.png)

1. Selecione em **Recurso do Aplicativo > Bot**

![RecursoApp](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/b9HxI0BUnBNNqtOY1TpmY_recursoapp.png)

1. Aperte em **Criar um novo bot**

![NovoBot](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/duixIDYn_KHdwOWeTJhln_novobot.png)

1. Usando o menu, aperte em **Novo bot**

![Menunewbot](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/SsVhZs8WUqZwvNGYvvkBI_menunovobot.png)

1. Insira o nome desejado para o seu bot e clique em **Adicione**.

![NomeNovoBot](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/J129qGhBVnQ6aH2qcJzs4_nomedobot.png)

1. Na seção **Configurar**, insira o ponto de extremidade desejado e clique em **Salvar**.

:::BlockQuote
Os endpoints são formados por: https\://{dominio}/{caminho-teams-server}/webhook
:::

![endpoint](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/z9_mESfNn8IQa8q7mMPx5_endpoint.png)

1. Volte para **Aplicativos > {SeuBot} > Recursos do Aplicativo > Bot**. Marque a opção **Selecionar bot existente** e escolha o bot que você criou na caixa de seleção. Depois, selecione **Personal** na aba de escolha de escopo e pressione **Salvar**.

![selecionarbot](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/KOhv-kpwUC0TokN1WEwFA_caminhoselecionarbot.png)
![RecursoApp](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/b9HxI0BUnBNNqtOY1TpmY_recursoapp.png)
![selecionarbot](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Pz_tVd37vWy1QsonvjV1d_selecionarbot.png)

:::BlockQuote
Recomenda-se seguir as instruções das imagens acima, pois elas contêm o exemplo utilizado pela equipe Citsmart Aura e funcionam de forma confiável. Opções adicionais, como "team" ou "suporte para chamadas de vídeo", podem ajudar a personalizar a experiência do bot para diferentes cenários de uso no Teams, mas não há garantia de que funcionarão corretamente após a configuração.
:::

## Adquirindo configuração

1. Na barra lateral, clique no ícone de **reticências**.

![Menu teams](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bXKS2yqBkOrOAs4CaSIKr_reticencias.png)

1. No campo de pesquisa, digite **Portal de Desenvolvimento** e selecione-o na lista de opções.

![Menu Portal de desenvolvimento](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ToaJSB5CcwK3n2Aq4bsb5_portal.png)

1. Usando o menu, aperte em **Ferramentas > Gerenciament de Bot**

![botao](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/10q-DB2fXbl0LDcxph_fy_botao.png)

1. Com isso, você poderá localizar e anotar:

- **1: Nome do bot (Nome de exibição)**
- **2: Identificador (ID do aplicativo)**

![dados](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/dH88YynwCm8O1I3rub1bl_dados.png)

1. Para encontrar o segredo, basta selecionar **\{Seu Bot} > Segredos do cliente** e clicar em **Adicionar um segredo do cliente...**.

O segredo fica disponível apenas no momento da criação. Portanto, caso sejam necessárias múltiplas configurações, será preciso criar mais de um segredo ou anotá-lo em um local seguro.

![lateralsegredo](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-MBITMXldj-SaCxzUvXJn_lateralsegredo.png)

***

:::BlockQuote
O locatário do app é localizável apenas dentro do Portal do Botframework
:::

1. Primeiro, acesse o [Portal do Botframework](https://dev.botframework.com/bots) e realize o login.
2. Selecione o bot que você criou e, no menu, clique em **Settings**.

![settings](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/UyGdwV6hRQ_cn9K0Vw4AJ_settings2.png)

***

![settings](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/r4KFd2mMt6SPn0yK9ondm_settings.png)

1. Clique no botão **Manage Microsoft App ID and password**

![botao](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/iORueyPHFieQDkDbG1hku_botaobotframework.png)

1. Localize o **ID do locatário**

![tenant](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Gztd0D7x6fhibqg7HT-tl_tenantid.png)

:::BlockQuote
Com isso, é possível adquirir todos os campos necessários para registrar dentro da plataforma:
:::

- **Nome do Chatbot** > Nome de exibição
- **ID do App** > ID do aplicativo (cliente)
- **ID do Locatário** > ID do diretório (locatário)
- **Segredo do App** > Segredo

## Implantar Bot

1. Na barra lateral, clique no ícone de **reticências**.

![Menu teams](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bXKS2yqBkOrOAs4CaSIKr_reticencias.png)

1. No campo de pesquisa, digite **Portal de Desenvolvimento** e selecione-o na lista de opções.

![Menu Portal de desenvolvimento](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ToaJSB5CcwK3n2Aq4bsb5_portal.png)

1. Usando o menu, aperte em **Aplicativos > \{Seu Aplicativo}**

![NovoApp](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ClvW9tJluJ5165kbM1oiF_seuappdeploy.png)

1. Clique em **Antevisão nas Teams** e selecione adicionar.

![NovoApp](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Zm5Ceg8D3tgA6DX4q7hYt_antevisaoteams.png)

***

![NovoApp](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/_2B3F_uUunOd7ZpZAWbGL_adicionarnoantevisao.png)

***

## Exportar e Importar Bots

[Importar](docId\:U2x45XhTvXjYPfCjTwdGL) | [Exportar](docId\:U2x45XhTvXjYPfCjTwdGL)

### Exportar

1. Na barra lateral, clique no ícone de **reticências**.

![Menu teams](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bXKS2yqBkOrOAs4CaSIKr_reticencias.png)

1. No campo de pesquisa, digite **Portal de Desenvolvimento** e selecione-o na lista de opções.

![Menu Portal de desenvolvimento](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ToaJSB5CcwK3n2Aq4bsb5_portal.png)

1. Vá para **Aplicativos > {SeuBot}** e clique em **Publicar**

![publish](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/7DZdagl0DJYXl9v8sN3JY_publish.png)

1. Selecione **Baixar o pacote do aplicativo**

![download](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/iE2DkUzkmOGeQl5dlGAJj_download.png)

***

### Importar

1. Na barra lateral, clique no ícone de **reticências**.

![Menu teams](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/bXKS2yqBkOrOAs4CaSIKr_reticencias.png)

1. Clique em **Obter mais aplicativos**

![Menu teams](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/mzeHNJXwl1b8M7T9Oxawa_importapp.png)

1. Selecione **Gerenciar seus aplicativos**

![download](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/nh9fpmQtRK0Mi5kuxDZbj_managemyapps.png)

1. Aperte em **Carregar um aplicativo**

![download](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/ju3j-0YTAp7IzB1V4HrUP_newappbutton.png)

1. Escolha a opção de envio que melhor se adequa à sua necessidade e selecione o arquivo compactado (.zip).

![download](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/iLwmkNUdhQAgDAXhNGLCb_typesupload.png)

:::BlockQuote
Caso o envio tenha sido feito por "Enviar um aplicativo à sua organização", será necessário que um administrador aceite o pedido. Após isso, o aplicativo será adicionado à organização inteira. Caso o envio tenha sido feito por "Fazer o upload de um aplicativo personalizado", siga a imagem abaixo.
:::

1. Clique em **Adicionar**

![download](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/RXhOyE7LIYcCrSQK4ZVpF_customappupload.png)