Ir para o conteúdo

Integração do agente com o Microsoft Teams

Deploy dos Recursos

Para podermos proceder ao deploy do seu agente no teams necessitamos que:

  • Insira o nome que pretende para o agente
  • Insira a introdução para o seu agente
  • Insira a descrição do seu agente

Com estes dados dados o deploy do seu agente pode proceder.

Criação da Aplicação no Microsoft Teams

Depois do deploy ser realizado, o próximo passo para completar a integração com o Microsoft Teams é criar a aplicação do Teams.

  1. Aceda ao Portal de Developer do Teams:
    https://dev.teams.microsoft.com/home

  2. Dentro do portal, crie uma nova aplicação, que será a aplicação a adicionar ao Teams.

  3. Após criar a aplicação, substitua o manifest pelo modelo base abaixo. Ele contém todas as configurações necessárias para que o bot funcione corretamente no Teams. Isto é feito entrado na aba app package editor.


Manifest Base

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.21/MicrosoftTeams.schema.json",
    "manifestVersion": "1.21",
    "version": "1.0.0",
    "id": "${{TEAMS_APP_ID}}",
    "developer": {
        "name": "name",
        "websiteUrl": "https://www.example.com",
        "privacyUrl": "https://www.example.com/privacy",
        "termsOfUseUrl": "https://www.example.com/termofuse"
    },
    "icons": {
        "color": "color.png",
        "outline": "outline.png"
    },
    "name": {
        "short": "name",
        "full": "name"
    },
    "description": {
        "short": "short description",
        "full": "full description"
    },
    "accentColor": "#FFFFFF",
    "bots": [
        {
            "botId": "${{BOT_ID}}",
            "scopes": [
                "personal",
                "team",
                "groupChat"
            ],
            "supportsFiles": false,
            "isNotificationOnly": false,
            "commandLists": [
                {
                    "scopes": ["personal", "team", "groupChat"],
                    "commands": [
                        {
                            "title": "Hi",
                            "description": "Say hi to the bot."
                        }
                    ]
                }
            ]
        }
    ],
    "composeExtensions": [],
    "configurableTabs": [],
    "staticTabs": [],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "validDomains": []
}
  1. Substitua as variáveis TEAMS_APP_ID. O TEAMS_APP_ID é o id da aplicação criada no portal.

  2. Pode fazer alterações aos nomes e ícones que serão usados.
    Atenção especial deve ser tomada aquando a alteração dos ícones devido às regras impostas pela Microsoft.
    Estas regras podem ser encontradas aqui:
    https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/design/design-teams-app-icon-store-appbar.

  3. Fazer download do app-package da aplicação, e pode inseri-lo agora no teams, seja para uso individual ou publica-lo para a sua organização.