---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Benachrichtigen -- Global

# Benachrichtigen -- Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 12 Minuten Lesedauer

Die Benachrichtigen Mit der API können Sie mit Notify-Aufrufen und SMS-Nachrichten mithilfe von Skripts interagieren.

Greifen Sie auf die globale zu Benachrichtigen Klasse und die zugehörigen Methoden in `SNC `Namespace.

## Notify -- Anruf(Zeichenfolge notifyPhoneNumber, Zeichenfolge zu PhoneNumber, GlideRecord-KonferenzCall, GlideRecord-KonferenzCallRecord, Zeichenfolge userSysId, Zeichenfolge groupSysId, GlideRecord sourceRecord) {#ariaid-title2}

Ruft die angegebene E.164-konforme Telefonnummer an.
Darüber hinaus kann diese Methode die angegebene Telefonnummer automatisch einer angegebenen Telefonkonferenz hinzufügen.
{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| NotifyPhoneNumber | Zeichenfolge oder Benachrichtigungs-PhoneNumber | Benachrichtigen Sie die Telefonnummer, von der aus der Anruf getätigt werden soll. Wenn Sie einen Anruf initiieren, wird der Workflow für ausgehende Anrufe für die Nummerngruppe ausgeführt, die dieser Nummer zugeordnet ist. Stellen Sie sicher, dass dieser Workflow einen enthält Nehmen Sie an einer Telefonkonferenz Teil Aktivität zum Verbinden des Anwenders mit der Telefonkonferenz. |
| Zu PhoneNumber | Zeichenfolge | Telefonnummer, die angerufen werden soll. Angerufene Nummern werden der Telefonkonferenz hinzugefügt. |
| Konferenzanruf | GlideRecord | Optional. Wenn dieser Parameter übergeben wird, werden die Anrufer in identifiziert toPhoneNumberParameter werden automatisch der von diesem Datensatz identifizierten Telefonkonferenz hinzugefügt. GlideRecord für die Notify-Anruftabelle \[Notify_Call\], die den Telefonkonferenzdatensatz identifiziert. Dieser Datensatz wird automatisch dem Scratchpad für ausgehende Anrufe als Variable „Workflow.Scratchpad.Conference_call" hinzugefügt. |
| userSysId | Zeichenfolge | Optional. Eindeutiger Bezeichner (sys_ID) des Anwenders, der dem Anruf zugeordnet ist. |
| groupSysId | Zeichenfolge | Optional. Eindeutiger Bezeichner (sys_ID) der Gruppe, die dem Aufruf zugeordnet ist. |
| QuelleDatensatz | GlideRecord | Optional. Quelldatensatz, der diesen Anruf ausgelöst hat. |
[Tabelle : 1. Parameter]

{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr} {#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 2. Rückgaben]

{#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr}  
Dieses Beispiel veranschaulicht, wie Sie einen Anruf an eine andere Telefonnummer initiieren.

    var from = '+14048007337';
    var to = '+31646810495';

    // set up call
    new SNC.Notify().call(from, to);

Dieses Beispiel veranschaulicht, wie Sie einen Anruf zur Liste von Telefonnummern initiieren und diese Nummern automatisch in eine neue Telefonkonferenz einbinden.

    var notify = new SNC.Notify();
    var from = '+14041234567';
    var participants = ['+31612345678', '+31623456789', '+31687654321'];

    // set up a conference call
    var conferenceCall = notify.conferenceCall();

    // set up the outbound calls for all conference call participants
    for (var i in participants) {
        var to = participants[i];
        notify.call(from, to, conferenceCall);
    }

Dieses Beispiel veranschaulicht, wie eine neue Telefonkonferenz initiiert wird.

    SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), null, null, null);

Dieses Beispiel veranschaulicht, wie eine neue Telefonkonferenz mithilfe eines Anwenderdatensatzes initiiert wird.

    var sysUserGr = new GlideRecord('sys_user');
    sysUserGr.get('active conference sys id');
     
    if (conferenceGr.isValid) {
        SNC.Notify.call('+15413970605', '+91406XXXXXXX', SNC.Notify.conferenceCall(), sysUserGr.getUniqueValue(), null, null);
    }

Dieses Beispiel veranschaulicht, wie eine neue Telefonkonferenz mit einem Anwender-, Gruppen- und Quelldatensatz initiiert wird.

    var sysUserGr = new GlideRecord('sys_user');
    sysUserGr.get('active sys user sys id');
     
    var sysUserGroupGr = new GlideRecord('sys_user_group');
    sysUserGroupGr.get('active sys user group sys id');
     
    var incidentGr = new GlideRecord('incident');
    incidentGr.get('incident sys_id');
     
    if (conferenceGr.isValid) {
        SNC.Notify.call('+15413970605', '+91406XXXXXXX',
            SNC.Notify.conferenceCall(),
            sysUserGr.getUniqueValue(),
            sysUserGroupGr.getUniqueValue(),
            incidentGr.getUniqueValue());
    }

### Bereichsbezogenes Äquivalent

Zur Verwendung von Anruf() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- Call()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-call_S_S_GR_GR_S_S_GR "Ruft die angegebene E.164-konforme Telefonnummer an.").

## Notify -- conferenceCall(GlideRecord sourceRecord) {#ariaid-title3}

Erstellt einen neuen GlideRecord für Telefonkonferenzen.
{#r_N-conferenceCall__table_ysr_5mk_js__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| QuelleDatensatz | GlideRecord | Optional. Datensatz, der die Anforderung zum Erstellen der Telefonkonferenz initiiert hat. Wird verwendet, um die Quell- und Tabellenfelder im Datensatz „Notify_Conference_call" auszufüllen. |
[Tabelle : 3. Parameter]

{#r_N-conferenceCall__table_ysr_5mk_js} {#r_N-conferenceCall__table_zsr_5mk_js__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | Neuer Notify-Konferenzanruf \[Notify_Conference_call\]-Datensatz. |
[Tabelle : 4. Rückgaben]

{#r_N-conferenceCall__table_zsr_5mk_js}  

    var notify = new SNC.Notify();
    var from = '+14041234567';
    var participants = ['+31612345678', '+31623456789', '+31687654321'];

    // set up a conference call
    var conferenceCall = notify.conferenceCall();

    // set up the outbound calls for all conference call participants
    for (var i in participants) {
        var to = participants[i];
        notify.call(from, to, conferenceCall);
    }

### Bereichsbezogenes Äquivalent {#r_N-conferenceCall__section_wzp_1dd_1gb}

Zur Verwendung von ConferenceCall() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- conferenceCall()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-conferenceCall "Erstellt einen neuen GlideRecord für Telefonkonferenzen.").
**Zugehörige Verweise**   

* [Notify -- Anruf(Zeichenfolge notifyPhoneNumber, Zeichenfolge zu PhoneNumber, GlideRecord-KonferenzCall, GlideRecord-KonferenzCallRecord, Zeichenfolge userSysId, Zeichenfolge groupSysId, GlideRecord sourceRecord)](https://servicenow-prod.fluidtopics.net/Gqz6V7QisqfH0MkXYqf57Q#r_N-call_NotifyPhoneNumber_S_GR "Ruft die angegebene E.164-konforme Telefonnummer an.")

## Notify -- dequeue eCall(GlideRecord callRecord) {#ariaid-title4}

Setzt einen Anruf fort, nachdem er in eine Warteschlange gestellt wurde (in Warteschlange).
Verwenden Sie diese Methode, um Anrufe fortzusetzen, die mit in eine Warteschlange gestellt wurden Warteschlangenaufruf() Methode.
{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Calldatensatz | GlideRecord | Ein GlideRecord-Objekt in der Notify-Anruftabelle \[Notify_Call\] mit dem gehaltenen Anruf, den Sie fortsetzen möchten. |
[Tabelle : 5. Parameter]

{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js} {#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 6. Rückgaben]

{#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js}  
Das folgende Beispiel zeigt, wie Sie einen Anruf erneut aktivieren, der angehalten wurde.

    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.dequeueCall(notifyCallGr);
    }

### Bereichsbezogenes Äquivalent {#r_N-dequeueCall_GlideRecord__section_dws_mnd_1gb}

Zur Verwendung von DewareCall() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- dequeueCall()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-dequeueCall_GR "Setzt einen Anruf fort, nachdem er in eine Warteschlange gestellt wurde (in Warteschlange).").

## Notify -- ForwardCall (GlideRecord-Anruf, Zeichenfolgenziel, zeichenfolgendtmf) {#ariaid-title5}

Leitet den angegebenen Anruf an einen anderen Anrufempfänger weiter.
{#r_N-forwardCall_GR_S_S__table_byv_vml_ts__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Rufen Sie an | GlideRecord oder Zeichenfolge | Benachrichtigen Sie den Anrufdatensatz oder die Anruf-ID des Telefonanbieter des weiterzuleitenden Anrufs. |
| destination | GlideRecord oder Zeichenfolge | Benachrichtigen Sie den Telefonnummerndatensatz oder eine E.164-konforme Telefonnummer des Anrufers, an den der Anruf weitergeleitet werden soll. |
| dtmf | Zeichenfolge | Doppelton: Multifrequenz-Code (DTMF), der bei Anrufverbindung gesendet werden soll. |
[Tabelle : 7. Parameter]

{#r_N-forwardCall_GR_S_S__table_byv_vml_ts} {#r_N-forwardCall_GR_S_S__table_cyv_vml_ts__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

{#r_N-forwardCall_GR_S_S__table_cyv_vml_ts}  
Das folgende Beispiel zeigt, wie ein Anruf an eine andere Telefonnummer weitergeleitet wird.

    var callID = 'CA92374b5aa561dab476a7001db6026edc'; // Twilio Call ID
    var phoneNumber = '+91406xxxxxxx';
    var dtmfTones = null;
     
    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.forwardCall(notifyCallGr(or) callID, phoneNumber, dtmfTones)
    }

### Bereichsbezogenes Äquivalent

Zur Verwendung von ForwardCall() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- ForwardCall()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-forwardCall_GR_S_S "Leitet den angegebenen Anruf an einen anderen Anrufempfänger weiter.").

## Notify -- getAvailableClients (Zeichenfolge notifyNumber) {#ariaid-title6}

Gibt eine Liste von Client-Sitzungen zurück, die für den Empfang von Anrufen verfügbar sind.
{#r_N-getAvailableClients_String__table_ibs_r1n_ms__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Benachrichtigungsnummer | Zeichenfolge | Gültige Notify-Telefonnummer. |
[Tabelle : 9. Parameter]

{#r_N-getAvailableClients_String__table_ibs_r1n_ms} {#r_N-getAvailableClients_String__table_jbs_r1n_ms__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | GlideRecord aus der Tabelle Notify_Client_Session für die angegebene Telefonnummer. Gibt „0" zurück, wenn keine Client-Sitzungen verfügbar sind. |
[Tabelle : 10. Rückgaben]

{#r_N-getAvailableClients_String__table_jbs_r1n_ms}  
Das folgende Beispiel zeigt, wie Sie die Methode getAvailableClients() verwenden, um in die Tabelle „Notify_Client_Session" zu indizieren und dann über alle verfügbaren Notify-Clients hinweg zu iterieren.

    var clientSessionGr = SNC.Notify.getAvailableClients('+185xxxxxxxx'); 
    // Here clientSessionGr is of type GlideRecord on 'notify_client_session' table.
     
    var isLoggedInUserAvailable = false;
    while (clientSessionGr.next()) {
      if (clientSessionGr.user == gs.getUserID())
        isLoggedInUserAvailable = clientSessionGr.available;
    }
    gs.info('isLoggedInUserAvailable - ' + isLoggedInUserAvailable);

### Bereichsbezogenes Äquivalent {#r_N-getAvailableClients_String__section_bgp_tk2_1gb}

Zur Verwendung von GetAvailableClients() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- getAvailableClients()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-getAvailableClients_S "Gibt eine Liste von Client-Sitzungen zurück, die für den Empfang von Anrufen verfügbar sind.").

## Notify -- getParentCallID (GlideRecord callRecord) {#ariaid-title7}

Gibt die sys_ID des übergeordneten Aufrufs eines angegebenen Aufrufs zurück.
Jeder Anruf, der durch die Weiterleitung eines anderen Anrufs gestartet wird, z. B. mit der Weiterleitungs-Workflow-Aktivität, wird als untergeordnetes Element des ursprünglichen Anrufs betrachtet. Der ursprüngliche Anruf ist der übergeordnete Anruf.
{#r_N-getParentCallID_GR__table_sqs_jxn_wr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Calldatensatz | GlideRecord | Datensatz in der Notify-Anruftabelle \[Notify_call\], für den der Anrufstatus zurückgegeben werden soll. |
[Tabelle : 11. Parameter]

{#r_N-getParentCallID_GR__table_sqs_jxn_wr} {#r_N-getParentCallID_GR__table_tqs_jxn_wr__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eindeutige sys_ID des übergeordneten Anrufdatensatzes. |
[Tabelle : 12. Rückgaben]

{#r_N-getParentCallID_GR__table_tqs_jxn_wr}  
Dieses Beispiel zeigt, wie der übergeordnete Aufruf des angegebenen Anrufs abgerufen wird.

    var callRecord = new GlideRecord('notify_call');
    callRecord.get("0f4f5863ff13310014ecffffffffff28");

    var notify = new SNC.Notify();
    var parentCallID = notify.getParentCallID(callRecord);

## Notify -- getPhoneNumbers() {#ariaid-title8}

Gibt alle Telefonnummern und Kurzwahlen zurück, die zur Benachrichtigung verfügbar sind.
{#r_N-getPhoneNumbers__table_hsf_mwf_wr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 13. Parameter]

{#r_N-getPhoneNumbers__table_hsf_mwf_wr} {#r_N-getPhoneNumbers__table_isf_mwf_wr__entry__2}

| Typ | Beschreibung |
|-|-|
| Liste | Liste von NotifyPhoneNumber-Objekten, wobei jedes Objekt eine Telefonnummer darstellt, die benachrichtigt werden kann. |
[Tabelle : 14. Rückgaben]

{#r_N-getPhoneNumbers__table_isf_mwf_wr}  

    var list = SNC.Notify.getPhoneNumbers();
    for (var i = 0; i < list.size(); i++) {
        var num = list.get(i);
        gs.info(num.getNumber())
    }

### Bereichsbezogenes Äquivalent {#r_N-getPhoneNumbers__section_it5_ktc_1gb}

Zur Verwendung von GetPhoneNumbers() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- getPhoneNumbers()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-getPhoneNumbers "Gibt alle Telefonnummern und Kurzwahlen zurück, die zur Benachrichtigung verfügbar sind.").

## Notify -- getTokens (GlideRecord, Datensatz) {#ariaid-title9}

Gibt Client-Token für alle aktiven Telefonietreiber zur Verwendung in WebRTC- oder mobilen Clients zurück.
{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| record | GlideRecord | GlideRecord, der zur Identifizierung des Notify-Clients verwendet werden soll, z. B. ein Gruppendatensatz oder ein Anwenderdatensatz. |
[Tabelle : 15. Parameter]

{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr} {#r_N-getTokens_GlideRecord__table_wsx_c3n_wr__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Web-RTC-Token für die unterstützten Treiber als JSON-Zeichenfolge mit dem folgenden Format: {DriverName1: „token1", driverName2: „token2"}, z. B. „TwilioDirect":„eyJhxxxx.eyJleHAiOixxxx.7fejxxx_mbLxxx" |
[Tabelle : 16. Rückgaben]

{#r_N-getTokens_GlideRecord__table_wsx_c3n_wr}  
Dieses Beispiel zeigt, wie die Client-Token für den derzeit angemeldeten Anwender abgerufen werden.

    // get Notify client Tokens per active Notify driver for the currently logged in user
    var json = new SNC.Notify().getTokens();
     
    // Parse the JSON that was return into a tokens object
    var tokens = JSON.parse(json);

    // Log line
    gs.log('Notify client tokens for the currently logged in user');

     // iterate over the driver tokens
    for (var driver in tokens) {
     	gs.log(driver + ' Driver token: ' + tokens[driver]);
    }

Dieses Beispiel zeigt, wie die Client-Token für jede Notify-Gruppe abgerufen werden.

    // instantiate Notify
    var notify = new SNC.Notify();
     
    // get all Notify Groups
    var notifyGroup = new GlideRecord("notify_group");
    notifyGroup.query();
     
    // iterate over all notify groups
    while (notifyGroup.next()) {
      // generate Notify Client tokens per active Notify Driver for this group
      var json = notify.getTokens(notifyGroup);
      var tokens = JSON.parse(json);
     
      for (var driver in tokens) {
        gs.log(gs.getMessage("Notify Client token for {0} driver and Notify Group '{1}': {2}", [driver, notifyGroup.getValue('name'), tokens[driver]]));
      }
    }

### Bereichsbezogenes Äquivalent {#r_N-getTokens_GlideRecord__section_x32_ysl_1gb}

Zur Verwendung von GetToken() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- getTokens()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-getTokens_GR "Gibt Client-Token für alle aktiven Telefonietreiber zur Verwendung in WebRTC- oder mobilen Clients zurück.").

## Notify -- getTokenTTL (Zeichenfolgenbesitzer) {#ariaid-title10}

Gibt die maximale Zeit zurück, die eine Clientsitzung für einen angegebenen Telefonietreiber aktiv bleibt, bevor eine automatische Zeitüberschreitung auftritt.
{#Notify-getTokenTTL_S__table_mnj_xqb_zfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Eigentümer | Zeichenfolge | Name des Telefonie-Treibers, für den die Sitzungslänge abgerufen werden soll. Gültige Werte: * Twilio: Für den alten Treiber * TwilioDirect: Für den neuen Treiber {#Notify-getTokenTTL_S__ul_ql5_vgc_1gb} |
[Tabelle : 17. Parameter]

{#Notify-getTokenTTL_S__table_mnj_xqb_zfb} {#Notify-getTokenTTL_S__table_nnj_xqb_zfb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ganzzahl | Maximale Länge der Sitzung (in Sekunden). Standard: 1800 Sekunden |
[Tabelle : 18. Rückgaben]

{#Notify-getTokenTTL_S__table_nnj_xqb_zfb}  
Das folgende Beispiel zeigt, wie diese Methode und die zugehörige Antwort ordnungsgemäß aufgerufen werden. Es wird auch angezeigt, was zurückgegeben wird, wenn ein ungültiger Treiber übergeben wird.

    var owner = "TwilioDirect";  // Valid driver
    var ttl = SNC.Notify.getTokenTTL(owner);
    gs.info("Token TTL for " + owner + " --> " + ttl);
     
    owner = "Abcxyz";  // Invalid driver
    ttl = SNC.Notify.getTokenTTL(owner);
    // For an invalid driver, we throw NoSuchNotifyDriverException saying that Abcxyzdriver is not available
    // and return the default value of TTL
    gs.info("Token TTL for " + owner + " --> " + ttl); 

### Bereichsbezogenes Äquivalent {#Notify-getTokenTTL_S__section_bgp_tk2_1gb}

Zur Verwendung von GetTokenTTL() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- getAvailableClients()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-getTokenTTL_S "Gibt die maximale Zeit zurück, die eine Clientsitzung für einen angegebenen Telefonietreiber aktiv bleibt, bevor eine automatische Zeitüberschreitung auftritt.").

## Notify -- hasCapability (Zeichenfolge notifyPhoneNumber, Zeichenfolgenfähigkeit) {#ariaid-title11}

Bestimmt, ob die angegebene Telefonnummer über die angegebene Fähigkeit verfügt.
Der der Telefonnummer zugeordnete Telefonie-Treiber enthält eine Liste aller Fähigkeiten des Telefons.  
Hinweis:  
Im Basissystem hat der Notify-JS-Treiber nur „Show_speakers" als Fähigkeit. Dies kann geändert werden.
{#Notify-hasCapability_S_S__table_vsy_rdg_yfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| NotifyPhoneNumber | Zeichenfolge | Telefonnummer, für die nach der angegebenen Fähigkeit gesucht werden soll. |
| Fähigkeit | Zeichenfolge | Fähigkeit zur Erkennung. Der Zeichenfolgentext muss genau mit dem im Telefon übereinstimmen. |
[Tabelle : 19. Parameter]

{#Notify-hasCapability_S_S__table_vsy_rdg_yfb} {#Notify-hasCapability_S_S__table_wsy_rdg_yfb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das angegebene Telefon über die angegebene Fähigkeit verfügt. * Wahr: Telefon hat die Fähigkeit * Falsch: Telefon verfügt nicht über die Fähigkeit {#Notify-hasCapability_S_S__ul_ryg_y2g_yfb} |
[Tabelle : 20. Rückgaben]

{#Notify-hasCapability_S_S__table_wsy_rdg_yfb}  
Dieses Beispiel zeigt, wie überprüft wird, ob ein Telefon über eine bestimmte Fähigkeit verfügt.

    // Each driver has a defined set of capabilities.

    var capability = 'show_speakers';
    gs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // true
     
    capability = 'send_sms';
    gs.info(SNC.Notify.hasCapability('+185xxxxxxxx', capability)); // false

### Bereichsbezogenes Äquivalent {#Notify-hasCapability_S_S__section_bgp_tk2_1gb}

Zur Verwendung von HasCapability() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- hasCapability()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-hasCapabilitiy_S_S "Bestimmt, ob die angegebene Telefonnummer über die angegebene Fähigkeit verfügt.").

## Notify -- Kick (GlideRecord-Teilnehmer) {#ariaid-title12}

Entfernt den angegebenen Anrufer aus der aktuellen Notify-Telefonkonferenz.
{#r_N-kick_GlideRecord__table_asm_xdx_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Teilnehmer | GlideRecord | GlideRecord-Objekt, das den Notify-Teilnehmer \[Notify_participant\]-Datensatz des Anrufers enthält, der aus der Telefonkonferenz entfernt werden soll. |
[Tabelle : 21. Parameter]

{#r_N-kick_GlideRecord__table_asm_xdx_ls} {#r_N-kick_GlideRecord__table_bsm_xdx_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 22. Rückgaben]

{#r_N-kick_GlideRecord__table_bsm_xdx_ls}  
Das folgende Beispiel zeigt, wie ein Teilnehmer aus einer Telefonkonferenz entfernt wird.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.kick(notifyParticipantGr);
    }

### Bereichsbezogenes Äquivalent {#r_N-kick_GlideRecord__section_myh_bfd_1gb}

Zur Verwendung von Kick() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- Kick()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-kick_GR "Entfernt den angegebenen Anrufer aus der aktuellen Notify-Telefonkonferenz.").

## Notify -- modifyCall(GlideRecord callRecord, NotifyAction notifyAction) {#ariaid-title13}

Führt eine oder mehrere Aktionen für einen aktiven Notify-Telefonanruf aus.
Zu den verfügbaren Aktionen, die Sie für Anrufe ausführen können, gehören das Anrufen in die Warteschlange oder das Entfernen aus der Warteschlange, das Lesen von Text, die Wiedergabe von Audio oder die Weiterleitung des Anrufs. Sie können auch anwenderdefinierte Aktionen erstellen, die aufrufen ModifyCall() Methode, nachdem Sie alle Aktionen angegeben haben, die Sie auf den angegebenen Aufruf anwenden möchten. Weitere Informationen finden Sie unter [Benachrichtigungsaktion](https://servicenow-prod.fluidtopics.net/1sWCeHfXDMuDfcFjkKNv4g#c_NotifyActionApi "Die Benachrichtigungsaktion Mit der API können Sie Aktionen definieren, die an einen Telefonieanbieter gesendet werden sollen.")API-Dokumentation für weitere Informationen zu verfügbaren Aktionen.
{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Calldatensatz | GlideRecord | Notify-Anruf \[Notify_Call\]-Datensatz des Anrufs, für den die Aktionen angewendet werden sollen. |
| NotifyAction | Benachrichtigungsaktion | NotifyAction-Objekt, das eine oder mehrere Aktionen beschreibt, die für den Anruf ausgeführt werden sollen. Erstellen Sie dieses Objekt, indem Sie mindestens eines aufrufen Benachrichtigungsaktion() Methoden. |
[Tabelle : 23. Parameter]

{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr} {#r_N-modifyCall_GR_NA__table_srh_gzn_wr__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 24. Rückgaben]

{#r_N-modifyCall_GR_NA__table_srh_gzn_wr}  
Dieses Beispiel zeigt, wie ein Anruf geändert wird.

    // get the most recent call record
    var callRecord = new GlideRecord('notify_call');
    callRecord.orderByDesc('sys_created_on');
    callRecord.query();
     
    if (callRecord.next()) {
        // instantiate notify action container class
        var notifyAction = new SNC.NotifyAction();
        // The call is already in progress. Now, we want to modify the call behavior by putting this call in a queue.
        // So, we add a queue action to queue the call
        notifyAction.addQueue('my fancy queue');
       
        // modify the call by passing in the above action, putting the call in a queue
        new SNC.Notify().modifyCall(callRecord, notifyAction);
    } else {
        gs.log('no such call record');
    }

### Bereichsbezogenes Äquivalent {#r_N-modifyCall_GR_NA__section_a4l_chd_1gb}

Zur Verwendung von ModifyCall() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- modifyCall()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-modifyCall_GR_NA "Führt eine oder mehrere Aktivitäten für einen aktiven Notify-Telefonanruf aus.").

## Notify -- stummschalten (GlideRecord partiantRecord) {#ariaid-title14}

Schaltet den angegebenen Konferenzteilnehmer stumm.
{#Notify-mute_GR__table_bch_xfg_yfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Partizipierender Datensatz | GlideRecord | GlideRecord aus der Tabelle Notify_participant, damit der Teilnehmer stummgeschaltet werden kann. |
[Tabelle : 25. Parameter]

{#Notify-mute_GR__table_bch_xfg_yfb} {#Notify-mute_GR__table_cch_xfg_yfb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 26. Rückgaben]

{#Notify-mute_GR__table_cch_xfg_yfb}  
Das folgende Beispiel zeigt, wie ein Anrufer stummgeschaltet wird.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.mute(notifyParticipantGr);
    }

### Bereichsbezogenes Äquivalent

Zur Verwendung von Stummschalten () Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- stummschalten()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-mute_GR "Schaltet den angegebenen Konferenzteilnehmer stumm.").

## Notify -- Warteschlangenruf (GlideRecord callRecord) {#ariaid-title15}

Legt den angegebenen Anruf in eine Warteschlange (angehalten).
Setzen Sie einen Anruf in der Warteschlange mit fort DewareCall() Methode.
{#r_N-queueCall_GlideRecord__table_uhl_mcy_js__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Calldatensatz | GlideRecord | GlideRecord-Objekt des Notify-Anrufdatensatzes (Notify_call-Tabelle), der angehalten werden soll. |
[Tabelle : 27. Parameter]

{#r_N-queueCall_GlideRecord__table_uhl_mcy_js} {#r_N-queueCall_GlideRecord__table_vhl_mcy_js__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 28. Rückgaben]

{#r_N-queueCall_GlideRecord__table_vhl_mcy_js}  
Das folgende Beispiel zeigt, wie ein Anruf in den Wartestatus versetzt wird (in der Warteschlange).

    var notifyCallGr = new GlideRecord('notify_call');
    notifyCallGr.get('active participant sys id');
     
    if (notifyCallGr.isValid) {
        SNC.Notify.queueCall(notifyCallGr);
    }

### Bereichsbezogenes Äquivalent

Zur Verwendung von Warteschlangenaufruf() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- QueueCall()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-queueCall_GR "Legt den angegebenen Anruf in eine Warteschlange (angehalten).").

## Notify -- sendBulkSMS (Zeichenfolge notifyPhoneNumber, Array zu PhoneNumbers, Zeichenfolge messageBody, GlideRecord-Quelle) {#ariaid-title16}

Sendet eine angegebene SMS-Nachricht an die angegebene Liste der Notify-Clients (Telefonnummern).
{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| NotifyPhoneNumber | Zeichenfolge | Notify-Telefonnummer, von der die SMS-Nachricht gesendet wird. |
| Zu PhoneNumbers | Array aus Zeichenfolgen | Kommagetrennte Liste von Telefonnummern, an die die SMS-Nachricht gesendet werden soll. Format: E.164 |
| MessageBody | Zeichenfolge | Zu sendender SMS-Text. |
| Quelle | GlideRecord | Quelldatensatz, der diese SMS-Nachricht ausgelöst hat, z. B. ein Incident. |
[Tabelle : 29. Parameter]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb} {#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Null |
[Tabelle : 30. Rückgaben]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb}  
Das folgende Beispiel zeigt, wie eine Massen-SMS-Nachricht gesendet wird.

    var incidentGr = new GlideRecord('incident');
    incidentGr.get(active incident sys_id');
    if (incidentGr.isValid()) {
        SNC.Notify.sendBulkSMS('+15413970605', ['+919885XXXXXX', '+919775XXXXXX'], 'Test automation message', incidentGr);
    }

### Bereichsbezogenes Äquivalent

Zur Verwendung von GesendBulkSMS() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- sendBulkSMS()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-sendBulkSMS_NPN_S_S_GR "Sendet eine angegebene SMS-Nachricht an die angegebene Liste der Notify-Clients (Telefonnummern).").

## Notify -- sendSMS (Zeichenfolge notifyPhoneNumber, Zeichenfolge zu PhoneNumber, Zeichenfolge messageBody, GlideRecord-Quelle) {#ariaid-title17}

Sendet eine SMS-Textnachricht an eine E.164-konforme Telefonnummer.
Diese Methode erstellt einen neuen Datensatz in der Notify-Nachricht \[Notify_message\]-Tabelle und ordnet ihn dem Quelldatensatz zu.
{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| NotifyPhoneNumber | Zeichenfolge | Notify-Telefonnummer, von der die SMS-Nachricht gesendet wird. |
| Zu PhoneNumber | Zeichenfolge | E.164-konforme Telefonnummer, an die die SMS-Nachricht gesendet werden soll. |
| MessageBody | Zeichenfolge | Textkörper der SMS-Textnachricht. |
| Quelle | GlideRecord | Quelldatensatz, der diese SMS-Nachricht ausgelöst hat, z. B. ein Incident. |
[Tabelle : 31. Parameter]

{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr} {#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eindeutige Nachrichten-SID; im Notify-Nachricht \[Notify_message\]-Datensatz als Message_ID gespeichert |
[Tabelle : 32. Rückgaben]

{#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr}  
Das folgende Beispiel zeigt, wie eine SMS-Nachricht gesendet wird.

    var incidentGr = new GlideRecord('incident');
    incidentGr.get('active incident sys_id');
    if (incidentGr.isValid()) {
        SNC.Notify.sendSMS('+15413970605', '+919885XXXXXX', 'Test automation message', incidentGr);
    }

### Bereichsbezogenes Äquivalent {#r_N-sendSMS_NPN_S_S_GR__section_kby_cyc_1gb}

Zur Verwendung von GesendSMS() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- sendSMS()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-sendSMS_NPN_S_S_GR "Sendet eine SMS-Textnachricht an eine E.164-konforme Telefonnummer.").

## Notify -- Stummschaltung aufheben (GlideRecord partiantRecord) {#ariaid-title18}

Hebt die Stummschaltung des angegebenen Konferenzteilnehmers auf.
{#Notify-unmute_GR__table_v1w_p3g_yfb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Partizipierender Datensatz | GlideRecord | GlideRecord aus der Tabelle Notify_participant, damit der Teilnehmer die Stummschaltung aufheben kann. |
[Tabelle : 33. Parameter]

{#Notify-unmute_GR__table_v1w_p3g_yfb} {#Notify-unmute_GR__table_w1w_p3g_yfb__entry__2}

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 34. Rückgaben]

{#Notify-unmute_GR__table_w1w_p3g_yfb}  
Das folgende Beispiel zeigt, wie die Stummschaltung eines Anrufers aufgehoben wird.

    var notifyParticipantGr = new GlideRecord('notify_participant');
    notifyParticipantGr.get('active participant sys id');
     
    if (notifyParticipantGr.isValid) {
        SNC.Notify.unmute(notifyParticipantGr);
    }

### Bereichsbezogenes Äquivalent {#Notify-unmute_GR__section_a4l_chd_1gb}

Zur Verwendung von Stummschaltung aufheben () Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: [NotifyScoped -- unstummschalten()](https://servicenow-prod.fluidtopics.net/_YghYXpkntog11CUsWXupw#NotifyScoped-unmute_GR "Hebt die Stummschaltung des angegebenen Konferenzteilnehmers auf.").

