NotifyJsTelephonyDriver – Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 7 Minuten Lesedauer

    • Die NotifyJsTelephonyDriver Die API bietet Methoden, mit denen Sie Informationen zu den Fähigkeiten des zugehörigen Telefonie-Treibers abrufen können.

    Dies ist ein geskripteter Erweiterungspunkt, der nur verwendet werden kann, wenn sein Objekt von einer anderen Methode zurückgegeben wird, z. B. NotifyUtil: GetTelephonyDriverFromNotifyNumber() . Sie können diese API nicht direkt aufrufen. Die aufrufende Methode ordnet der Schnittstelle einen bestimmten Treiber zu und abstrahiert die Details zur Bestimmung des Treibers. Jeder der verfügbaren Treiber implementiert dieselbe Schnittstelle, die von definiert wird NotifyJsTelephonyDriver API.

    Im folgenden Codebeispiel GetTelephonyDriverFromNotifyNumber() Methode gibt eine Implementierung dieser API zurück, wobei die Treiberschnittstelle durch die übergebene Telefonnummer bestimmt wird, z. B. TwilioNotifyJsTelephonyDriver. 
    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()
      } 
    }
}

    Um zu sehen, welche Treiber dem Erweiterungspunkt NotifyJsTelephonyDriver zugeordnet sind, navigieren Sie zu Systemerweiterungspunkte > Global.NotifyJsTelephonyDriver . Alle zugehörigen Treiberimplementierungen werden in angezeigt Implementierungen Registerkarte.

    Weitere Informationen zu geskripteten Erweiterungspunkten finden Sie unter Erweiterungspunkte verwenden, um den Anwendungspunkt zu erweitern .

    Zur Verwendung dieser API müssen Sie das Notify-Plugin (com.snc.notify) aktivieren. Zum Aktivieren bestimmter Treiberimplementierungen, z. B. Twillo, müssen Sie das entsprechende Plugin aktivieren.

    NotifyJsTelephonyDriver – Call(Object notifyPhoneNumber, String phoneNumber)

    Ruft eine angegebene Telefonnummer an.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    notifyPhoneNumber Benachrichtigungs-PhoneNumber – Global NotifyPhoneNumber-Datensatz, der die Notify-Telefonnummer enthält, von der aus der Anruf getätigt werden soll.

    Tabelle: Notify-Telefonnummer [Notify_number] Tabelle.
    toPhoneNumber Zeichenfolge Telefonnummer, die angerufen werden soll.

    Format: E.164
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Keine

    NotifyJsTelephonyDriver – getCapabilities()

    Gibt eine Liste der Fähigkeiten des Telefonie-Treibers zurück.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Keine

    Dieses Beispiel gibt die Fähigkeiten des zugehörigen Telefonie-Treibers zurück.

    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(Zeichenfolge phoneNumber)

    Gibt die maximale Anzahl von Telefonnummern zurück, an die der Telefonie-Treiber, der der übergebenen Notify-Telefonnummer zugeordnet ist, gleichzeitig eine SMS-Nachricht senden kann.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    phoneNumber Zeichenfolge Benachrichtigen Sie die Telefonnummer, um die maximale Anzahl von Telefonnummern zu überprüfen, an die der zugehörige Fahrer in einer Massen-SMS-Nachricht senden kann.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    Anzahl Maximale Anzahl von Telefonnummern, an die eine SMS-Nachricht in einer einzelnen Massen-SMS-Zustellung gesendet werden kann.

    Dieses Beispiel gibt die maximale Anzahl von Telefonnummern zurück, die in einer einzelnen Massen-SMS-Nachricht für den zugehörigen Telefonie-Treiber an gesendet werden können.

    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(Zeichenfolge phoneNumber)

    Gibt den Notify-Telefonnummerndatensatz für die angegebene Telefonnummer zurück.

    Gibt null zurück, wenn die angegebene Telefonnummer nicht in der Tabelle „Notify Phone Number“ [Notify_number] gefunden wird.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    NotifyPhoneNumberAPI Notify-Telefonnummerndatensatz, der der angegebenen Telefonnummer zugeordnet ist.

    In diesem Beispiel wird der Telefonie-Treiber abgerufen und der zugehörige Notify-Telefonnummerndatensatz für eine angegebene Telefonnummer zurückgegeben.

    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()

    Gibt eine Liste aller Notify-Telefonnummern zurück, die dem aktuellen Telefonietreiber zugeordnet sind.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Kommagetrennte Liste aller Notify-Telefonnummern, die dem aktuellen Treiber zugeordnet sind.

    Dieses Beispiel ruft den Telefonie-Treiber ab und gibt die Liste der Notify-Telefonnummern zurück, die dem aktuellen Telefonie-Treiber zugeordnet sind.

    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()

    Überprüft, ob der aktuelle Telefonie-Treiber aktiv ist.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob der aktuelle Telefonie-Treiber aktiv ist.

    Gültige Werte:
    • Wahr: Treiber ist aktiv.
    • Falsch: Treiber ist inaktiv.

    Dieses Beispiel ruft den Telefonie-Treiber ab und gibt zurück, ob der aktuelle Telefonie-Treiber aktiv ist.

    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)

    Entfernt den angegebenen Anrufer aus der aktuellen Notify-Konferenzschaltung.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Partizipierender Datensatz GlideRecord – Global GlideRecord-Objekt, das den Notify-Teilnehmer-Datensatz [notify_participant] des Anrufers enthält, der aus der Konferenzschaltung entfernt werden soll.
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. Fehlermeldung, die beschreibt, warum der Anrufer nicht aus dem Anruf entfernt wurde.

    In diesem Beispiel wird der zugeordnete Anrufer in der aktuellen Telefonkonferenz stummgeschaltet.

    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 – stummschalten(GlideRecord partizipiantRecord)

    Schaltet den angegebenen Anrufer in der aktuellen Notify-Telefonkonferenz stumm.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Partizipierender Datensatz GlideRecord – Global GlideRecord-Objekt, das den Notify-Teilnehmer [Notify_participant]-Datensatz des Anrufers enthält, der in der Telefonkonferenz stummgeschaltet werden soll.
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. Fehlermeldung, die beschreibt, warum der Anrufer nicht stummgeschaltet wurde.

    In diesem Beispiel wird der zugeordnete Anrufer in der aktuellen Telefonkonferenz stummgeschaltet.

    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(Object notifyPhoneNumber, Array to PhoneNumber, Zeichenfolgennachricht, GlideRecord-Quelle)

    Sendet die angegebene SMS-Nachricht (Short Message Service) an die angegebene Liste von Telefonnummern.

    Darüber hinaus können Sie optional den Incident-Datensatz, der die Generierung der SMS-Nachricht verursacht hat, der SMS-Nachricht zuordnen.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Zu sendende Nachricht.
    notifyPhoneNumber Benachrichtigungs-PhoneNumber – Global Datensatz, der die Telefonnummer enthält, die die Massen-SMS-Nachricht sendet.
    Quelle GlideRecord – Global Optional. Incident-GlideRecord, der im Feld „Quelle“ des zugehörigen SMS-Nachrichtendatensatzes in der Tabelle „Notify-Nachricht“ [Notify-Nachricht] gespeichert werden soll. Dadurch wird der Incident-Datensatz, der die Generierung der SMS-Nachricht verursacht hat, mit dieser SMS-Nachricht verknüpft.

    Standard: Keine. Wenn dieser Parameter nicht übergeben wird, werden diese Informationen nicht nachverfolgt.
    Zu PhoneNumbers Array Liste der Telefonnummern der Geräte, die die SMS empfangen sollen.
    Tabelle : 18. Rückgaben
    Typ Beschreibung
    Keine

    Dieses Beispiel zeigt, wie eine autonome Massen-SMS gesendet wird.

    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, Zeichenfolge zu PhoneNumber, Zeichenfolge messageBody)

    Sendet eine angegebene SMS-Nachricht (Short Message Service) an eine angegebene Telefonnummer.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    notifyPhoneNumber Benachrichtigungs-PhoneNumber – Global Notify-Telefonnummerndatensatz, der die Telefonnummer enthält, die die SMS-Nachricht sendet.

    Tabelle: Notify-Telefonnummer [Notify_number]
    toPhoneNumber Zeichenfolge Telefonnummer, an die die SMS gesendet werden soll.

    Format: E.164-konform
    Nachricht Zeichenfolge Text, der in der SMS-Nachricht gesendet werden soll.
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    Keine

    NotifyJsTelephonyDriver – supportsAutonomousBulkSms(Zeichenfolge phoneNumber)

    Überprüft, ob die angegebene Notify-Telefonnummer SMS-Nachrichten verarbeiten kann.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob die angegebene Notify-Telefonnummer autonome Massen-SMS unterstützt.

    Gültige Werte:
    • Wahr: Unterstützt autonome Massen-SMS.
    • Falsch: Unterstützt keine autonome Massen-SMS.

    Dieses Beispiel ruft den Telefonie-Treiber ab und gibt zurück, ob der Treiber autonome Massen-SMS unterstützt.

    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()

    Überprüft, ob der aktuelle Telefonie-Treiber Telefonanrufe verarbeiten kann.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob der aktuelle Telefonie-Treiber Telefonanrufe unterstützt.

    Gültige Werte:
    • Wahr: Der Treiber unterstützt Telefonanrufe.
    • Falsch: Der Treiber unterstützt keine Telefonanrufe.

    Dieses Beispiel ruft den Telefonie-Treiber ab und gibt zurück, ob der Treiber Telefonanrufe unterstützt.

    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()

    Überprüft, ob die angegebene Notify-Telefonnummer einen Browser mithilfe von WebRTC (Echtzeitkommunikation) anrufen kann.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob die angegebene Notify-Telefonnummer Browseranrufe mit WebRTC unterstützt.

    Gültige Werte:
    • Wahr: Unterstützt WebRTC.
    • Falsch: Unterstützt WebRTC nicht.

    Dieses Beispiel ruft den Telefonie-Treiber ab und gibt zurück, ob der Treiber Browseraufrufe mit WebRTC unterstützt.

    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()

    Überprüft, ob der aktuelle Telefonie-Treiber SMS-Nachrichten (Short Message Service) verarbeiten kann.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob der aktuelle Telefonie-Treiber SMS unterstützt.

    Gültige Werte:
    • Wahr: Treiber unterstützt SMS.
    • Falsch: Treiber unterstützt SMS nicht.

    Dieses Beispiel ruft den Telefonie-Treiber ab und gibt zurück, ob der Treiber SMS unterstützt.

    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 – Stummschaltung aufheben(GlideRecord ParticipantRecord)

    Hebt die Stummschaltung des angegebenen Anrufers in der aktuellen Notify-Telefonkonferenz auf.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    Partizipierender Datensatz GlideRecord – Global GlideRecord-Objekt, das den Notify-Teilnehmer [Notify_participant]-Datensatz des Anrufers enthält, der in der Telefonkonferenz stummgeschaltet werden soll.
    Tabelle : 30. Rückgaben
    Typ Beschreibung
    Zeichenfolge Wird nur zurückgegeben, wenn ein Fehler aufgetreten ist. Fehlermeldung, die beschreibt, warum der Anrufer nicht stummgeschaltet wurde.

    In diesem Beispiel wird der zugeordnete Anrufer in der aktuellen Telefonkonferenz stummgeschaltet.

    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)
    }
}