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

Contact centers

Five9에서 연결

AI Agent Connect를 사용하여 Five9 통화를 SIP를 통해 ThunderPhone 에이전트로 보내고, IVR 스크립트가 읽는 라우팅 헤더와 함께 다시 받으세요.

Five9 IVR 스크립트는 Five9의 통화 세부정보와 함께 발신자를 에이전트로 연결합니다. 에이전트가 작업을 마치면 SIP BYE의 라우팅 헤더와 함께 통화를 종료하고, 스크립트는 이를 통화 변수로 읽어 발신자를 라우팅합니다.

시작하기 전에

  • ThunderPhone 에이전트와 조직 API 키.
  • Five9의 AI 에이전트 연결 추가 기능. Five9는 이를 인증한 AI 제공업체로 제한하며, Five9 구현 팀이 설정합니다. 제공업체의 IVR 스크립트 템플릿을 가져오고, 통화 변수를 생성하며, 스크립트의 타사 전송 모듈이 제공업체를 가리키도록 구성합니다. ThunderPhone은 아직 Five9의 인증 목록에 없습니다. 이를 전제로 계획하기 전에 Five9 계정 팀이나 ThunderPhone 지원팀에 문의하십시오.

1. SIP 엔드포인트 만들기

Five9의 타사 전송 모듈은 SIP 주소가 아닌 전화번호로 전화를 걸며, 다른 제공업체의 Five9 통합은 비밀번호 대신 소스 주소로 Five9를 인증합니다. 따라서 Five9가 다이얼할 번호를 다이얼인 번호로 사용하여 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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
  • allowed_source_cidrs: Five9에서 제공하는 Five9 데이터 센터의 SIP 신호 범위입니다. 각 범위는 /16 또는 그보다 좁은 공용 IPv4 범위여야 합니다(IPv6는 /48 또는 그보다 좁아야 함).
  • dial_in_numbers: Five9의 스크립트가 다이얼할 번호이며, Five9가 전송하는 형식으로 작성합니다. 실제 전화번호일 필요는 없습니다. ThunderPhone에서 전화번호 또는 다른 엔드포인트로 이미 사용 중인 번호일 수 없으며, 이 경우 409가 반환됩니다.

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

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

Five9 구현 팀에 다음을 요청하십시오.

  • 타사 전송 모듈에서 sip:+14155550188@sip.thunderphone.com으로 통화를 전송하고, 요청 URI와 To 헤더 모두에 번호를 넣습니다. 이 모듈은 제공업체의 SIP 도메인이 포함된 헤더에서 번호를 가져옵니다.
  • TLS(포트 5061) 또는 TCP(포트 5060)를 통해 전송합니다. 엔드포인트는 UDP를 거부하며 Five9는 사용하는 전송 방식을 공개하지 않으므로, UDP가 아닌지 확인하십시오.
  • 에이전트가 통화를 종료한 후 스크립트가 계속 진행되도록 타사 통화 후 반환을 켭니다(Five9는 타사 통화에서 최대 3,600초를 허용함).

Five9 가이드에는 전송하는 값(call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name 등)은 나열되어 있지만 헤더 이름은 나열되어 있지 않습니다. 다른 AI 제공업체의 Five9 통합에서는 전송 수준에서 이를 X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign 및 X-AgentID로 문서화합니다. 첫 번째 테스트 통화에서 이를 확인하십시오. 각 값은 {{sip_x_callcampaign}}와 같은 변수로 프롬프트에 전달됩니다. X-CallID는 통화의 external_call_id로 저장됩니다.

3. 통화를 다시 받기

에이전트가 통화를 반환합니다. 작별 인사를 하고 전화를 끊으면 BYE에 Five9 스크립트가 읽는 네 개의 헤더가 포함됩니다. 이 전환 번호를 추가합니다(전환 번호 추가 참고).

{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
  • X-RouteType 및 X-RouteValue는 스크립트에 발신자를 보낼 위치를 알려 줍니다. 여기서는 Support 스킬입니다. 다른 제공업체에서 X-RouteType에 대해 문서화하는 값에는 SkillTransfer, PhoneTransfer, Hangup, DispositionOnly가 포함됩니다. 스크립트를 유지 관리하는 담당자와 값을 합의합니다. 여러 대상에 전송하려면 대상마다 이름과 X-RouteValue가 다른 반환을 하나씩 추가합니다.
  • X-RouteReason에는 billing_dispute와 같은 에이전트의 의도 라벨이 포함됩니다.
  • X-CustomMetaData에는 인계 ID가 포함됩니다. BYE에도 X-TP-Handoff-Id로 포함되지만 Five9는 이를 읽지 않습니다.

Five9 스크립트는 네 개의 헤더를 통화 변수에 매핑합니다. 에이전트 요약을 위해 스크립트가 IVR 쿼리 모듈로 인계 조회를 호출하도록 설정합니다. GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= 뒤에 call.call_id를 붙이고, Authorization: Bearer와 API 키를 전송하는 인증 프로필을 사용합니다. 인계된 통화 조회를 참고합니다.

테스트하기

IVR 스크립트로 전화를 걸고 에이전트에게 담당자를 요청한 다음, 스크립트가 통화 변수를 채운 상태로 발신자를 라우팅하는지 확인합니다. 통화가 에이전트에게 도달하지 않으면 요청 URI와 To 헤더의 번호가 접속 번호와 일치하는지, Five9의 소스 주소가 allowed_source_cidrs에 포함되어 있는지, 통화가 TCP 또는 TLS를 통해 들어왔는지 확인합니다. 그런 다음 GET /v1/calls/{call_id}로 통화를 엽니다. sip_headers에 x-callid가 나열되어야 하며, external_call_id는 Five9의 call.call_id와 일치해야 합니다.

제한 사항

  • Five9 가이드에는 BYE의 라우팅 데이터가 문서화되어 있으며 REFER 수락은 언급되어 있지 않습니다. 따라서 반환은 스크립트가 수행하는 콜드 전환입니다.
  • Five9는 User-to-User가 아니라 X-RouteType, X-RouteValue, X-RouteReason, X-CustomMetaData를 읽습니다. ThunderPhone은 각 헤더 값을 최대 256바이트 길이로 전송합니다.
  • Five9는 패킷 단편화를 방지하기 위해 사용자 지정 헤더를 약 10개로 유지할 것을 권장합니다.