사용자 정의 작업에서 API 호출 응답 사용 custom-action-enhancements

사용자 지정 작업에서 API 호출 응답을 활용하고, 이러한 응답을 기반으로 여정을 오케스트레이션할 수 있습니다.

중요 정보 custom-action-enhancements-notes

  • 스칼라 배열은 응답 페이로드에서 지원됩니다.

    code language-none
    "dummyScalarArray": [
    "val1",
    "val2"
    ]
    
  • 이기종 스토리지는 응답 페이로드에서 지원되지 않습니다.

    code language-none
    "dummyRandomArray": [
    20,
    "aafw",
    false
    ]
    

사용자 지정 작업 구성 config-response

  1. 사용자 지정 작업을 만듭니다. 이 페이지를 참조하십시오.

  2. 내부를 클릭합니다. 응답 필드.

    {width="80%"}

  3. 호출에서 반환된 페이로드의 예제를 붙여넣습니다. 필드 유형(문자열, 정수 등)이 올바른지 확인합니다. 다음은 호출 동안 캡처된 응답 페이로드의 예입니다. 로컬 엔드포인트는 충성도 포인트 수 및 프로필 상태를 전송합니다.

    code language-none
    {
    "customerID" : "xY12hye",
    "status":"gold",
    "points": 1290 }
    

    {width="80%"}

    API가 호출될 때마다 시스템은 페이로드 예제에 포함된 모든 필드를 검색합니다.

  4. customerID를 쿼리 매개 변수로도 추가하겠습니다.

    {width="80%"}

  5. 저장 ​을 클릭합니다.

여정에서 응답 활용 response-in-journey

여정에 사용자 지정 작업을 추가하기만 하면 됩니다. 그런 다음 조건, 기타 작업 및 메시지 개인화의 응답 페이로드 필드를 활용할 수 있습니다.

예를 들어 충성도 포인트의 수를 확인하는 조건을 추가할 수 있습니다. 사용자가 레스토랑에 들어오면 로컬 종단점이 프로필의 충성도 정보와 함께 호출을 보냅니다. 프로필이 Gold 고객인 경우 푸시를 보낼 수 있습니다. 또한 호출에서 오류가 감지되면 시스템 관리자에게 알리는 사용자 지정 작업을 보내십시오.

  1. 이전에 만든 이벤트와 충성도 사용자 지정 작업을 추가합니다.

  2. 충성도 사용자 지정 작업에서 고객 ID 쿼리 매개 변수를 프로필 ID에 매핑합니다. 옵션을 선택합니다. 시간 초과 또는 오류 발생 시 대체 경로 추가.

  3. 첫 번째 분기에서 조건을 추가하고 고급 편집기를 사용하여 아래의 작업 응답 필드를 활용합니다. 컨텍스트 노드.

  4. 그런 다음 푸시를 추가하고 응답 필드를 사용하여 메시지를 개인화합니다. 이 예제에서는 충성도 포인트 수와 고객 상태를 사용하여 콘텐츠를 개인화합니다. 작업 응답 필드는 다음에서 사용할 수 있습니다. 컨텍스트 속성 > Journey Orchestration > 작업.

    note note
    NOTE
    사용자 지정 작업을 입력하는 각 프로필은 호출을 트리거합니다. 응답이 항상 동일하더라도 여정은 프로필당 한 번의 호출을 수행합니다.
  5. 시간 제한 및 오류 분기에 조건을 추가하고 기본 제공 기능을 활용합니다 jo_status_code 필드. 이 예제에서는
    http_400 오류 유형. 이 섹션을 참조하십시오.

    code language-none
    @action{ActionLoyalty.jo_status_code} == "http_400"
    

  6. 조직에 전송할 사용자 지정 작업을 추가합니다.

테스트 모드 로그 test-mode-logs

테스트 모드를 통해 사용자 지정 작업 응답과 관련된 상태 로그에 액세스할 수 있습니다. 여정에서 응답이 있는 사용자 지정 작업을 정의한 경우 actionsHistory 섹션에 외부 끝점이 반환한 페이로드를 해당 사용자 지정 작업의 응답으로서 표시하는 작업이 표시됩니다. 이 기능은 디버깅 측면에서 매우 유용할 수 있습니다.

오류 상태 error-status

다음 jo_status_code 응답 페이로드가 정의되지 않은 경우에도 필드는 항상 사용할 수 있습니다.

다음은 이 필드에 사용할 수 있는 값입니다.

  • http 상태 코드: http_<HTTP API call returned code>예: http_200 또는 http_400
  • 시간 초과 오류: 시간 초과
  • 최대 가용량 오류: 제한됨
  • 내부 오류: internalError

반환된 http 코드가 2xx보다 크거나 오류가 발생하면 작업 호출이 오류로 간주됩니다. 이러한 경우 여정은 전용 시간 초과 또는 오류 분기로 이동합니다.

WARNING
새로 생성된 사용자 지정 작업에만 다음이 포함됩니다. jo_status_code 기본 제공 필드. 기존 사용자 지정 작업에 사용하려면 작업을 업데이트해야 합니다. 예를 들어 설명을 업데이트하고 저장할 수 있습니다.

표현식 구문 exp-syntax

구문은 다음과 같습니다.

#@action{myAction.myField}

다음은 몇 가지 예입니다.

 // action response field
 @action{<action name>.<path to the field>}
 @action{ActionLoyalty.status}
 // action response field
 @action{<action name>.<path to the field>, defaultValue: <default value expression>}
 @action{ActionLoyalty.points, defaultValue: 0}
 @action{ActionLoyalty.points, defaultValue: @event{myEvent.newPoints}}

사용자 지정 작업 응답에서 컬렉션을 조작하는 동안 을 사용할 수 있습니다. currentActionField 현재 항목에 액세스하려면:

count(
@action{MyAction.MyCollection.all(
currentActionField.description == "abc"
)}
)

추가 리소스

자세한 내용은 다음 페이지를 참조하십시오.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76