Integrator's ToolKit과 사용자 정의 앱을 통합하여 사용하는 방법

  • 업데이트 시간

이번 튜토리얼에서는 Integrator의 ToolKit에서 사용할 사용자 정의 앱을 포함하는 사용자 정의 앱 구성 JSON 파일을 만드는 방법에 대해 알아봅니다. 이를 통해 ToolKit과 사용자 지정 앱의 통합이 가능합니다.

전제 조건

ToolKit을 사용하여 사용자 정의 앱에 대한 통합을 활성화하려면 다음 세부 정보가 필요합니다:

  1. 애플리케이션 이름 - 애플리케이션의 이름(예: "ACME Weapon Detector")
  2. 패키지 이름 - 앱의 WebUI로 검색하여 주소창 내용을 보면 얻을 수 있는 앱의 패키지 이름. (예: "com.acme.detector.weapon")
  3. 트리거 - 애플리케이션에서 전송하는 메시지 및 그들의 역할. 이는 일반적으로 애플리케이션 스토어(Application Store)의 앱 통합 문서에서 찾을 수 있습니다. 예컨대 하나의 메세지는 "무기가 감지될 때" - "sst:/acme/weapon"일 수 있습니다. 앱은 하나 이상의 메시지를 보낼 수 있으며, 사용자의 사용 사례와 관련된 메시지여야 합니다. 여기서 사용되는 용어는 "주제(topic)" 또는 "채널(channel)"일 수 있습니다.

참고: 앱이 플랫폼의 지원되는 메커니즘 중 하나 (예: DataTrolley, MessageBroker)를 통해 메시지를 전송하는 게 아니라면 해답 앱과의 통합은 아직 불가합니다. 개발자 또는 Azena 고객지원에 연락하여 그들이 제공하는 앱이 메시지를 전송할 수 있도록 요청하십시오.

앱 구성 JSON 파일 생성

단일 애플리케이션 (단일 메시지)

구성 파일은 이전 섹션의 세부 정보가 다음과 같이 채워지도록 JSON 형식입니다:

[
  {
    "appName": "ACME Weapon Detector",
    "packageName":"com.acme.detector.weapon",
    "triggers":[
      {
        "topicName": "sst:/acme/weapon",
        "topicDescription": "Occurs when weapons in general are detected.",
        "conditions":[]
      }
    ]
  }
]

단일 애플리케이션 (다중 메시지)

이 앱이 "권총(pistol)"에 대한 메시지도 전송한다고 가정해 봅시다. 그러면 우리는 이 메시지를 다음과 같이 추가할 수 있습니다:

[
  {
    "appName": "ACME Weapon Detector",
    "packageName":"com.acme.detector.weapon",
     "triggers":[
      {
        "topicName": "sst:/acme/pistol",
        "topicDescription": "Occurs when pistols are detected.",
        "conditions":[]
      },
      {
        "topicName": "sst:/acme/weapon",
        "topicDescription": "Occurs when weapons in general are detected.",
        "conditions":[]
      }
    ]
  }
]

다중 애플리케이션

여러 개의 앱을 추가하는것 또한 가능합니다. "Passionfruit FanFinder"라는 다른 앱도 추가하고 싶다고 가정해 봅시다. 이것은 다음과 같이 추가할 수 있습니다:

[
  {
    "appName": "ACME Weapon Detector",
    "packageName":"com.acme.detector.weapon",
    "triggers":[
      {
        "topicName": "sst:/acme/pistol",
        "topicDescription": "Occurs when pistols are detected.",
        "conditions":[]
      },
      {
        "topicName": "sst:/acme/weapon",
        "topicDescription": "Occurs when weapons in general are detected.",
        "conditions":[]
      }
    ]
  },
  {
    "appName": "Passionfruit FanFinder",
    "packageName":"com.passionfruit.fanfinder",
    "triggers":[
      {
        "topicName": "pf/alpha",
        "topicDescription": "Occurs when alpha type fans are found.",
        "conditions":[]
      }
    ]
  }
]

사용자 정의 앱 구성 JSON 파일을 사용하는 방법

이제 사용자 정의 앱 구성 JSON 파일을  만들었으므로 다음 단계는 Integrator's ToolKit에서 이 파일을 사용하는 것입니다. 이 작업은 다음과 단계를 거쳐 수행할 수 있습니다:

  1. Integrator's ToolKit 열기
  2. "Settings" 클릭
  3. "Apps" 섹션 아래의 "Custom" 옵션 선택
  4. "Upload" 클릭 (또는 이전에 선택한 사용자 지정 파일이 이미 있는 경우 "Edit" 아이콘 클릭)
  5. 새로 만들어진 사용자 정의 JSON 파일을 선택
  6. "Home" 클릭
  7. "Create Event" 클릭
  8. "Select an app" 목록에 사용자 지정 앱이 표시되는지 확인
  9. 앱 중 하나를 선택
  10. 예상되는 앱 메시지가 표시되는지 확인

참고: 사용자 정의 앱 구성 파일을 사용하면, 지정된 특정 앱만을 사용하여 이벤트를 만들 수 있습니다. 따라서 기본 앱 구성 파일에서 지원하는 앱은 기본 구성으로 되돌리지 않는 한 더 이상 사용할 수 없습니다.

관련 문서

Zendesk 제공