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


---

# NotifyNow (veraltet) -- Global

# NotifyNow (veraltet) -- Global {#ariaid-title1}

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

Das Legacy Benachrichtigung Die API bietet Funktionen zum Senden von E-Mails, zum Senden von SMS-Nachrichten und zum Einrichten von Telefonkonferenzen.  
Verwenden Sie diese Option, wenn Sie die Notify-Funktionalität mit Anwendungen auf Ihrem System verwenden möchten.  
Hinweis:  
Diese API ist in der Legacy-Notify-Funktionalität enthalten. APIs, die in der aktuellen Notify-Funktion enthalten sind, finden Sie unter Benachrichtigen , Benachrichtigungsaktion , Benachrichtigungs-Telefonnummer , Und Benachrichtigungs-Client APIs.

## NotifyNow -- addConferenceCallParticipant(Zeichenfolge conferenceCall, Zeichenfolgenteilnehmer) {#ariaid-title2}

Fügt einer laufenden Telefonkonferenz Ad-hoc-Anwender hinzu.
Wenn die Methode mit einer Telefonnummer für den Teilnehmerparameter aufgerufen wird und genau ein sys_user-Datensatz vorhanden ist, der der Telefonnummer entspricht, wird dieser sys_user-Datensatz mit dem Teilnehmer verknüpft. Das Feld „Telefonnummer" des Teilnehmers wird leer gelassen, da sich die Telefonnummer im Datensatz „sys_user" befindet. Wenn mehrere sys_user-Datensätze vorhanden sind, die mit der Telefonnummer übereinstimmen, oder wenn keine Ergebnisse vorliegen, wird das Telefonnummernfeld des Teilnehmers ausgefüllt, und es wird keine gespeicherte Referenz auf sys_user gespeichert, da der Anwender nicht bekannt ist.
{#r_NN-addConfCallParticipant-S_S__table_bqd_kzd_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Konferenzanruf | Zeichenfolge oder GlideRecord | Die sys_ID oder GlideRecord einer aktiven Telefonkonferenz. |
| Teilnehmer | Zeichenfolge oder GlideRecord | Die sys_ID oder GlideRecord eines Anwenders mit einer E.164-konformen Telefonnummer oder einer E.164-konformen Telefonnummer. |
[Tabelle : 1. Parameter]

{#r_NN-addConfCallParticipant-S_S__table_bqd_kzd_vt} {#r_NN-addConfCallParticipant-S_S__table_cqd_kzd_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | Der Teilnehmerdatensatz des neuen Teilnehmers, der der Telefonkonferenz hinzugefügt wurde. |
[Tabelle : 2. Rückgaben]

{#r_NN-addConfCallParticipant-S_S__table_cqd_kzd_vt}  

    // add a new participant by conference call sys_id (string) and phone number (string) 
    var nn = new SNC.NotifyNow();
    gs.log(nn.addConferenceCallParticipant('d193b242eb020100a04d4910f206fe39', '+31612345678'));

    // add a new participant by conference call sys_id (string) and user record (GlideRecord)
    var user = new GlideRecord('sys_user');
    user.query('user_name', 'myUserName');
    if (user.hasNext() && user.next()) {
        var nn = new SNC.NotifyNow();
        gs.log(nn.addConferenceCallParticipant('d193b242eb020100a04d4910f206fe39', user));
     
        // you could have added the user by sys_id as well:
        // nn.addConferenceCallParticipant('d193b242eb020100a04d4910f206fe39', user.getValue('sys_id'));
    } else {
        gs.log('no such user');
    }

    // add a new participant by conference call record (GlideRecord) and phone number (string)
    var conferenceCall = new GlideRecord('notifynow_conference_call');
    conferenceCall.query('title', 'IA0001001');
    if (conferenceCall.hasNext() && conferenceCall.next()) {
        var nn = new SNC.NotifyNow();
        gs.log(nn.addConferenceCallParticipant(conferenceCall, '+31612345678'));
    } else {
        gs.log('no such conference call');
    }

## NotifyNow -- convertLocalPhoneNumberToE164(Zeichenfolge userID, Zeichenfolge phoneNumber) {#ariaid-title3}

Konvertiert eine lokale Telefonnummer basierend auf dem Standort eines Anwenders in eine E.164-konforme Telefonnummer.
{#r_NN-convertLocNumToE164_S_S__table_wv2_b22_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| userID | Zeichenfolge | Die sys_ID eines sys_user-Datensatzes, von dem Standortinformationen abgerufen werden sollen. |
| phoneNumber | Zeichenfolge | Die Telefonnummer. |
[Tabelle : 3. Parameter]

{#r_NN-convertLocNumToE164_S_S__table_wv2_b22_vt} {#r_NN-convertLocNumToE164_S_S__table_xv2_b22_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die E.164-konforme Telefonnummer. |
[Tabelle : 4. Rückgaben]

{#r_NN-convertLocNumToE164_S_S__table_xv2_b22_vt}  

    var localPhoneNumber = '01784 221600';
    var userName = 'Heath Vanalphen';
     
    var user = new GlideRecord('sys_user');
    user.get('name',userName);
    var E164Number = new SNC.NotifyNow().convertLocalPhoneNumberToE164(user.getUniqueValue(), localPhoneNumber);
    gs.log('converted: ' + localPhoneNumber + ' to ' + E164Number + ' based on ' + user.getValue('name') + 
         '\'s location (' + user.getValue('location') + ')');

## NotifyNow -- getConferenceCallParticipants (Zeichenfolge conferenceCallId, boolescher isCallable) {#ariaid-title4}

Gibt alle Teilnehmer für eine Telefonkonferenz zurück.
{#r_NN-getConfCallParticipants_S_B__table_ff3_l12_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ConferenceCallId | Zeichenfolge | Die ID der Telefonkonferenz. |
| IsCallable | Boolean | Eine optionale Kennzeichnung, die entweder nur die Anwender zurückgibt, die Sie anrufen können (wahr) oder die, die Sie nicht anrufen können (falsch). |
[Tabelle : 5. Parameter]

{#r_NN-getConfCallParticipants_S_B__table_ff3_l12_vt} {#r_NN-getConfCallParticipants_S_B__table_gf3_l12_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | Die Teilnehmer |
[Tabelle : 6. Rückgaben]

{#r_NN-getConfCallParticipants_S_B__table_gf3_l12_vt}  

    var nn = new SNC.NotifyNow();
    var user = nn.getConferenceCallParticipants('c2e91710eb120100f34087b9d106fe37');
     
    while (user.hasNext() && user.next()) {
        if (user.getValue('participant')) {
            gs.log('user: ' + user.getValue('sys_id'));
        } else {
            gs.log('phone number: ' + user.getValue('phone_number'));
        }
    }

    var nn = new SNC.NotifyNow();
    var user = nn.getConferenceCallParticipants('c2e91710eb120100f34087b9d106fe37', true);
     
    while (user.hasNext() && user.next()) {
        if (user.getValue('participant')) {
            gs.log('user: ' + user.getValue('sys_id'));
        } else {
            gs.log('phone number: ' + user.getValue('phone_number'));
        }
    }

    var conferenceCallId = '32b11430eb1201003cf587b9d106feb8';
     
    // get all participants
    gs.log('all conference call participants:');
    var nn = new SNC.NotifyNow();
    var user = nn.getConferenceCallParticipants(conferenceCallId);
    gs.log(user);
     
    // get all callable participants
    gs.log('all conference call participants we can call:');
    user = nn.getConferenceCallParticipants(conferenceCallId, true);
    gs.log(user);
     
    // get all un callable participants
    gs.log('all conference call participants that are already in an active session and whom we cannot call:');
    user = nn.getConferenceCallParticipants(conferenceCallId, false);
    gs.log(user);

## NotifyNow -- getFrequentlyCalledUsers (Nummernlimit) {#ariaid-title5}

Gibt eine Anzahl häufig aufgerufener Anwender bis zum Grenzwertparameter in alphabetischer Reihenfolge zurück.
{#r_NN-getFrequentlyCalledUsers_N__table_av3_xb2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| limit | Nummer | Die maximale Anzahl von Ergebnissen. |
[Tabelle : 7. Parameter]

{#r_NN-getFrequentlyCalledUsers_N__table_av3_xb2_vt} {#r_NN-getFrequentlyCalledUsers_N__table_bv3_xb2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | Die häufig aufgerufenen Anwender in alphabetischer Reihenfolge. |
[Tabelle : 8. Rückgaben]

{#r_NN-getFrequentlyCalledUsers_N__table_bv3_xb2_vt}  

    var nn = new SNC.NotifyNow();
    var fc = nn.getFrequentlyCalledUsers(10);
     
    while (fc.hasNext() && fc.next()) {
        gs.log("got user " + fc.getValue('name') + ' - ' + fc.getValue('sys_id'));
    }

## NotifyNow -- getPreferredE164SMSNumber (GlideRecord-Anwender) {#ariaid-title6}

Gibt die bevorzugte E.164-konforme Telefonnummer eines Anwenders für SMS-Nachrichten zurück.
{#r_NN-getPreferredE164SMSNumber_GR__table_pl2_tz2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Anwender | GlideRecord oder Zeichenfolge | Der Anwenderdatensatz oder die sys_ID eines Anwenders, von dem die E.164-konforme Telefonnummer abgerufen werden soll. |
[Tabelle : 9. Parameter]

{#r_NN-getPreferredE164SMSNumber_GR__table_pl2_tz2_vt} {#r_NN-getPreferredE164SMSNumber_GR__table_ql2_tz2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die E.164-konforme Telefonnummer oder Null. |
[Tabelle : 10. Rückgaben]

{#r_NN-getPreferredE164SMSNumber_GR__table_ql2_tz2_vt}  

    var userID = "<user sys_id>";
    var E164Number = new SNC.NotifyNow().getPreferredE164SMSNumber(userID);
    gs.log('the preferred phone number for sending SMS notifications is ' + E164Number + ' for user with id: ' + userID);

## NotifyNow -- getPreferredE164VoiceNumber (GlideRecord-Anwender) {#ariaid-title7}

Gibt die bevorzugte E.164-konforme Telefonnummer eines Anwenders für Sprachanrufe zurück.
{#r_NN-getPrefE164VoiceNumber_GR__table_pl2_tz2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Anwender | GlideRecord oder Zeichenfolge | Der Anwenderdatensatz oder die sys_ID eines Anwenders, von dem die E.164-konforme Telefonnummer abgerufen werden soll. |
[Tabelle : 11. Parameter]

{#r_NN-getPrefE164VoiceNumber_GR__table_pl2_tz2_vt} {#r_NN-getPrefE164VoiceNumber_GR__table_ql2_tz2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die E.164-konforme Telefonnummer oder Null. |
[Tabelle : 12. Rückgaben]

{#r_NN-getPrefE164VoiceNumber_GR__table_ql2_tz2_vt}  

    var userID = "<user sys_id>";
    var E164Number = new SNC.NotifyNow().getPreferredE164VoiceNumber(userID);
    gs.log('the preferred phone number for setting up voice calls is ' + E164Number + ' for user with id: ' + userID);

## NotifyNow -- getPreferredEmailAddress (GlideRecord-Anwender) {#ariaid-title8}

Gibt die bevorzugte E-Mail-Adresse eines Anwenders zurück
{#r_NN-getPreferredEmailAddress_GR__table_pl2_tz2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Anwender | GlideRecord oder Zeichenfolge | Der Anwenderdatensatz oder die sys_ID eines Anwenders, von dem die E-Mail-Adresse abgerufen werden soll. |
[Tabelle : 13. Parameter]

{#r_NN-getPreferredEmailAddress_GR__table_pl2_tz2_vt} {#r_NN-getPreferredEmailAddress_GR__table_sqx_lbf_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die E-Mail-Adresse oder Null. |
[Tabelle : 14. Rückgaben]

{#r_NN-getPreferredEmailAddress_GR__table_sqx_lbf_vt}  

    var userID = "some user sys id";
    var email = new SNC.NotifyNow().getPreferredEmailAddress(userID);
    gs.log('the preferred email address for sending email notifications is ' + email + ' for user with id: ' + userID);

## NotifyNow -- getReadyState() {#ariaid-title9}

Gibt an, ob Notify richtig eingerichtet ist oder nicht.
Auf diese Methode können nur Administratoren oder Anwender mit der Rolle „notifynow_admin" zugreifen. Anwender mit allen anderen Rollen erhalten die Meldung falsch, wenn sie versuchen, die Funktion in einem Skript auszuführen.
{#r_NN-getReadyState__table_vtn_bd2_vt__entry__3}

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

{#r_NN-getReadyState__table_vtn_bd2_vt} {#r_NN-getReadyState__table_wtn_bd2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn „Notify" korrekt eingerichtet ist, andernfalls „falsch". |
[Tabelle : 16. Rückgaben]

{#r_NN-getReadyState__table_wtn_bd2_vt}  

    var nn = new SNC.NotifyNow();
    gs.log(((nn.getReadyState()) ? "OK" :  "NOT OK"));

## NotifyNow -- getStatus() {#ariaid-title10}

Gibt den aktuellen Status der Notify-Konfiguration zurück.
Auf diese Methode können nur Administratoren oder Anwender mit der Rolle „notifynow_admin" zugreifen. Anwender mit allen anderen Rollen erhalten die Nachricht nicht autorisiert, wenn sie versuchen, die Funktion in einem Skript auszuführen.
{#r_NN-getStatus__table_txg_fc2_vt__entry__3}

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

{#r_NN-getStatus__table_txg_fc2_vt} {#r_NN-getStatus__table_uxg_fc2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Eine der möglichen Statusnachrichten. |-|-| | Status | Beschreibung | | NO_NUMBER_MESSAGE | Für den Account ist keine Telefonnummer eingerichtet. Stellen Sie sicher, dass Sie die Telefonnummer für den Account eingerichtet haben. | | NO_ENDPOINTS_MESSAGE | Die Endpunkte des Accounts sind nicht ordnungsgemäß eingerichtet. Stellen Sie sicher, dass Sie die Endpunkte für den Account einrichten. | | ACCOUNT_OK_MESSAGE | Der Account ist aktiv und einsatzbereit. | | ACCOUNT_NO_AUTH | Das Twilio AuthToken ist ungültig. | | ACCOUNT_NOT_CONFIGURED | Twilio AccountSID oder AuthToken ist ungültig. | [ ] {#r_NN-getStatus__table_gdb_jc2_vt} |
[Tabelle : 18. Rückgaben]

{#r_NN-getStatus__table_uxg_fc2_vt}  

    var nn = new SNC.NotifyNow();
    gs.log(nn.getStatus());

## NotifyNow -- initiateConferenceCall(Zeichenfolge\[\] conferenceCallParticipants, Zeichenfolge conferenceCallTitle) {#ariaid-title11}

Initiieren Sie eine neue Telefonkonferenz.
{#r_NN-initiateConfCall_S_S__table_gvb_hyd_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ConferenceCallteilnehmer | Zeichenfolge | Ein oder mehrere Anwender, Konferenzteilnehmer, identifiziert durch die sys_IDs aus der Tabelle „sys_user" oder E.164-konforme Telefonnummern. |
| ConferenceCallTitle | Zeichenfolge | Titel der Telefonkonferenz. Dieser Parameter hat eine maximale Länge von 40 Zeichen. |
[Tabelle : 19. Parameter]

{#r_NN-initiateConfCall_S_S__table_gvb_hyd_vt} {#r_NN-initiateConfCall_S_S__table_hvb_hyd_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | Der Telefonkonferenzdatensatz oder Null, wenn ein Fehler aufgetreten ist. |
[Tabelle : 20. Rückgaben]

{#r_NN-initiateConfCall_S_S__table_hvb_hyd_vt}  
Dadurch wird eine Telefonkonferenz mit E.164-konformen Telefonnummern für Teilnehmer ohne den optionalen Quelldatensatzparameter und initiiert und keine Telefonkonferenzdetails per SMS oder E-Mail gesendet.

    var participants = ['+31205655548', '+31205655552', '+31652825393'];
    // set up conference call
    var nn = new SNC.NotifyNow();
    var conferenceCall = nn.initiateConferenceCall(participants, "testing12");
    gs.log('started conference call: ' + conferenceCall.getUniqueValue());

## NotifyNow -- initiateConferenceCall(Zeichenfolge\[\] conferenceCallParticipants, Zeichenfolge conferenceCallTitle, GlideRecord sourceRecord, boolescher Wert privat) {#ariaid-title12}

Initiieren Sie eine neue Telefonkonferenz.
{#r_NN-initiateConfCall_S_S_GR_B__table_gvb_hyd_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ConferenceCallteilnehmer | Zeichenfolge | Ein oder mehrere Anwender, Konferenzteilnehmer, identifiziert durch die sys_IDs aus der Tabelle „sys_user" oder E.164-konforme Telefonnummern. |
| ConferenceCallTitle | Zeichenfolge | Titel der Telefonkonferenz. Dieser Parameter hat eine maximale Länge von 40 Zeichen. |
| QuelleDatensatz | GlideRecord | Quelldatensatz, der der Telefonkonferenz zugeordnet werden soll, z. B. eine Incident- oder Problemnummer. |
| Privat | Boolean | Wert, der steuert, ob eine Telefonkonferenz privat ist. Dieser Wert ist standardmäßig auf „falsch" festgelegt. |
[Tabelle : 21. Parameter]

{#r_NN-initiateConfCall_S_S_GR_B__table_gvb_hyd_vt} {#r_NN-initiateConfCall_S_S_GR_B__table_hvb_hyd_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | Der Telefonkonferenzdatensatz oder Null, wenn ein Fehler aufgetreten ist. |
[Tabelle : 22. Rückgaben]

{#r_NN-initiateConfCall_S_S_GR_B__table_hvb_hyd_vt}  
Dadurch wird eine Telefonkonferenz mit Teilnehmern initiiert, die über eine E.164-konforme Telefonnummer und Teilnehmern aus der Tabelle „sys_user" verfügen, und Details zu Telefonkonferenzen werden per SMS und E-Mail an alle Teilnehmer gesendet.

    // define phone number participants
    var participants = ['+31205655548', '+31205655552', '+31652825393'];
     
    // we also want to add two Dutch sys_user participants
    var user = new GlideRecord('sys_user');
    user.addNotNullQuery('mobile_phone');
    user.addQuery('mobile_phone', 'STARTSWITH', '+316');
    user.setLimit(2);
    user.query();
     
    // add users to the participant array
    while (user.hasNext() && user.next()) {
    	gs.log('adding user ' + user.getValue('name') + ' with phone number ' + 
                 user.getValue('mobile_phone') + ' to the participant array');
    	participants.push(user.getUniqueValue());
    }
     
    // define a source record to associate with the conference call
    var source = new GlideRecord("cmdb_ci");
    source.query("asset_tag", "P1000167");
    if (source.hasNext() && source.next()) {
    	// set up conference call
    	var nn = new SNC.NotifyNow();
    	var conferenceCall = nn.initiateConferenceCall(participants, "testing 1 2", source);
     
    	// check if the conference call was successfully created
    	if (conferenceCall != null) {
    		gs.log('started conference call: ' + conferenceCall.getUniqueValue());
    	} else {
    		gs.log('could not start the conference call :(');
    	}
    }

## NotifyNow -- isCallable (Zeichenfolgenteilnehmer) {#ariaid-title13}

Bestimmt, ob ein Anwender aufrufbar ist oder nicht.
Ein Anwender muss über eine gültige Telefonnummer verfügen, um aufrufbar zu sein. Ein Anwender, der sich bereits in einer aktiven Sitzung befindet, kann nicht aufgerufen werden.
{#r_NN-isCallable_S__table_z3r_pb2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Teilnehmer | Zeichenfolge oder GlideRecord | Ein sys_user- oder notifynow_participant-Datensatz oder eine E.164-konforme Telefonnummer. |
[Tabelle : 23. Parameter]

{#r_NN-isCallable_S__table_z3r_pb2_vt} {#r_NN-isCallable_S__table_ajr_pb2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| boolean | Gibt an, ob dieser Teilnehmer angerufen werden kann oder nicht. |
[Tabelle : 24. Rückgaben]

{#r_NN-isCallable_S__table_ajr_pb2_vt}  

    var nn = new SNC.NotifyNow();
    gs.log('by number: ' + nn.isCallable('+31612345678'));
     
    var user = GlideRecord('sys_user');
    user.query('sys_id', '13d39544eb5201003cf587b9d106fea9');
    if (user.hasNext() && user.next())
      gs.log('by user: ' + nn.isCallable(user));
     
    var participant = GlideRecord('notifynow_participant');
    participant.query('sys_id', '33b11430eb1201003cf587b9d106feb9');
    if (participant.hasNext() && participant.next())
      gs.log('by participant: ' + nn.isCallable(participant));

## NotifyNow -- isSMSCapable() {#ariaid-title14}

Überprüft, ob die dem Twilio-Account zugeordnete Telefonnummer SMS-Nachrichten senden kann.
{#r_NN-isSMSCapable__table_zp5_nf2_vt__entry__3}

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

{#r_NN-isSMSCapable__table_zp5_nf2_vt} {#r_NN-isSMSCapable__table_aq5_nf2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Gibt an, ob die dem Twilio-Account zugeordnete Telefonnummer SMS-Nachrichten senden kann. |
[Tabelle : 26. Rückgaben]

{#r_NN-isSMSCapable__table_aq5_nf2_vt}  

    gs.log('The twilio number is SMS capable: ' + ((new SNC.NotifyNow().isSMSCapable()) ? 'yes' : 'no'));

## NotifyNow -- isSMSCapable(Zeichenfolge userID) {#ariaid-title15}

Überprüft, ob ein Anwender SMS-Nachrichten senden kann.
{#r_NN-isSMSCapable_S__table_i1m_cf2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| userID | Zeichenfolge | Die sys_ID des Anwenders, den Sie nach einer SMS-fähigen Telefonnummer suchen möchten. |
[Tabelle : 27. Parameter]

{#r_NN-isSMSCapable_S__table_i1m_cf2_vt} {#r_NN-isSMSCapable_S__table_j1m_cf2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Ob der Anwender SMS-Nachrichten senden kann. |
[Tabelle : 28. Rückgaben]

{#r_NN-isSMSCapable_S__table_j1m_cf2_vt}  

    gs.log('the user is able to send SMS messages (e.g. has a SMS device): ' + ((new SNC.NotifyNow().isSMSCapable('<user sys_id>')) ? 
         'yes' : 'no'));

## NotifyNow -- isVoiceCapable() {#ariaid-title16}

Überprüft, ob die dem Twilio-Account zugeordnete Telefonnummer Telefonanrufe einrichten kann.
{#r_NN-isVoiceCapable__table_ct2_qg2_vt__entry__3}

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

{#r_NN-isVoiceCapable__table_ct2_qg2_vt} {#r_NN-isVoiceCapable__table_dt2_qg2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Gibt an, ob die dem Twilio-Account zugeordnete Telefonnummer Telefonanrufe einrichten kann. |
[Tabelle : 30. Rückgaben]

{#r_NN-isVoiceCapable__table_dt2_qg2_vt}  

    gs.log('the Twilio number is Voice capable: ' + ((new SNC.NotifyNow().isVoiceCapable()) ? 'yes' : 'no'));

## NotifyNow -- isVoiceCapable (Zeichenfolge userID) {#ariaid-title17}

Überprüft, ob ein Anwender Sprachanrufe tätigen kann.
{#r_NN-isVoiceCapable_S__table_gdb_jg2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| userID | Zeichenfolge | Die sys_ID des Anwenders, den Sie auf eine Sprachanruffähige Telefonnummer überprüfen möchten. |
[Tabelle : 31. Parameter]

{#r_NN-isVoiceCapable_S__table_gdb_jg2_vt} {#r_NN-isVoiceCapable_S__table_hdb_jg2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| boolean | Gibt an, ob der Anwender über eine Sprachanruf-fähige Telefonnummer verfügt. |
[Tabelle : 32. Rückgaben]

{#r_NN-isVoiceCapable_S__table_hdb_jg2_vt}  

    gs.log('the user is able to send SMS messages (e.g. has a SMS device): ' + 
         ((new SNC.NotifyNow().isVoiceCapable('someuserid')) ? 'yes' : 'no'));

## NotifyNow -- Kick (GlideRecord-Teilnehmer) {#ariaid-title18}

Entfernt einen Teilnehmer aus einer Telefonkonferenz.
{#r_NN-kick_GR__table_jfq_fcf_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Teilnehmer | GlideRecord | Der Teilnehmer der Telefonkonferenz, der aus dem Anruf entfernt werden soll. |
[Tabelle : 33. Parameter]

{#r_NN-kick_GR__table_jfq_fcf_vt} {#r_NN-kick_GR__table_kfq_fcf_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn der Teilnehmer entfernt wurde, andernfalls „falsch". |
[Tabelle : 34. Rückgaben]

{#r_NN-kick_GR__table_kfq_fcf_vt}  

    var participantId = "<participant sys_id>";
    var participant = new GlideRecord('notifynow_participant');
    participant.get(participantId);
    if (participant.isValid()) {
         // kick participant
         result = new SNC.NotifyNow().kick(participant);
         gs.log('participant kicked: ' + result);
    }

## NotifyNow -- stummschalten (GlideRecord-Teilnehmer) {#ariaid-title19}

Schaltet einen Teilnehmer in einer Telefonkonferenz stumm.
{#r_NN-mute_GR__table_lz4_rbf_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Teilnehmer | GlideRecord | Der Teilnehmer der Telefonkonferenz, der stummgeschaltet werden soll. |
[Tabelle : 35. Parameter]

{#r_NN-mute_GR__table_lz4_rbf_vt} {#r_NN-mute_GR__table_mz4_rbf_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn der Teilnehmer stummgeschaltet wurde, andernfalls „falsch". |
[Tabelle : 36. Rückgaben]

{#r_NN-mute_GR__table_mz4_rbf_vt}  

    var participantId = "<participant sys_id>";
    var participant = new GlideRecord('notifynow_participant');
    participant.get(participantId);
    if (participant.isValid()) {
         // mute participant
         result = new SNC.NotifyNow().mute(participant);
         gs.log('participant muted: ' + result);
    }

## NotifyNow -- sendEmailQuestion(Zeichenfolge eMail Adresse, Zeichenfolgenfrage, GlideRecord sourceRecord, Zeichenfolge eMail Subject) {#ariaid-title20}

Senden Sie eine E-Mail-Frage an eine E-Mail-Adresse.
Die sendEmailQuestion-Methode erstellt einen Fragetext und erfordert, dass Anwender auf einen Link klicken, um ihre Auswahl anzugeben.
{#r_NN-sendEmailQuestion_S_S_GR_S__table_g5f_fy2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| emailAddress | Zeichenfolge | E-Mail-Adresse, an die die Frage gesendet werden soll. |
| Frage | Zeichenfolge oder GlideRecord | Der zu sendende Fragendatensatz oder die sys_ID eines Fragendatensatzes. |
| QuelleDatensatz | GlideRecord | Ein optionaler Quelldatensatz, der der SMS-Frage zugeordnet werden soll, z. B. ein Incident. |
| E-Mail-Absenden | Zeichenfolge | Optionaler Text zum Überschreiben des Standard-E-Mail-Betreffs. |
[Tabelle : 37. Parameter]

{#r_NN-sendEmailQuestion_S_S_GR_S__table_g5f_fy2_vt} {#r_NN-sendEmailQuestion_S_S_GR_S__table_h5f_fy2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die sys_ID der Konversation |
[Tabelle : 38. Rückgaben]

{#r_NN-sendEmailQuestion_S_S_GR_S__table_h5f_fy2_vt}  
Dieses Beispiel demonstriert die Verwendung des standardmäßigen E-Mail-Betreffs.

    var user = GlideRecord("sys_user");
    user.get("email", "someone@somedomain.com");
     
    new SNC.NotifyNow().sendEmailQuestion(user.getValue('email'), "b6b34500bf3111003cf585ce2c0739ce", user);

Dieses Beispiel verwendet Dot-Walking und gibt einen Quelldatensatz und einen E-Mail-Betreff an.

    new SNC.NotifyNow().sendEmailQuestion("someone@somedomain.com", "b6071733bf1111003cf585ce2c07390f", current, 
            "Please answer this question");

Dieses Beispiel verwendet Dot-Walking und gibt einen E-Mail-Betreff, aber keinen Quelldatensatz an.

    new SNC.NotifyNow().sendEmailQuestion("someone@somedomain.com", "b6071733bf1111003cf585ce2c07390f", 
            "Please answer this question");

## NotifyNow -- sendSMS (Zeichenfolge phoneNumber, Zeichenfolge smsBody) {#ariaid-title21}

Sendet eine SMS-Nachricht an eine E.164-konforme Mobiltelefonnummer.
Notify unterstützt internationale Nummern. Wenn Sie diese Methode mit einer Nummer verwenden, die das Senden von SMS-Nachrichten nicht unterstützt, wird ein Fehler protokolliert.
{#r_NN-sendSMS_S_S__table_vvk_pwd_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| phoneNumber | Zeichenfolge | Die E.164-konforme Telefonnummer, an die die Nachricht gesendet werden soll. |
| SmsBody | Zeichenfolge | Die zu sendende Nachricht, maximal 1600 Zeichen. |
[Tabelle : 39. Parameter]

{#r_NN-sendSMS_S_S__table_vvk_pwd_vt} {#r_NN-sendSMS_S_S__table_wvk_pwd_vt__entry__2}

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

{#r_NN-sendSMS_S_S__table_wvk_pwd_vt}  

    new SNC.NotifyNow().sendSMS("+31612345678", "This is a message without source record");

## NotifyNow -- sendSMS (Zeichenfolge phoneNumber, Zeichenfolge smsBody, GlideRecord-Quelle) {#ariaid-title22}

Sendet eine SMS-Nachricht an eine E.164-konforme Mobiltelefonnummer.
Notify unterstützt internationale Nummern. Wenn Sie diese Methode mit einer Nummer verwenden, die das Senden von SMS-Nachrichten nicht unterstützt, wird ein Fehler protokolliert.

Siehe auch: [Erweiterte Konfiguration für SMS](https://www.servicenow.com/docs/access?context=t_ConfigureNotifyforVoiceandSMS&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).
{#r_NN-sendSMS_S_S_GR__table_vvk_pwd_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| phoneNumber | Zeichenfolge | Die E.164-konforme Telefonnummer, an die die Nachricht gesendet werden soll. |
| SmsBody | Zeichenfolge | Die zu sendende Nachricht, maximal 1600 Zeichen. |
| Quelle | GlideRecord | Der Quelldatensatz, der dieser SMS-Nachricht zugeordnet werden soll. |
[Tabelle : 41. Parameter]

{#r_NN-sendSMS_S_S_GR__table_vvk_pwd_vt} {#r_NN-sendSMS_S_S_GR__table_jmh_dxd_vt__entry__2}

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

{#r_NN-sendSMS_S_S_GR__table_jmh_dxd_vt}  

    var source = new GlideRecord("my_table");
    source.query("my_field", "my_value");

    if (source.hasNext() && source.next()) {
        // send a text message
        var nn = new SNC.NotifyNow();
        var message = "this is just a test";
        var number = "+31612345678";
        nn.sendSMS(number, message, source);
    }

In diesem Beispiel werden Dot-Walking und der aktuelle Datensatz als Quelldatensatz verwendet.

    new SNC.NotifyNow().sendSMS("+31612345678", "this is a test", current);

## NotifyNow -- sendSMSQuestion(Zeichenfolge phoneNumber, Zeichenfolgenfrage, GlideRecord sourceRecord) {#ariaid-title23}

Sendet eine SMS-Frage.
{#r_NN-sendSMSQuestion_S_S_GR__table_rlx_jx2_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| phoneNumber |   | Eine E.164-konforme Telefonnummer, an die die Nachricht gesendet werden soll. |
| Frage | Zeichenfolge oder GlideRecord | Der zu sendende Fragendatensatz oder die sys_ID eines Fragendatensatzes. |
| QuelleDatensatz |   | Ein optionaler Quelldatensatz, der der SMS-Frage zugeordnet werden soll, z. B. ein Incident. |
[Tabelle : 43. Parameter]

{#r_NN-sendSMSQuestion_S_S_GR__table_rlx_jx2_vt} {#r_NN-sendSMSQuestion_S_S_GR__table_slx_jx2_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die sys_ID der Konversation oder null, wenn die SMS nicht erfolgreich gesendet wurde. |
[Tabelle : 44. Rückgaben]

{#r_NN-sendSMSQuestion_S_S_GR__table_slx_jx2_vt}  

    var question = new GlideRecord("notifynow_question");
    question.query();
     
    // get the first question
    if (question.hasNext() && question.next()) {
    	// send the sms question
            var number = "+31612345678";
    	var nn = new SNC.NotifyNow();
    	nn.sendSMSQuestion(number, question.getUniqueValue(), current);
    }

## NotifyNow -- umute (GlideRecord-Teilnehmer) {#ariaid-title24}

Hebt die Stummschaltung eines Teilnehmers in einer Telefonkonferenz auf.
{#r_NN-umute_GR__table_upz_zbf_vt__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Teilnehmer | GlideRecord | Der Teilnehmer der stummgeschalteten Telefonkonferenz, der die Stummschaltung aufheben soll. |
[Tabelle : 45. Parameter]

{#r_NN-umute_GR__table_upz_zbf_vt} {#r_NN-umute_GR__table_vpz_zbf_vt__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | „Wahr", wenn die Stummschaltung des Teilnehmers aufgehoben wurde, andernfalls „falsch". |
[Tabelle : 46. Rückgaben]

{#r_NN-umute_GR__table_vpz_zbf_vt}  

    var participantId = "<participant sys_id>";
    var participant = new GlideRecord('notifynow_participant');
    participant.get(participantId);
    if (participant.isValid()) {
         // unmute participant
         result = new SNC.NotifyNow().unmute(participant);
         gs.log('participant unmuted: ' + result);
    }


