Twilio용 BYO SMS 구성

전제 조건
  • Genesys Cloud CX 1 Digital Add-on II, Genesys Cloud CX 2, Genesys Cloud CX 2 Digital, Genesys Cloud CX 3 또는 Genesys Cloud CX 3 Digital 라이선스

다음 권한:

  • 통합 > 완성 > 추가하다
  • 통합 > 완성 > 삭제
  • 통합 > 완성 > 편집하다
  • 통합 > 완성 > 보다
  • SMS > 전화번호 > 모두 

SMS 서비스를 위해 Twilio와 기존 관계가 있는 경우 BYO(Bring Your Own) SMS 기능을 사용하여 기존 Twilio 계정을 Genesys Cloud에 통합할 수 있습니다. 그런 다음 모든 Genesys Cloud SMS 기능을 사용하여 고객과 SMS 메시지를 보내고 받을 수 있습니다.

참고: Genesys Cloud의 간접 고객인 경우 파트너 조직과 직접 협력하여 Twilio용 BYO SMS를 설정해야 합니다.

BYO SMS 가격은 Genesys Cloud 공정 사용 정책을 참조하세요.

Genesys Cloud 인바운드 웹훅으로 SMS 번호 프로비저닝

BYO SMS Twilio 통합에 Twilio SMS 번호를 추가하려면 먼저 Genesys Cloud 인바운드 웹후크를 사용할 수 있도록 SMS 번호를 프로비저닝해야 합니다.  이렇게 하려면 각 SMS 번호에 해당 지역에 적합한 Genesys Cloud Webhook URL을 프로비저닝하십시오. 자세한 내용은 Twilio Docs의 웹훅 문서를 참조하세요.

10DLC 번호에 대한 웹훅 구성

등록된 US 10DLC 번호를 사용하는 경우 Twilio가 해당 번호를 메시징 서비스에 배치하는 것을 발견할 수 있습니다. 이 경우 Genesys에서는 다음을 선택할 것을 권장합니다. 발신자의 웹훅에 따라 연기 메시징 서비스에 대한 웹후크 구성의 옵션을 선택하고 Genesys Cloud 인바운드 웹후크를 사용하도록 SMS 번호를 프로비저닝하십시오.

지역별 Genesys Cloud 웹훅 URL

미국 동부(N. 버지니아

https://byosms.mypurecloud.com/vendors/v1/twilio/a906d2848ad146028e8805a8bbaa24d3/mo 

미국 동부(오하이오)

https://byosms.use2.us-gov-pure.cloud/vendors/v1/twilio/60b5013a2511482999b30b6db5ec67d8/mo 

미국 서부(오레곤)

https://byosms.usw2.pure.cloud/vendors/v1/twilio/b1adfe3a944c428bbc65d953bb8629b2/mo

캐나다(캐나다 중부)

https://byosms.cac1.pure.cloud/vendors/v1/twilio/1190471d172842c283dc5376a92df73d/mo

남아메리카(상파울루)

https://byosms.sae1.pure.cloud/vendors/v1/twilio/44e8a8cd75f849b18ab6fc8bbad9a057/mo

유럽(프랑크푸르트)

https://byosms.mypurecloud.de/vendors/v1/twilio/3d904439dc3f4eceb2e574b43c8f5ac5/mo

유럽(아일랜드)

https://byosms.mypurecloud.ie/vendors/v1/twilio/a123cbc6467b48ccbdccc3e03fd30f4d/mo

유럽(런던)

https://byosms.euw2.pure.cloud/vendors/v1/twilio/f5c59e8b3a1345739ebd4564a340e526/mo

유럽 (취리히)

https://byosms.euc2.pure.cloud/vendors/v1/twilio/FhcOBGsMEALrQfWsxH1LQy39tzI3F3qk/mo  

중동(UAE)

https://byosms.mec1.pure.cloud/vendors/v1/twilio/N1aXOj92NXNBA21KqdkZfA3kFjdmAM2B/mo

아시아 태평양(오사카)

https://byosms.apne3.pure.cloud/vendors/v1/twilio/yXaIsznST36qG0qy7UAP4mWlsHDHh0E0/mo

아시아 태평양(서울)

https://byosms.apne2.pure.cloud/vendors/v1/twilio/2e58f741f7a547b49c15c64dfb305361/mo

아시아 태평양(시드니)

https://byosms.mypurecloud.com.au/vendors/v1/twilio/97b4889e04514098a34715f0c216bf7b/mo

아시아 태평양(도쿄)

https://byosms.mypurecloud.jp/vendors/v1/twilio/b7c9a0818bc343379513f713247b56ce/mo

아시아 태평양(뭄바이)

https://byosms.aps1.pure.cloud/vendors/v1/twilio/b462e102a5414620bc6f002bc561595d/mo

경고
  • 가져오기를 시도하기 전에 Twilio 번호에 웹훅 URL이 설정되어 있지 않으면 Genesys Cloud는 가져오기 요청을 거부합니다.
  • Genesys Cloud의 BYO SMS는 Twilio의 보조 AuthTokens 옵션을 지원하지 않습니다.

Genesys Cloud의 BYO SMS는 Twilio가 인바운드 SMS/MMS 메시지와 함께 제공되는 기본 인증 토큰을 암시적으로 사용하기 때문에 보조 AuthTokens 옵션을 지원하지 않습니다. 안타깝게도 이러한 암시적 사용으로 인해 Genesys Cloud가 AuthToken을 검증하려고 할 때 오류가 발생합니다. 대안으로 Genesys는 BYO SMS 통합을 위해 Twilio 하위 계정을 사용할 것을 제안합니다. 자세한 내용은 Twilio의 Twilio 계정 및 하위 계정 시작하기 도움말을 참조하세요.

BYO Twilio SMS 통합 설정

BYO Twilio SMS 통합을 설정하려면 다음 단계를 수행하십시오.

  1. 딸깍 하는 소리 관리자.
  2. 아래에 통합, 클릭 통합.
  3. 딸깍 하는 소리 통합.
  4. 직접 Twilio SMS 계정 구성 가져오기 타일을 찾습니다.
  1. Genesys AppFoundry로 이동합니다.
  2. BYO Twilio SMS 통합을 검색합니다.
  3. BYO Twilio SMS 통합을 Genesys Cloud 조직에 추가하려면 지침을 따르십시오.

  1. 딸깍 하는 소리 설치. 직접 Twilio SMS 계정 구성 가져오기 화면이 나타납니다.
  2. (선택사항) 세부정보 탭에서 통합 이름을 맞춤설정하고 메모를 추가합니다.
    참고: Genesys에서는 이름과 메모를 사용하여 사용 중인 Twilio 계정을 식별할 것을 권장합니다.
  3. 클릭 구성 탭.
  4. 클릭 신임장 탭.
  5. 딸깍 하는 소리 구성. 자격 증명 구성 대화 상자가 나타납니다.
  6. 계정 SID 상자에 Twilio 계정의 SID를 입력합니다. 
  7. 승인된 토큰 상자에 Twilio 계정의 승인된 토큰을 입력합니다.
    참고: Genesys Cloud는 Twilio 자격 증명을 암호화하여 안전한 환경에 저장합니다. 자세한 내용은 Genesys Cloud는 사용자 인증 정보를 어떻게 처리하나요?를 참조하세요.
  8. 딸깍 하는 소리 좋아요.
  9. 딸깍 하는 소리 구하다.
  10. 상태를 활성으로 설정합니다.

SMS 번호 목록에 번호를 추가하세요.

BYO Twilio SMS 통합을 설정한 후에는 SMS 번호 인벤토리에 번호를 추가할 수 있습니다. 한 번에 하나의 번호만 추가할 수 있습니다.

참고: SMS 번호 목록에 번호를 추가해도 해당 번호 제어에는 영향을 미치지 않습니다. 기본적으로 Genesys Cloud가 SMS에 해당 번호를 사용하도록 허용합니다. 번호는 Twilio 계정에 남아 있으며 Twilio의 음성 상호 작용에 계속 사용할 수 있습니다.

SMS 번호를 추가하려면 다음 단계를 수행하세요.

  1. 딸깍 하는 소리 관리자.
  2. 아래에 메세지, 클릭 SMS 번호 인벤토리.
  3. SMS 번호 목록 페이지가 나타나면 번호 추가를 클릭합니다.
  4. 딸깍 하는 소리 수입.번호 가져오기 대화 상자가 나타납니다.
  5. 통합 목록에서 번호를 가져오려는 통합을 선택합니다.
  6. 유형 목록에서 가져오려는 번호 유형을 선택합니다.
    • 시내, 휴대전화 또는 무료를 선택하는 경우:
      • 발신자 ID 상자에 E164 형식을 사용하여 숫자를 입력합니다.
    • 단축코드를 선택하는 경우:
      • 국가 목록에서 국가를 선택합니다.
      • 발신자 ID 상자에 숫자를 입력합니다.
  7. 딸깍 하는 소리 다음.
  8. 유형 목록에서 단축 코드를 선택하면 필요한 상호작용 대화상자가 나타나고 세 탭 각각에 정보를 입력해야 합니다.
    • 도움말 탭에서 다음을 수행합니다.
      • 키워드 상자에 사용하려는 도움말 키워드를 입력합니다.
      • 메시지 상자에 도움 요청에 대한 응답으로 고객에게 보낼 메시지를 입력합니다.
    • 선택 해제 탭에서 다음을 수행합니다.
      • 키워드 상자에 사용하려는 선택 해제 키워드를 입력합니다.
      • 메시지 상자에 수신 거부 요청에 대한 응답으로 고객에게 보낼 메시지를 입력합니다.
    • 다시 선택 탭에서 다음을 수행합니다.
      • 키워드 상자에 사용하려는 선택 키워드를 입력합니다.
      • 메시지 상자에 수신 동의 요청에 대한 응답으로 고객에게 보낼 메시지를 입력합니다.
  9. 가져오기 확인을 클릭합니다. Genesys Cloud는 SMS 번호 데이터를 검색한 다음 SMS 번호 인벤토리 페이지로 돌아갑니다. 페이지 상단에 번호 가져오기가 성공했음을 알리는 알림 메시지가 나타납니다.

자세한 내용은 SMS 긴 코드 번호 목록 관리를 참조하세요.

Genesys Cloud에서 Twilio SMS 통합을 비활성화하는 것은 일시적입니다. 통합을 비활성화하면 이 통합을 위해 가져온 모든 번호가 SMS 번호 인벤토리에서 비활성화됩니다. 그러나 모든 인바운드 메시지는 Twilio에서 Genesys Cloud로 전송되는 동안 삭제됩니다. 즉, 사용자가 설정한 대기열로 라우팅되지 않습니다.

통합이 비활성화된 동안 인바운드 메시지 및 전송 보고서가 Twilio에서 Genesys Cloud로 전송되지 않도록 하려면 숫자에 대한 웹후크를 Genesys Cloud 웹후크 URL이 아닌 다른 것으로 변경하십시오.

메모:
  • Genesys Cloud에서 Twilio SMS 통합을 비활성화해도 Twilio 계정의 번호는 비활성화되지 않습니다.
  • 나중에 Twilio SMS 통합을 다시 활성화하기로 결정한 경우 웹훅 URL을 Genesys Cloud 웹훅 URL로 다시 변경하십시오.

Twilio 콘솔에 대한 자세한 내용은 Twilio의 웹훅 도움말을 참조하세요. 통합을 비활성화하는 방법에 대한 자세한 내용은 통합 수정, 비활성화 또는 삭제를 참조하세요.

주의: Twilio SMS 통합을 삭제하면 활성 인바운드 흐름이나 대기열 구성에 관계없이 SMS 번호 인벤토리에서 가져온 모든 번호가 제거됩니다.

Genesys Cloud에서 BYO SMS Twilio 통합을 삭제하는 경우 Twilio 콘솔의 모든 번호에 대한 인바운드 웹훅 URL을 원래 구성으로 다시 변경해야 합니다. 웹후크 URL을 변경하지 않으면 인바운드 메시지는 Genesys Cloud로 계속 라우팅되며 해당 메시지는 삭제됩니다. 메시지는 사용자가 설정한 대기열로 라우팅되지 않습니다.

참고: Genesys Cloud에서 Twilio SMS 통합을 삭제해도 Twilio 계정의 번호는 삭제되지 않습니다. Genesys Cloud에서 번호를 사용할 수 있는 기능만 제거됩니다.

Twilio 콘솔에 대한 자세한 내용은 Twilio의 웹훅 도움말을 참조하세요. 통합 삭제 방법에 대한 자세한 내용은 통합 수정, 비활성화 또는 삭제를 참조하세요.

기존 Twilio 계정을 Genesys Cloud에 통합하는 동안 오류가 발생하는 경우 이 표를 사용하여 자세한 정보를 알아보세요.

참고: SMS 메시지 전달에 문제가 발생하면 Twilio와 직접 협력해야 합니다.

메시지 설명
BYO 발신자 ID 통합을 확인하세요. 이 메시지는 요청이 백엔드 서비스로 전송되고 통합에 보낸 사람 ID가 누락된 경우 나타납니다. 
보낸 사람 ID에 필요한 규정 준수 키워드와 메시지를 입력하세요.

이 메시지는 규정 준수 정보가 누락된 경우 나타납니다. 필수 상호 작용 대화 상자의 세 가지 탭에서 필드를 확인하세요.

  • 도움말
  • 옵트아웃
  • 다시 선택
발송인 ID 유형을 확인하세요.

전화번호나 단축번호 형식이 잘못된 경우에 나타나는 메시지입니다.

  • 전화번호는 E.164 형식이어야 합니다.
  • 단축 코드는 5~6자 길이여야 합니다.
보낸 사람 ID 국가 코드를 확인하세요. 전화번호와 국가번호가 일치하지 않을 경우 나타나는 메시지입니다.
이 전화번호 주소에 대해 프로비저닝 작업이 이미 진행 중입니다. 이미 프로비저닝된 요청을 다시 제출하려고 하면 이 메시지가 나타납니다. 일부 숫자는 프로비저닝하는 데 시간이 더 오래 걸립니다.
이 전화번호 주소는 프로비저닝에 사용할 수 없습니다. 다른 전화번호 주소를 선택하고 다시 시도해 주세요. 이 메시지는 해당 전화번호가 이미 다른 조직에 제공되었을 때 나타납니다.
이 전화번호는 공급업체에서 찾을 수 없습니다. 이 메시지는 Twilio 하위 계정에 전화번호가 없을 때 나타납니다.