ThunderPhone v3가 출시되었습니다.셀프서비스로, 분당 2¢부터.출시 소식 보기

Contact centers

NICE CXone에서 연결

Studio 스크립트에서 SIP 헤더의 ContactID와 함께 NICE CXone 통화를 ThunderPhone 에이전트로 전송하고, 스크립트가 계속 실행될 때 에이전트의 인계 정보를 조회합니다.

CXone Studio 스크립트가 컨택트 ID와 기타 컨텍스트를 담은 SIP 헤더와 함께 에이전트에 전화를 겁니다. 에이전트가 작업을 마치면 전화를 끊고, 스크립트의 REST API 작업이 핸드오프를 가져옵니다.

시작하기 전에

  • ThunderPhone 에이전트와 조직 API 키.
  • 사용자 지정 헤더를 허용하는 CXone SIP 트렁크 그룹. CXone가 헤더를 전송하기 전에 NICE 계정 담당자가 이 설정을 활성화해야 합니다.

1. SIP 엔드포인트 만들기

Placecall은 SIP 주소가 아니라 CXone 트렁크 그룹을 통해 전화번호로 전화를 겁니다. NICE는 이를 위한 SIP 자격 증명을 문서화하지 않았으며, 다른 AI 제공업체의 CXone 통합은 IP 허용 목록과 함께 TLS를 사용합니다. 따라서 스크립트가 다이얼할 번호를 수신 전화번호로 설정하여 ip_allowlist 엔드포인트를 만드십시오(전화번호로 전화를 거는 플랫폼 참조).

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": 12,
    "name": "NICE CXone",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs: NICE에서 제공하는 CXone 클러스터의 SIP 시그널링 범위입니다. 각각 /16 이하의 공용 IPv4 범위여야 합니다(IPv6는 /48 이하).
  • dial_in_numbers: Placecall이 다이얼할 번호로, CXone가 전송하는 형식으로 작성합니다. 실제 전화번호일 필요는 없습니다. ThunderPhone에서 전화번호로 사용 중이거나 다른 엔드포인트에서 이미 사용 중일 수 없으며, 이 경우 409가 반환됩니다.

CXone의 주소는 모든 고객이 공유하므로, 다른 CXone 고객이 해당 번호로 전화를 걸면 귀하의 에이전트에 연결됩니다. 번호를 선택할 때는 아무도 추측하지 못할 긴 번호를 선택하고(최대 15자리), CXone가 이를 전화 네트워크로 내보내는 대신 ThunderPhone으로 전송하는지 확인하며, 공개하지 마십시오.

2. 컨텍스트와 함께 통화 전송하기

Studio 스크립트에서 Placecall 전에 다음을 수행하십시오.

  1. 헤더 X-Call-ID와 값 ContactID를 사용하는 Sipputheader 작업을 추가합니다. CXone는 자체 통화 ID 헤더를 전송하지 않으므로 ThunderPhone은 이 값을 통화의 external_call_id로 저장합니다.
  2. 에이전트가 알아야 하는 다른 값마다 Sipputheader 작업을 추가합니다. 예를 들어 X-Skill을 support로 설정할 수 있습니다. 이 값은 프롬프트에서 {{sip_x_skill}}로 전달됩니다. Sipputheader는 User-to-User, 모든 X- 헤더 및 대부분의 P- 헤더를 지원하며, NICE는 값을 256자 이하로 권장합니다.

그런 다음 해당 번호로 Placecall을 수행하십시오. 이때 트렁크 그룹은 요청 URI와 To 헤더 모두에 번호를 포함하여 sip.thunderphone.com으로 전송해야 합니다. 엔드포인트는 TLS(포트 5061) 또는 TCP(포트 5060)를 지원하고 UDP는 거부합니다. NICE는 트렁크 전송 방식을 문서화하지 않으므로 UDP가 아닌지 확인하십시오.

3. 통화 다시 가져오기

CXone는 INVITE와 그 최종 응답에서만 SIP 헤더를 읽으므로, 에이전트가 통화를 반환합니다. 에이전트가 작별 인사를 하고 전화를 끊으면 스크립트가 발신자와 다시 연결됩니다. 다음 전송 번호를 추가하십시오(전송 번호 추가 참조).

{"name": "NICE CXone", "action": "return"}

NICE는 Placecall로 건 통화가 종료된 후 스크립트가 계속 실행되는지 문서화하지 않았습니다. 다른 AI 제공업체의 CXone 통합은 전화를 끊기 전에 CXone의 Signal API(POST /interactions/{contactId}/signal)를 통해 스크립트에 신호를 보냅니다. ThunderPhone은 이를 호출하지 않습니다. 스크립트가 발신자를 다시 연결하는 방법을 NICE에 확인한 다음, REST API 작업으로 핸드오프를 가져오십시오.

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= 뒤에 ContactID를 추가합니다.
  • 헤더 Authorization: Bearer sk_live_….
  • 응답에서 handoff.summary와 handoff.intent를 읽어 컨택트를 라우팅합니다.

핸드오프된 통화 조회를 참조하십시오.

테스트

스크립트를 실행하는 번호로 전화하고, 에이전트에게 담당자를 요청한 다음 스크립트가 계속 진행되고 REST API 작업이 핸드오프를 반환하는지 확인합니다. 통화가 에이전트에 도달하지 않으면 CXone이 전송하는 번호, 해당 소스 주소가 allowed_source_cidrs에 포함되는지, 그리고 통화가 TCP 또는 TLS를 통해 수신되었는지 확인합니다. 그런 다음 GET /v1/calls/{call_id}로 통화를 엽니다. sip_headers에 x-call-id가 나열되어야 하며, external_call_id는 ContactID와 같아야 합니다.

제한 사항

  • CXone은 INVITE와 그 최종 2xx에서만 헤더를 전송하고 읽으므로, 에이전트의 BYE에 있는 내용은 스크립트에 도달하지 않습니다.
  • NICE는 에이전트로부터 REFER를 수락하는 방식을 문서화하지 않았습니다.
  • REST API 작업은 기본적으로 10초 후 시간 초과되며(최대 90초 미만), 최대 32KB의 응답을 읽습니다.