Habilitar link direto para acessar o Automation Co-Pilot no Microsoft Teams

Este tópico explica como obter os identificadores necessários e montar um link direto do Microsoft Teams que abre o Automation Co-Pilot diretamente para uma solicitação específica dentro do Microsoft Teams.

Pré-requisitos

Para criar um link direto funcional, você precisa
ID do aplicativo
O ID do aplicativo Microsoft Teams (às vezes chamado de Microsoft App ID na configuração do aplicativo Teams).
ID da entidade
O identificador da guia Pessoal (a guia que você deseja abrir dentro do Microsoft Teams).
ID da solicitação
A referência de solicitação do Automation Co-Pilot que você deseja que o link abra.

Procedimento

  1. Criar ou abrir seu aplicativo do Teams (ID do aplicativo).
    1. Abra Portal do desenvolvedor do Microsoft Teams.
    2. Selecione Aplicativos.
      Se você já tiver um aplicativo para Automation Co-Pilot, abra-o. Caso contrário, selecione Criar um novo aplicativo e insira os detalhes necessários, como nome, descrição e informações do desenvolvedor.
    3. Copie o ID do aplicativo mostrado para o aplicativo (isso é usado no URL de link direto).
    Você obteve um ID do aplicativo.
    Por exemplo,
    https://teams.microsoft.com/l/app/96bfc9ea-ffac-410d-96ca-df449bl83cl3?source=manage-apps-copy-link
    Aqui, 96bfc9ea-ffac-410d-96ca-df449bl83cl3 (a parte após app/) é o ID do aplicativo.
    <APP_ID> foi criado.
  2. Configure uma guia Pessoal e capture o ID da entidade.
    1. No mesmo aplicativo dentro do Portal do desenvolvedor do Teams, vá para Recursos do aplicativo.
    2. Localize Aplicativo pessoal (ou a guia Pessoal, dependendo da visualização do portal).
    3. Adicione uma guia Pessoal (ou edite se já tiver) e insira os seguintes detalhes, por exemplo:
      • Nome: Automation Co-Pilot
      • URL do conteúdo: o URL da web que sua guia carrega (fornecido pela configuração do seu Automation Co-Pilot)
      • URL do site (Opcional, mas recomendado): um URL compatível com navegadores
    4. Salve a configuração.
    5. Copie o ID da entidade para essa guia Pessoal.
    Você obteve um ID da entidade. Por exemplo, 0eff0783-9304-4daa -9f6e-dfe0e8d0cfb3
  3. Obter o ID da solicitação (Automation Co-Pilot).

    Você pode usar um dos seguintes métodos para capturar o ID da solicitação que representa a solicitação que você deseja que o link direto abra.

    • Copiar da página de solicitação
      • Abra o Automation Co-Pilot e acesse a solicitação.
      • Copie a referência da solicitação da interface do usuário (por exemplo, Request Ref),

        ou

      • Copie do URL se a referência da solicitação aparecer na rota.

      Formatos típicos vistos em rotas são requests/ref/<REQUEST_ID>. Por exemplo, requests/ref/62-152

    • Copie de uma carga útil de notificação (se aplicável)

      Se o seu processo enviar uma mensagem ou notificação contendo uma referência de solicitação, copie a referência de solicitação diretamente dessa carga útil.

    Você obteve o ID da solicitação. Por exemplo, requests/ref/62-152
  4. Criar o link direto.
    O link direto da guia Pessoal do Teams usa este formato:
    https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<DEEP_LINK_PARAMETER>

    Para abrir uma solicitação específica dentro da guia, passe um parâmetro context do Teams com um subEntityId apontando para a rota da solicitação. Para criar o link direto,

    1. Defina a rota da subentidade como subEntityId = "requests/ref/<REQUEST_ID>". Por exemplo, requests/ref/62-152.
    2. Crie o JSON de contexto como {"subEntityId":"requests/ref/<REQUEST_ID>"}.
    3. Codifique o parâmetro de contexto em URL.

      O Teams espera que a string de consulta esteja codificada. O parâmetro geralmente é context=<JSON>. Por exemplo, (antes da codificação): context={"subEntityId":"requests/ref/62-152"}.

      Codifique todo esse valor em URL e anexe-o após ?.

    4. Um exemplo final de link direto (modelo) é https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<URL_ENCODED_CONTEXT> onde <URL_ENCODED_CONTEXT> é a forma codificada de: context={"subEntityId":"requests/ref/<REQUEST_ID>"}
  5. Teste o link direto no Microsoft Teams.
    1. Cole o link direto em uma mensagem de chat ou canal do Teams.
    2. Selecione o link.
    O Teams abre a guia do aplicativo Automation Co-Pilot e navega diretamente para a solicitação pretendida.