과정 작성

여정은 JSON 편집기에서만 사용 가능한 user_defined 응답 유형을 사용하여 정의됩니다. (자세한 내용은 JSON 편집기를 사용하여 응답 정의하기를 참조하십시오.) 여정을 생성하려면 다음 단계를 따르십시오

1. 액션 편집기에서 여정을 시작할 단계를 생성하거나 편집합니다.

2. JSON 편집기로 전환 아이콘 을 클릭하여 JSON 편집기를 여십시오.

3. generic 배열에서 user_defined 응답을 작성하십시오. (자세한 내용은 JSON 편집기를 사용하여 응답 정의하기를 참조하십시오.)

   여정은 다음 구조를 사용하여 정의됩니다.

   "user_defined": {
     "user_defined_type": "IBM_BETA_JOURNEYS_TOUR",
     "skip_card": true|false,
     "card_title": "{title}",
     "card_description": "{description}",
     "steps": [
       ...
     ]
   }
   

   여기서,

   user_defined_type

   정의 중인 사용자 정의 응답의 특정 유형입니다. 과정을 정의하려면 항상 이 특성을 IBM_BETA_JOURNEYS_TOUR 로 설정하십시오.

   skip_card

   고객이 웹 대화 창에서 소개 카드를 클릭할 때까지 기다리지 않고 웹 대화가 과정을 즉시 시작해야 하는지 여부를 지정하는 선택적 특성입니다. (기본값은 false 입니다.)

   You can use this option to start a journey directly from your website, even if the web chat is not open. For more information, see Starting a journey without opening the web chat.

   card_title

   여정이 사용 가능할 때 웹 대화에 표시되는 소개 카드에 표시할 제목입니다 (예: Website tour 또는 Disputing a charge).

   card_description

   소개 카드에 표시할 설명입니다. 고객이 과정을 열 것인지 여부를 결정할 수 있도록 과정을 설명하십시오.

   steps

   과정의 단계를 정의하는 응답 배열입니다.

예

다음 예제는 텍스트, 이미지 및 비디오 응답의 조합을 사용하여 사용자가 비용을 청구하는 방법을 표시하는 과정을 정의합니다.

{
  "generic": [
    {
      "response_type": "user_defined",
      "user_defined": {
        "card_title": "Let’s dispute a charge!",
        "card_description": "Follow along with this guided journey to learn how to find and dispute charges.",
        "user_defined_type": "IBM_BETA_JOURNEYS_TOUR",
        "steps": [
          {
            "response_type": "text",
            "text": "Charges are listed on the Transactions page. **Click your profile photo** in the top right corner of your screen, and then **click Transactions** from the menu."
          },
          {
            "response_type": "text",
            "text": "Here you can view your charges.\n **Scroll through the Transactions page and review your charges.** Each charge contains a merchant name, transaction date, and amount charged."
          },
          {
            "response_type": "image",
            "source": "https://example.com/image.png",
            "alt_text": "Image showing location of Dispute option",
            "description": "The option to Dispute is marked in red on the right hand side of each row in the Transactions table. Just click here to file a dispute."
          },
          {
            "response_type": "video",
            "source": "https://vimeo.com/769580398",
            "description": "Watch this short video to learn what to expect now that you’ve filed a dispute."
          }
        ]
      }
    }
  ]
}

웹 대화를 열지 않고 과정 시작

과정은 웹 대화 통합의 일부이지만 고객이 웹 대화 창을 전혀 열지 않고 웹 사이트에서 직접 과정을 시작할 수 있도록 할 수 있습니다. 예를 들어, 고객이 클릭하여 페이지의 대화식 둘러보기를 실행할 수 있는 데모 보기 단추를 웹 사이트에 포함시킬 수 있습니다.

웹 대화를 열지 않고 과정을 시작하려면 다음을 수행하십시오.

1. 과정 응답을 보내는 조치에서 과정을 정의하는 JSON을 편집하십시오. 소개 카드를 생략하려면 "skip_card": true 를 포함하십시오.

2. 웹 사이트에서 send() 인스턴스 메소드를 사용하여 과정을 시작하는 조치를 트리거하는 어시스턴트에 메시지를 전송하십시오 (예: Give me a tour). 과정을 트리거하는 데 사용할 이벤트 (예: 단추 클릭 또는 페이지 로드) 에 대한 응답으로 메시지를 보내십시오.

이제 고객은 먼저 웹 대화를 열지 않고도 웹 사이트에서 직접 대화식 과정을 시작할 수 있습니다. (웹 대화 창이 나중에 열리면 과정에 대한 소개 카드가 대화 내역에 표시됩니다.)

제한사항

이 베타 기능에는 현재 다음과 같은 제한사항이 있습니다.

• 미리보기 분할창은 과정을 지원하지 않습니다. 과정을 미리 보려면 공유 가능한 미리보기 링크를 사용하십시오. 미리보기 링크에 대한 자세한 정보는 공유할 링크 복사 를 참조하십시오.

• 과정은 view:change 이벤트 또는 changeView 메소드를 사용하며 window:open 또는 window:close 이벤트 또는 openWindow, closeWindow 및 toggleOpen 인스턴스 메소드에 대해 작업하지 않습니다.

• 고객이 여행을 시작하면 웹 대화 창이 닫힙니다. view:change 이벤트를 사용하여 대화 후 양식의 표시를 트리거하는 경우, 코드는 새 event.reason 또는 event.newViewState.tour 매개변수의 값을 확인하여 양식 표시가 적절한지 여부를 결정해야 합니다.