Regal

Regal.io는 더 많은 대화를 유도하여 성장 목표를 훨씬 빠르게 달성할 수 있도록 설계된 전화 및 SMS 영업 솔루션입니다.

Regal과 Braze를 통합하면 모든 고객 터치포인트에서 더 일관되고 개인화된 경험을 만들 수 있습니다.

• Regal에서의 전화 대화 내용을 기반으로 Braze에서 적절한 다음 최적의 이메일 또는 푸시 알림을 발송합니다.
• 고가치 고객이 Braze의 마케팅 이메일을 클릭했지만 전환하지 않은 경우 Regal에서 전화를 트리거합니다.

필수 조건

통합: Braze에서 Regal로 데이터 전송

다음 섹션에서는 Braze Canvas 또는 Campaign 웹훅을 사용하여 Braze를 소스로 활용해 고객 프로필 및 이벤트 데이터를 Regal로 전송하는 방법을 설명합니다.

1단계: Regal에서 새 연락처 생성

Braze에서 새 연락처가 생성될 때마다 Regal로 웹훅을 전송하는 Canvas 또는 Campaign을 구축하여 Regal에서 전화 및 문자를 사용할 수 있도록 합니다.

1. “Create New Contact for Regal”이라는 제목의 Canvas 또는 Campaign을 생성하고 진입 유형으로 액션 기반을 선택합니다.

2. 트리거 로직을 커스텀 이벤트로 설정하고 전화번호가 있는 연락처가 생성될 때 발생하는 이벤트를 선택합니다. Regal에서는 전화번호 필드가 설정되어 있는지 확인하는 추가 필터를 추가하는 것도 권장합니다.

3. 새 웹훅 템플릿에서 다음 필드를 입력합니다:

   • 웹훅 URL: https://events.regalvoice.com/events
   • 요청 본문: Raw Text

요청 헤더 및 메서드

Regal.io에는 인증을 위한 HTTP 헤더와 HTTP 메서드도 필요합니다. 다음 항목은 설정 탭에서 키-값 페어로 이미 템플릿에 포함되어 있습니다:

• HTTP 메서드: POST
• 요청 헤더:
  • Authorization: {{<REGAL_API_KEY>}}
  • Content-Type: application/json

요청 본문

아래에서 유일한 필수 필드는 traits.phone 속성입니다. 나머지는 선택 사항입니다. 그러나 optIn을 포함하는 경우 optIn.channel과 optIn.subscribed를 반드시 포함해야 합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
    "userId": "<uniqueIdentifier>", //this is optional
    "traits": {
        "phone": "<phoneNumber>",
        "email": "<email>",
        "firstName": "<firstName>",
        "lastName": "<lastName>",
        "optIn": [
            {
                "channel": "voice",
                "source": "<leadSource>",
                "subscribed": true
            },
            {
                "channel": "sms",
                "source": "<leadSource>",
                "subscribed": true
            }
        ],
        "custom1": "<custom1>",
        "custom2": "<custom2>"
    },
    "eventSource": "braze"
}

위의 페이로드 예시는 모든 연락처가 음성 및 SMS에 대한 옵트인을 수락했다고 가정합니다. 그렇지 않은 경우 위에서 optIn 속성을 제거하고 optIn이 수집될 때 Regal에서 연락처를 업데이트하는 별도의 Canvas 또는 Campaign을 설정할 수 있습니다.

2단계: 옵트인 정보 업데이트

앱에서 사용자 경험의 다양한 단계에서 옵트인 및 옵트아웃이 발생할 수 있으므로, 사용자가 옵트인하거나 옵트아웃할 때 Regal을 업데이트하는 것이 중요합니다. 아래는 최신 옵트인 정보를 Regal로 전송하는 권장 Canvas입니다. 이 정보를 Braze 프로필 필드로 저장한다고 가정하지만, 그렇지 않은 경우 트리거는 사용자의 옵트인 또는 구독 취소를 나타내는 Braze 계정의 이벤트로도 쉽게 설정할 수 있습니다. (아래 예시는 전화 옵트인에 대한 것이지만, SMS 옵트인을 별도로 수집하는 경우 유사한 Canvas 또는 Campaign을 설정할 수 있습니다.)

1. “Send Opt In or Out to Regal”이라는 제목의 새 Canvas 또는 Campaign을 생성합니다.

2. 다음 트리거 옵션 중 하나를 선택하고 사용자의 옵트인 상태를 나타내는 필드를 선택합니다. 옵트인 또는 옵트아웃을 나타내기 위해 Braze에 이벤트를 발생시키는 경우 해당 이벤트를 트리거로 사용하세요.
   • User Profile Field Updated
   • Update Subscription Group Status
   • Subscription Status
3. 새 웹훅 템플릿에서 다음 필드를 입력합니다:
   • 웹훅 URL: https://events.regalvoice.com/events
   • 요청 본문: Raw Text

요청 헤더 및 메서드

Regal.io에는 인증을 위한 HTTP 헤더와 HTTP 메서드도 필요합니다. 다음 항목은 설정 탭에서 키-값 페어로 이미 템플릿에 포함되어 있습니다:

• HTTP 메서드: POST
• 요청 헤더:
  • Authorization: {{<REGAL_API_KEY>}}
  • Content-Type: application/json

요청 본문

더 많은 속성을 동시에 최신 상태로 유지하려면 이 페이로드에 추가 사용자 프로필 속성을 포함할 수도 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
    "userId": "<uniqueIdentifier>", //this is optional
    "traits": {
        "phone": "<phoneNumber>",
        "optIn": [
            {
                "channel": "voice",
                "source": "<leadSource>",
                "subscribed": "<voice_optin_subscribed>"
            },
            {
                "channel": "sms",
                "source": "<leadSource>",
                "subscribed": "<voice_optin_subscribed>"
            }
        ]
    },
    "eventSource": "braze"
}

3단계: 커스텀 이벤트 전송

마지막으로, Regal로 전송하려는 각 주요 이벤트에 대해 Canvas 또는 Campaign을 설정합니다. Regal에서는 SMS 및 전화를 트리거하는 데 중요한 이벤트(예: 가입 또는 구매 흐름의 각 단계에서의 이벤트)나 Regal Campaign에서 연락처가 이탈하는 종료 기준으로 사용될 이벤트를 전송하는 것을 권장합니다.

예를 들어, 아래는 사용자가 신청서의 첫 번째 단계를 완료했을 때 Regal에 이벤트를 전송하는 워크플로입니다.

1. “Send Application Step 1 Completed Event to Regal”이라는 제목의 새 Canvas 또는 Campaign을 생성합니다.

2. 트리거 노드 로직을 커스텀 이벤트로 설정하고 Regal로 전송하려는 이벤트 이름(예: “Application Step 1 Completed”)을 선택합니다.

3. 새 웹훅 템플릿에서 다음 필드를 입력합니다:

   • 웹훅 URL: https://events.regalvoice.com/events
   • 요청 본문: Raw Text

요청 헤더 및 메서드

Regal.io에는 인증을 위한 HTTP 헤더와 HTTP 메서드도 필요합니다. 다음 항목은 설정 탭에서 키-값 페어로 이미 템플릿에 포함되어 있습니다:

• HTTP 메서드: POST
• 요청 헤더:
  • Authorization: {{<REGAL_API_KEY>}}
  • Content-Type: application/json

요청 본문

더 많은 속성을 동시에 최신 상태로 유지하려면 이 페이로드에 추가 사용자 프로필 속성을 포함할 수도 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
    "userId": "<uniqueIdentifier>", //this is optional
    "traits": {
        "phone": "<phoneNumber>",
        "firstName": "<firstName>",
        "lastName": "<lastName>",
        "custom1": "<custom1>",
        "custom2": "<custom2>",
        "custom3": "<custom3>"
    },
    "name": "Application Step 1 Completed",
    "properties": {
      "educationalLevel": "<educationalLevel>",
      "preferredLocation": "<preferredLocation>",
      "preferredSubject": "<preferredSubject>",
      "readytoCommit": true
    },
    "eventSource": "braze"
}

최신 연락처 속성

필수는 아니지만, Regal에서는 주요 이벤트가 발생하는 시점에 최신 연락처 속성에 접근할 수 있도록 이벤트 워크플로의 이벤트 페이로드에 주요 사용자 프로필 데이터 필드도 함께 전송하는 것을 권장합니다.

참고

Regal로 전송해야 할 중요한 이벤트나 이러한 Canvases 및 Campaigns를 설정하는 최적의 방법에 대해 궁금한 점이 있으면 [email protected]로 문의하세요.

통합: Regal에서 Braze로 데이터 전송

이 섹션에서는 SMS.sent 및 call.completed와 같은 Regal 리포팅 이벤트를 Braze로 가져와 Braze 프로필에 표시하고 Braze 세분화 툴, Canvas 및 Campaigns에서 사용할 수 있도록 하는 방법을 설명합니다. 이 통합은 Regal 리포팅 웹훅과 Braze 데이터 변환을 사용하여 데이터 흐름을 자동화합니다.

1단계: Braze에서 데이터 변환 생성

중요

데이터 변환은 현재 얼리 액세스 단계입니다. 얼리 액세스에 참여하고 싶으시면 Braze 고객 성공 매니저에게 문의하세요.

Braze에서는 Braze로 전송할 Regal 웹훅별로 변환을 생성하는 것을 권장합니다.

데이터 변환을 생성하려면:

1. Braze 대시보드에서 Transformations 페이지로 이동합니다.
2. 변환에 이름을 지정하고 Create transformation을 클릭합니다.
3. 변환 목록에서 를 클릭하고 Copy webhook URL을 선택합니다.

2단계: Regal에서 리포팅 웹훅 활성화

리포팅 웹훅을 설정하려면:

1. Regal 앱으로 이동하여 Setting 페이지를 엽니다.

2. Reporting Webhooks 섹션에서 Create Webhooks를 클릭합니다.

3. 웹훅 엔드포인트 입력란에 해당 데이터 변환에 대한 Braze 데이터 변환 웹훅 URL을 추가합니다.

엔드포인트 업데이트

엔드포인트를 편집하면 캐시가 새로고침되어 새 엔드포인트로 이벤트를 전송하기까지 최대 5분이 소요될 수 있습니다.

재시도

현재 이러한 이벤트에 대한 재시도는 없습니다. 5초 이내에 응답이 수신되지 않으면 이벤트가 삭제되고 재시도되지 않습니다. Regal은 향후 릴리스에서 재시도 기능을 추가할 예정입니다.

이벤트

Regal의 리포팅 웹훅 가이드에는 게시하는 리포팅 이벤트의 전체 목록이 포함되어 있습니다. 여기에서 속성 정의와 샘플 페이로드도 확인할 수 있습니다.

3단계: Regal 이벤트를 Braze 이벤트로 변환

Braze 데이터 변환 기능을 사용하면 수신되는 Regal 이벤트를 Braze에서 속성, 이벤트 또는 구매로 추가하는 데 필요한 형식으로 매핑할 수 있습니다.

1. 데이터 변환에 이름을 지정합니다. 이벤트 웹훅별로 데이터 변환을 설정하는 것이 권장됩니다.

2. 연결을 테스트하려면 Regal Agent Desktop에서 휴대폰으로 아웃바운드 전화를 걸고 대화 요약 양식을 제출하여 call.completed 이벤트를 생성합니다.

3. Regal 연락처를 Braze 프로필에 매핑하는 데 사용할 식별자를 결정합니다. Regal 이벤트에서 사용 가능한 식별자는 다음과 같습니다:

   • userId - 이전에 연락처에 대해 이 식별자를 전송한 경우에만 이벤트에 설정됩니다
   • traits.phone
   • traits.email - 이전에 연락처에 대해 이 식별자를 전송한 경우에만 이벤트에 설정됩니다

Braze 지원 식별자

• Braze는 전화번호를 식별자로 지원하지 않습니다. 이를 식별자로 사용하려면 전화번호를 Braze에서 사용자 별칭으로 설정할 수 있습니다.
• Braze 데이터 변환을 사용할 때 이메일 주소를 식별자로 사용할 수 있습니다. 이메일 주소가 Braze 내에 프로필로 존재하는 경우 기존 프로필이 업데이트됩니다. 이메일 주소가 Braze 내에 아직 존재하지 않는 경우 이메일 전용 프로필이 생성됩니다.

활용 사례

• 이메일 트리거
• 프로필 속성 업데이트
• 실험 동기화 유지
• 연락처 구독 취소

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
  "userId": "123",
  "traits": {
    "phone": "+17625555555",
    "email": "[email protected]"
  },
  "name": "call.completed",
  "properties": {
    "agent_firstname": "Rebecca",
    "agent_fullname": "Rebecca Greene",
    "agent_id": "[email protected]",
    "direction": "OUTBOUND",
    "regal_voice_phone": "+19545558563",
    "regal_voice_phone_internal_name": "Sales Line",
    "contact_phone": "+17625555555",
    "call_id": "WTxxxxx9",
    "type": "Outbound Call",
    "disposition": "Converted During Convo",
    "notes": null,
    "objections": null,
    "campaign_name": "Life Insurance Quote Follow Up",
    "campaign_friendly_id": "445",
    "started_at": 1657855046,
    "ended_at": 1657855053,
    "completed_at": 1657855059,
    "talk_time": 7,
    "wrapup_time": 6,
    "handle_time": 13,
    "journey_uuid": null,
    "journey_name": null,
    "journey_friendly_id": null
  },
  "originalTimestamp": "1657855059",
  "eventSource": "Regal Voice"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
// The Braze /users/track endpoint expects timestamps in an ISO 8601 format. To use the Unix timestamp within Regal's call.completed event payload as the event timestamp in Braze must first be converted to ISO 8601. This can be done with the following code:
let unixTimestamp = payload.originalTimestamp;
let dateObj = new Date(unixTimestamp * 1000);
let isoString = dateObj.toISOString();

// This is a default template you can use as a starting point. Feel free to delete this entirely to start from scratch or to delete specific components as you see fit.

// First, this code defines a variable, "brazecall", to build up a /users/track request
// Everything from the incoming webhook is accessible via the special variable "payload". As such, you can template in desired values in your /users/track request with JS dot notation, such as payload.x.y.z

let brazecall = {
 "events": [
   {
     "external_id": payload.userId,
     "name": "Call Completed",
     "time": isoString,
     "_update_existing_only": false,
     "properties": {
       "agent_firstname": payload.properties.agent_firstname,
       "agent_fullname": payload.properties.agent_fullname,
       "agent_id": payload.properties.agent_id,
       "direction": payload.properties.direction,
       "regal_voice_phone": payload.properties.regal_voice_phone,
       "regal_voice_phone_internal_name": payload.properties.regal_voice_phone_internal_name,
       "contact_phone": payload.properties.contact_phone,
       "call_id": payload.properties.call_id,
       "type": payload.properties.type,
       "disposition": payload.properties.disposition,
       "notes": payload.properties.notes,
       "objections": payload.properties.objections,
       "campaign_name": payload.properties.campaign_name,
       "campaign_friendly_id": payload.properties.campaign_friendly_id,
       "started_at": payload.properties.started_at,
       "ended_at": payload.properties.ended_at,
       "completed_at": payload.properties.completed_at,
       "talk_time": payload.properties.talk_time,
       "wrapup_time": payload.properties.wrapup_time,
       "handle_time": payload.properties.handle_time,
       "journey_uuid": payload.properties.journey_uuid,
       "journey_name": payload.properties.journey_name,
       "journey_friendly_id": payload.properties.journey_friendly_id
     }
   }
 ]
};

// After the /users/track request is assigned to brazecall, you will want to explicitly return brazecall to create an output
return brazecall;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "userId": "123",
  "traits": {
    "phone": "+17625555555",
    "email": "[email protected]"
  },
  "name": "contact.attribute.edited",
  "properties": {
    "agent_email": "[email protected]",
    "contact_phone": "+17625555555",
    "changes": {
      "custom_properties": {
        "annual_income": {
          "old_value": "150,000",
          "new_value": "300,000"
        }
      }
    },
    "created_at": "1657855462"
  },
  "originalTimestamp": "1657855462",
  "eventSource": "Regal Voice"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
// This is an example template you can use as a starting point. Feel free to delete this entirely to start from scratch or to delete specific components as you see fit.

// Capture the key's updated property value within the 'changes' object and store this in an attributes variable that can be used in the /users/track request

const changes = payload.properties.changes.custom_properties;

const attributes = {};
for (const key in changes) {
 attributes[key] = changes[key].new_value;
}

// First, this code defines a variable, "brazecall", to build up a /users/track request
// Everything from the incoming webhook is accessible via the special variable "payload". As such, you can template in desired values in your /users/track request with JS dot notation, such as payload.x.y.z

const brazecall = {
 "attributes": [
   {
     "external_id": payload.userId,
     "_update_existing_only": false,
     ...attributes
   }
 ]
};

// After the /users/track request is assigned to brazecall, you will want to explicitly return brazecall to create an output
return brazecall;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "userId": "123",
  "traits": {
    "phone": "+17625555555",
    "email": "[email protected]"
  },
  "name": "contact.experiment.assigned",
  "properties": {
    "experiment_name": "Post Call Offer Test",
    "experiment_id": "xxxx-xxxx-xxxx-xxxx",
    "experiment_variant": "Aggressive Offer - 50%",
    "journey_uuid": "xxxx-xxxx-xxxx-xxxx",
    "journey_friendly_id": 220,
    "journey_name": "Post Call Follow Up"
  },
  "originalTimestamp": "1657855118",
  "eventSource": "Regal Voice"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// The Braze /users/track endpoint expects timestamps in an ISO 8601 format. To use the Unix timestamp within Regal's call.completed event payload as the event timestamp in Braze, it must first be converted to ISO 8601. This can be done with the following code:
let unixTimestamp = payload.originalTimestamp;
let dateObj = new Date(unixTimestamp * 1000);
let isoString = dateObj.toISOString();

// This is an example template you can use as a starting point. Feel free to delete this entirely to start from scratch or to delete specific components as you see fit.

// First, this code defines a variable, "brazecall", to build up a /users/track request
// Everything from the incoming webhook is accessible via the special variable "payload". As such, you can template in desired values in your /users/track request with JS dot notation, such as payload.x.y.z
let brazecall = {
 "events": [
   {
     "external_id": payload.userId,
     "_update_existing_only": false,
     "name": "Contact Experiment Assigned",
     "time": isoString,
     "properties": {
       "experiment_name": payload.properties.experiment_name,
       "experiment_id": payload.properties.experiment_id,
       "experiment_variant": payload.properties.experiment_variant,
       "journey_uuid": payload.properties.journey_uuid,
       "journey_friendly_id": payload.properties.journey_friendly_id,
       "journey_name": payload.properties.journey_name
     }
   }
 ]
};

// After the /users/track request is assigned to brazecall, you will want to explicitly return brazecall to create an output
return brazecall;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "userId": "123",
  "traits": {
    "phone": "+17625555555",
    "email": "[email protected]",
    "ip": "78.97.213.166"
  },
  "name": "contact.unsubscribed",
  "properties": {
    "new_subscription": true,
    "channel": "voice",
    "text": null,
    "ip": "207.38.149.143",
    "source": "regalvoice.agent_desktop",
    "timestamp": "1657855229"
  },
  "originalTimestamp": "1657855230",
  "eventSource": "Regal Voice"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// This is an example template you can use as a starting point. Feel free to delete this entirely to start from scratch or to delete specific components as you see fit.

// First, this code defines a variable, "brazecall", to build up a /users/track request
// Everything from the incoming webhook is accessible via the special variable "payload". As such, you can template in desired values in your /users/track request with JS dot notation, such as payload.x.y.z

let brazecall = {
 "attributes": [
   {
     "external_id": payload.userId,
     "_update_existing_only": true,
     "subscription_groups" : [{
       "subscription_group_id": "YOUR SUBSCRIPTION GROUP ID",
       "subscription_state": "unsubscribed"
     }]
   }
 ]
};

// After the /users/track request is assigned to brazecall, you will want to explicitly return brazecall to create an output
return brazecall;