Microsoft Teams에서 Automation Co-Pilot에 액세스할 수 있도록 딥 링크 활성화

이 주제에서는 필요한 식별자를 얻는 방법과 Microsoft Teams 내의 특정 요청으로 직접 연결되는 Automation Co-Pilot의 Microsoft Teams 딥 링크를 조립하는 방법을 설명합니다.

전제 조건

작동하는 딥 링크를 만들려면 다음이 필요합니다.
앱 ID
Microsoft Teams 앱의 ID(Teams 애플리케이션 구성에서 Microsoft 앱 ID라고도 함)입니다.
엔터티 ID
Microsoft Teams 내에서 열고자 하는 개인 탭의 식별자입니다.
요청 ID
링크가 열리도록 하려는 Automation Co-Pilot 요청 참조입니다.

프로시저

  1. Teams 앱(앱 ID)을 생성하거나 엽니다.
    1. Microsoft Teams 개발자 포털을 엽니다.
    2. 앱을 선택합니다.
      이미 Automation Co-Pilot에 대한 애플리케이션이 있다면 해당 애플리케이션을 여십시오. 그렇지 않으면 새 앱 만들기를 선택하고 이름, 설명, 개발자 정보와 같은 필요한 세부 정보를 입력하십시오.
    3. 앱에 표시된 앱 ID를 복사합니다(이는 딥 링크 URL에 사용됨).
    앱 ID를 획득했습니다.
    예를 들어,
    https://teams.microsoft.com/l/app/96bfc9ea-ffac-410d-96ca-df449bl83cl3?source=manage-apps-copy-link
    여기에서 96bfc9ea-ffac-410d-96ca-df449bl83cl3 (app/ 이후 부분)이 앱 ID입니다.
    <APP_ID>가 생성되었습니다.
  2. 개인 탭을 구성하고 엔터티 ID를 캡처합니다.
    1. 동일한 앱 내에서 Teams 개발자 포털의 앱 기능으로 이동합니다.
    2. 개인 앱 (또는 포털 보기에서 개인 탭)을 찾습니다,
    3. 개인 탭을 추가하거나(이미 있는 경우 편집) 다음과 같은 세부 정보를 입력합니다. 예시:
      • 이름: Automation Co-Pilot
      • 콘텐츠 URL: 탭에서 로드되는 웹 URL(Automation Co-Pilot 설정에서 제공됨)
      • 웹사이트 URL (선택 사항이지만 권장됨): 브라우저에서 사용 가능한 URL
    4. 구성을 저장합니다.
    5. 해당 개인 탭의 엔터티 ID를 복사합니다.
    엔터티 ID를 획득했습니다. 예를 들어, 0eff0783-9304-4daa -9f6e-dfe0e8d0cfb3
  3. 요청 ID(Automation Co-Pilot)를 가져옵니다.

    다음 방법 중 하나를 사용하여 딥 링크로 열고자 하는 요청을 나타내는 요청 ID를 캡처할 수 있습니다.

    • 요청 페이지에서 복사
      • Automation Co-Pilot을 열고 요청으로 이동합니다.
      • UI에서 요청 참조(예: Request Ref)를 복사합니다.

        또는

      • URL에서 요청 참조가 경로에 나타나면 복사합니다.

      경로에서 볼 수 있는 일반적인 형식은 requests/ref/<REQUEST_ID>입니다. 예를 들어, requests/ref/62-152

    • 알림 페이로드에서 복사(해당되는 경우)

      프로세스에서 요청 참조가 포함된 메시지나 알림을 보내는 경우, 해당 페이로드에서 요청 참조를 직접 복사하십시오.

    요청 ID를 획득했습니다. 예를 들어, requests/ref/62-152
  4. 딥 링크를 생성합니다.
    Teams 개인 탭 딥 링크는 이 형식을 사용합니다.
    https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<DEEP_LINK_PARAMETER>

    탭 안에서 특정 요청을 열려면 Teams context 매개변수와 요청 경로를 가리키는 subEntityId를 전달하십시오. 딥 링크를 생성하려면

    1. 서브 엔터티 경로를 subEntityId = "requests/ref/<REQUEST_ID>"로 정의합니다. 예: requests/ref/62-152
    2. 컨텍스트 JSON을 {"subEntityId":"requests/ref/<REQUEST_ID>"}로 작성합니다.
    3. 컨텍스트 매개변수를 URL 인코딩합니다.

      Teams는 쿼리 스트링이 인코딩되어야 한다고 예상합니다. 매개변수는 일반적으로 context=<JSON>입니다. 예를 들어, (인코딩 전): context={"subEntityId":"requests/ref/62-152"}

      이 전체 값을 URL 인코딩하여 ? 뒤에 추가하십시오.

    4. 최종 예시 딥 링크(템플릿)는 https://teams.microsoft.com/l/entity/<APP_ID>/<ENTITY_ID>?<URL_ENCODED_CONTEXT>이며 여기서 <URL_ENCODED_CONTEXT>는 context={"subEntityId":"requests/ref/<REQUEST_ID>"}의 인코딩된 형태입니다.
  5. Microsoft Teams에서 딥 링크를 테스트하십시오.
    1. 딥 링크를 Teams 채팅이나 채널 메시지에 붙여넣으십시오.
    2. 링크를 선택합니다.
    Teams는 Automation Co-Pilot 앱 탭을 열고 해당 요청으로 직접 이동합니다.