NotifyJsTelephonyDriver - 전역

Zurich API 참조

Release

zurich

ft:locale

ko-KR

ft:publication_title

Zurich API 참조

ft:clusterId

crapiref

bundleId

crapiref

workflow

Creator

NotifyJsTelephonyDriver - 전역

릴리스 버전: Zurich

업데이트 날짜 2025년 07월 31일

소요 시간: 18분

NotifyJsTelephonyDriver API는 연결된 전화 통신 드라이버의 기능에 대한 정보를 가져오는 데 사용할 수 있는 메서드를 제공합니다.

이 확장점은 NotifyUtil - getTelephonyDriverFromNotifyNumber()와 같은 다른 메서드에서 객체를 반환할 때만 사용할 수 있는 스크립팅된 확장점입니다. 이 API를 직접 호출할 수 없습니다. 호출 메서드는 특정 드라이버를 인터페이스에 연결하여 드라이버 결정의 세부 정보를 추상화합니다. 사용 가능한 각 드라이버는 NotifyJsTelephonyDriver API에 의해 정의된 동일한 인터페이스를 구현합니다.

다음 코드 예제에서 getTelephonyDriverFromNotifyNumber() 메서드는 TwilioNotifyJsTelephonyDriver와 같이 전달된 전화 번호에 의해 결정되는 드라이버 인터페이스를 사용하여 이 API의 구현을 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        driverName: driver.getName(),
        supportsCall: driver.supportsCall(),
        supportsSMS: driver.supportsSms()
      } 
    }
}

NotifyJsTelephonyDriver 확장점과 연결된 드라이버를 확인하려면 시스템 확장점>전역으로 이동합니다. NotifyJsTelephonyDriver를 사용합니다. 연결된 모든 드라이버 구현이 구현 탭에 표시됩니다.

스크립팅된 확장점에 대한 자세한 내용은 확장점을 사용하여 애플리케이션 기능점 확장을 참조하십시오.

이 API를 사용하려면 알림(com.snc.notify) 플러그인을 활성화해야 합니다. Twillo와 같은 특정 드라이버 구현을 활성화하려면 해당 플러그인을 활성화해야 합니다.

NotifyJsTelephonyDriver - 호출(객체 notifyPhoneNumber, 문자열 phoneNumber)

지정된 전화 번호로 전화를 겁니다.

표 1. 매개변수
이름	유형	설명
알림 전화 번호	NotifyPhoneNumber - 전역	전화를 걸 Notify 전화 번호가 포함된 NotifyPhoneNumber 기록입니다. 테이블: 알림 전화 번호 [notify_number] 테이블.
toPhoneNumber	문자열	발신 대상 전화 번호입니다. 형식: E.164

표 2. 반환
유형	설명
없음

NotifyJsTelephonyDriver - getCapabilities()

전화 통신 드라이버의 기능 목록을 반환합니다.

표 3. 매개변수
이름	유형	설명
없음

표 4. 반환
유형	설명
없음

이 예에서는 연결된 전화 통신 드라이버의 기능을 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
       capabilities: driver.getCapabilities()
      } 
    }
}

NotifyJsTelephonyDriver - getMaxSizeForBulkSms(문자열 phoneNumber)

전달된 알림 전화 번호와 연결된 전화 통신 드라이버가 한 번에 SMS 메시지를 보낼 수 있는 최대 전화 번호를 반환합니다.

표 5. 매개변수
이름	유형	설명
phoneNumber	문자열	연결된 드라이버가 하나의 대량 SMS 메시지로 보낼 수 있는 최대 전화 번호 수를 확인하는 알림 전화 번호입니다.

표 6. 반환
유형	설명
번호	단일 대량 SMS 배달에서 SMS 메시지를 보낼 수 있는 최대 전화 번호 수입니다.

이 예에서는 연결된 전화 통신 드라이버에 대해 단일 대량 SMS 메시지로 보낼 수 있는 최대 전화 번호 수를 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
       return {
       maxSmsNumbers: driver.getMaxSizeForBulkSMS(notifyNumber)
      }       
    }
}

NotifyJsTelephonyDriver - getPhoneNumber(문자열 phoneNumber)

지정된 전화 번호에 대한 알림 전화 번호 기록을 반환합니다.

알림 전화 번호 [notify_number] 테이블에서 지정된 전화 번호를 찾을 수 없는 경우 null을 반환합니다.

표 7. 매개변수
이름	유형	설명
없음

표 8. 반환
유형	설명
알림PhoneNumberAPI	지정된 전화 번호와 연결된 알림 전화 번호 기록입니다.

이 예에서는 전화 통신 드라이버를 가져와 지정된 전화 번호에 대한 연결된 알림 전화 번호 기록을 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
       phoneNumberRecord: driver.getPhoneNumber(notifyNumber)
      } 
    }
}

NotifyJsTelephonyDriver - getPhoneNumbers()

현재 전화 통신 드라이버와 연결된 모든 알림 전화 번호의 목록을 반환합니다.

표 9. 매개변수
이름	유형	설명
없음

표 10. 반환
유형	설명
문자열	현재 드라이버와 연결된 모든 알림 전화 번호를 쉼표로 구분한 목록입니다.

이 예에서는 전화 통신 드라이버를 가져오고 현재 전화 통신 드라이버와 연결된 알림 전화 번호 목록을 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
       phoneNumbers: driver.getPhoneNumbers()
      } 
    }
}

NotifyJsTelephonyDriver - isActive()

현재 전화 통신 드라이버가 활성 상태인지 확인합니다.

표 11. 매개변수
이름	유형	설명
없음

표 12. 반환
유형	설명
부울	현재 전화 통신 드라이버가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 드라이버가 활성 상태입니다. false: 드라이버가 비활성 상태입니다.

이 예제에서는 전화 통신 드라이버를 가져오고 현재 전화 통신 드라이버가 활성 상태인지 여부를 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        active: driver.isActive()
      } 
    }
}

NotifyJsTelephonyDriver - kick(GlideRecord participantRecord)

현재 알림 전화 회의에서 지정된 호출자를 제거합니다.

표 13. 매개변수
이름	유형	설명
participantRecord	GlideRecord - 전역	전화 회의에서 제거할 호출자의 알림 참가자[notify_participant] 기록이 포함된 GlideRecord 객체입니다.

표 14. 반환
유형	설명
문자열	오류가 있는 경우에만 반환됩니다. 호출자가 호출에서 제거되지 않은 이유를 설명하는 오류 메시지입니다.

이 예에서는 현재 전화 회의에서 연결된 호출자를 음소거합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      var notifyParticipantGr = new GlideRecord('notify_participant');
      notifyParticipantGr.get('active participant sys id');
    
      if (notifyParticipantGr.isValid) {
        driver.kick(notifyParticipantGr)
    }
}

NotifyJsTelephonyDriver - 음소거(GlideRecord participantRecord)

현재 알림 전화 회의에서 지정된 호출자를 음소거합니다.

표 15. 매개변수
이름	유형	설명
participantRecord	GlideRecord - 전역	전화 회의에서 음소거할 호출자의 알림 참가자[notify_participant] 기록을 포함하는 GlideRecord 객체입니다.

표 16. 반환
유형	설명
문자열	오류가 있는 경우에만 반환됩니다. 호출자가 음소거되지 않은 이유를 설명하는 오류 메시지입니다.

이 예에서는 현재 전화 회의에서 연결된 호출자를 음소거합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      var notifyParticipantGr = new GlideRecord('notify_participant');
      notifyParticipantGr.get('active participant sys id');
    
      if (notifyParticipantGr.isValid) {
        driver.mute(notifyParticipantGr)
    }
}

NotifyJsTelephonyDriver - sendAutonomousBulkSms(객체 notifyPhoneNumber, 배열 toPhoneNumber, 문자열 메시지, GlideRecord 소스)

지정된 SMS(Short Message Service) 메시지를 지정된 전화 번호 목록으로 보냅니다.

또한 SMS 메시지 생성을 유발한 인시던트 기록을 SMS 메시지와 선택적으로 연결할 수 있습니다.

표 17. 매개변수
이름	유형	설명
메시지	문자열	보낼 메시지입니다.
알림 전화 번호	NotifyPhoneNumber - 전역	대량 SMS 메시지를 보내는 전화 번호가 포함된 기록입니다.
소스	GlideRecord - 전역	옵션입니다. 알림 메시지 [notify message] 테이블에 있는 연결된 SMS 메시지 기록의 소스 필드에 저장할 인시던트 GlideRecord입니다. 그러면 SMS 메시지가 생성된 인시던트 기록이 해당 SMS 메시지에 연결됩니다. 기본값: 없음. 이 매개변수가 전달되지 않으면 이 정보가 추적되지 않습니다.
toPhoneNumbers	배열	SMS 메시지를 수신할 장치의 전화 번호 목록입니다.

표 18. 반환
유형	설명
없음

이 예제에서는 자율 대량 SMS를 보내는 방법을 보여줍니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {

    }
}

NotifyJsTelephonyDriver - sendSMS(NotifyPhoneNumber, notifyPhoneNumber, String toPhoneNumber, String messageBody)

지정된 SMS(Short Message Service) 메시지를 지정된 전화 번호로 전송합니다.

표 19. 매개변수
이름	유형	설명
알림 전화 번호	NotifyPhoneNumber - 전역	SMS 메시지를 보내는 전화 번호가 포함된 알림 전화 번호 기록입니다. 표: 알림 전화 번호 [notify_number]
toPhoneNumber	문자열	SMS 메시지를 보낼 전화 번호입니다. 형식: E.164 준수
메시지	문자열	SMS 메시지에서 보낼 텍스트입니다.

표 20. 반환
유형	설명
없음

NotifyJsTelephonyDriver - supportsAutonomousBulkSms(문자열 phoneNumber)

지정된 알림 전화 번호가 자율적인 대량 SMS(Short Message Service) 메시지를 처리할 수 있는지 확인합니다.

표 21. 매개변수
이름	유형	설명
없음

표 22. 반환
유형	설명
부울	지정된 알림 전화 번호가 자율 대량 SMS를 지원하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 자율 대량 SMS를 지원합니다. false: 자율 대량 SMS를 지원하지 않습니다.

이 예제에서는 전화 통신 드라이버를 가져오고 드라이버가 자율 대량 SMS를 지원하는지 여부를 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        supportsBulkSMS: driver.supportsAutonomousBulkSms(notifyNumber)
      } 
    }
}

NotifyJsTelephonyDriver - supportsCall()

현재 전화 통신 드라이버가 전화 통화를 처리할 수 있는지 확인합니다.

표 23. 매개변수
이름	유형	설명
없음

표 24. 반환
유형	설명
부울	현재 전화 통신 드라이버가 전화 통화를 지원하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 드라이버가 전화 통화를 지원합니다. false: 드라이버가 전화 통화를 지원하지 않습니다.

이 예제에서는 전화 통신 드라이버를 가져오고 드라이버가 전화 통화를 지원하는지 여부를 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        supportsCall: driver.supportsCall()
      } 
    }
}

NotifyJsTelephonyDriver - supportsCallOverWebRtc()

지정된 알림 전화 번호가 WebRTC(실시간 통신)를 사용하여 브라우저로 전화를 걸 수 있는지 확인합니다.

표 25. 매개변수
이름	유형	설명
없음

표 26. 반환
유형	설명
부울	지정된 알림 전화 번호가 WebRTC를 사용하는 브라우저 호출을 지원하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: WebRTC를 지원합니다. false: WebRTC를 지원하지 않습니다.

이 예제에서는 전화 통신 드라이버를 가져오고 드라이버가 WebRTC를 사용하여 브라우저 호출을 지원하는지 여부를 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        supportsWebRTC: driver.supportsCallOverWebRtc(notifyNumber)
      } 
    }
}

NotifyJsTelephonyDriver - supportsSMS()

현재 전화 통신 드라이버가 SMS(Short Message Service) 메시지를 처리할 수 있는지 확인합니다.

표 27. 매개변수
이름	유형	설명
없음

표 28. 반환
유형	설명
부울	현재 전화 통신 드라이버가 SMS를 지원하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 드라이버가 SMS를 지원합니다. false: 드라이버가 SMS를 지원하지 않습니다.

이 예제에서는 전화 통신 드라이버를 가져오고 드라이버가 SMS를 지원하는지 여부를 반환합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      return {
        supportsSMS: driver.supportsSMS()
      } 
    }
}

NotifyJsTelephonyDriver - 음소거 해제(GlideRecord participantRecord)

현재 알림 전화 회의에서 지정된 호출자를 음소거 해제합니다.

표 29. 매개변수
이름	유형	설명
participantRecord	GlideRecord - 전역	전화 회의에서 음소거할 호출자의 알림 참가자[notify_participant] 기록을 포함하는 GlideRecord 객체입니다.

표 30. 반환
유형	설명
문자열	오류가 있는 경우에만 반환됩니다. 호출자가 음소거되지 않은 이유를 설명하는 오류 메시지입니다.

이 예에서는 현재 전화 회의에서 연결된 호출자를 음소거합니다.

getDriverDetails('<notify_number>'); 

function getDriverDetails(notifyNumber) {
  var nUtil = new NotifyUtil();
  if (!notifyNumber || !nUtil.validateOutboundNotifyNumber(notifyNumber))
    return;
  var driver = nUtil.getTelephonyDriverFromNotifyNumber(notifyNumber);
    if (driver) {
      var notifyParticipantGr = new GlideRecord('notify_participant');
      notifyParticipantGr.get('active participant sys id');
    
      if (notifyParticipantGr.isValid) {
        driver.unmute(notifyParticipantGr)
    }
}