---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Notification - Global

# Notification - Global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 13 minutes de lecture

L'API Notify vous permet d'interagir avec les appels Notify et les SMS à l'aide de scripts.

Accédez à la classe Notification globale et à ses méthodes associées dans l'espace de noms `SNC` .

## Notification : appel (String, notifyPhoneNumber, String toPhoneNumber, GlideRecord conferenceCallCall, GlideRecord conferenceCallRecord, String userSysId, String groupSysId, GlideRecord sourceRecord) {#ariaid-title2}

Appelle le numéro de téléphone spécifié conforme à la norme E.164.
En outre, cette méthode peut ajouter automatiquement le numéro de téléphone spécifié à une téléconférence spécifiée.
{#r_N-call_NotifyPhoneNumber_S_GR__table_abs_4hn_wr__entry__3}

| Nom | Type | Description |
|-|-|-|
| notifyPhoneNumber | String ou NotifyPhoneNumber | Numéro de téléphone de Notification à partir duquel passer l'appel. Lorsque vous lancez un appel, le workflow d'appel sortant pour le groupe de numéros associé à ce numéro s'exécute. Assurez-vous que ce workflow inclut une activité Rejoindre la téléconférence pour connecter l'utilisateur à la téléconférence. |
| toPhoneNumber | Chaîne | Numéro de téléphone à appeler. Les numéros appelés sont ajoutés à la téléconférence. |
| conférence téléphonique | GlideRecord | Facultatif. Si ce paramètre est transmis, les appelants identifiés dans le toPhoneNumber paramètre rejoignent automatiquement la téléconférence identifiée par cet enregistrement. GlideRecord pour la table Appel de notification \[notify_call\] qui identifie l'enregistrement de la téléconférence. Cet enregistrement est automatiquement ajouté au bloc-notes du workflow des appels sortants en tant que variable workflow.scratchpad.conference_call. |
| userSysId | Chaîne | Facultatif. Identificateur unique (sys_id) de l'utilisateur associé à l'appel. |
| groupSysId | Chaîne | Facultatif. Identificateur unique (sys_id) du groupe associé à l'appel. |
| sourceRecord | GlideRecord | Facultatif. Enregistrement source à l'origine de cet appel. |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 2. Renvoie]

{#r_N-call_NotifyPhoneNumber_S_GR__table_bbs_4hn_wr}  
Cet exemple illustre comment initier un appel vers un autre numéro de téléphone.

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

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

Cet exemple illustre comment initier un appel vers une liste de numéros de téléphone et joindre automatiquement ces numéros à une nouvelle téléconférence.

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

Cet exemple illustre comment lancer une nouvelle téléconférence.

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

Cet exemple illustre comment lancer une nouvelle téléconférence à l'aide d'un enregistrement utilisateur.

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

Cet exemple illustre comment lancer une nouvelle téléconférence avec un utilisateur, un groupe et un enregistrement source.

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

### Équivalent dans le champ d'application

Pour utiliser la méthode call() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [NotifyScoped - call()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-call_S_S_GR_GR_S_S_GR "Appelle le numéro de téléphone spécifié conforme à la norme E.164.").

## Notification : conferenceCall(GlideRecord sourceRecord) {#ariaid-title3}

Crée un nouveau GlideRecord de téléconférence.
{#r_N-conferenceCall__table_ysr_5mk_js__entry__3}

| Nom | Type | Description |
|-|-|-|
| sourceRecord | GlideRecord | Facultatif. Enregistrement à l'origine de la demande de création de la téléconférence. Utilisé pour renseigner les champs source et table de notify_conference_call enregistrement. |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| GlideRecord | Nouvel enregistrement de la téléconférence Notification \[notify_conference_call\]. |
[Tableau 4. Renvoie]

{#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);
    }

### Équivalent dans le champ d'application {#r_N-conferenceCall__section_wzp_1dd_1gb}

Pour utiliser la méthode conferenceCall() dans une application incluse dans le périmètre, utilisez la méthode correspondante délimitée : [NotifyScoped - conferenceCall()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-conferenceCall "Crée un nouveau GlideRecord de téléconférence.").
**Référence associée**   

* [Notification : appel (String, notifyPhoneNumber, String toPhoneNumber, GlideRecord conferenceCallCall, GlideRecord conferenceCallRecord, String userSysId, String groupSysId, GlideRecord sourceRecord)](https://servicenow-prod.fluidtopics.net/HhsYYlfyIfn1wjH~e~S7hA#r_N-call_NotifyPhoneNumber_S_GR "Appelle le numéro de téléphone spécifié conforme à la norme E.164.")

## Notification : dequeueCall(GlideRecord, callRecord) {#ariaid-title4}

Reprend un appel après qu'il ait été placé dans une file d'attente (en attente).
Utilisez cette méthode pour reprendre les appels qui ont été placés dans une file d'attente avec la méthode queueCall().
{#r_N-dequeueCall_GlideRecord__table_sf5_ddy_js__entry__3}

| Nom | Type | Description |
|-|-|-|
| callRecord | GlideRecord | Un objet GlideRecord sur la table Appel de notification \[notify_call\] avec l'appel en attente que vous souhaitez reprendre. |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 6. Renvoie]

{#r_N-dequeueCall_GlideRecord__table_tf5_ddy_js}  
L'exemple suivant montre comment réactiver un appel qui a été mis en attente.

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

### Équivalent dans le champ d'application {#r_N-dequeueCall_GlideRecord__section_dws_mnd_1gb}

Pour utiliser la méthode dequeueCall() dans une application incluse dans le périmètre, utilisez la méthode correspondante [délimitée : NotifyScoped - dequeueCall().](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-dequeueCall_GR "Reprend un appel après qu’il ait été placé dans une file d’attente (en attente).")

## Notification : forwardCall(appel GlideRecord, chaîne, destination, chaîne, dtmf) {#ariaid-title5}

Transfère l'appel spécifié à un autre destinataire de l'appel.
{#r_N-forwardCall_GR_S_S__table_byv_vml_ts__entry__3}

| Nom | Type | Description |
|-|-|-|
| appeler | GlideRecord ou chaîne | Notifier l'enregistrement d'appel ou l'ID d'appel du fournisseur de téléphonie de l'appel à transférer. |
| destination | GlideRecord ou chaîne | Notifiez l'enregistrement du numéro de téléphone ou un numéro de téléphone compatible E.164 de l'appelant vers lequel transférer l'appel. |
| Dtmf | Chaîne | Code Dual Tone - Multi Frequency (DTMF) à envoyer lors de la connexion à l'appel. |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 8. Renvoie]

{#r_N-forwardCall_GR_S_S__table_cyv_vml_ts}  
L'exemple suivant montre comment transférer un appel vers un autre numéro de téléphone.

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

### Équivalent dans le champ d'application

Pour utiliser la méthode forwardCall() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [NotifyScoped - forwardCall().](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-forwardCall_GR_S_S "Transfère l’appel spécifié à un autre destinataire de l’appel.")

## Notification : getAvailableClients(String notifyNumber) {#ariaid-title6}

Renvoie une liste des sessions client disponibles pour recevoir des appels.
{#r_N-getAvailableClients_String__table_ibs_r1n_ms__entry__3}

| Nom | Type | Description |
|-|-|-|
| notifyNumber | Chaîne | Numéro de téléphone de Notification valide. |
[Tableau 9. Paramètres]

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

| Type | Description |
|-|-|
| GlideRecord | GlideRecord de la table notify_client_session pour le numéro de téléphone spécifié. Renvoie \<\< 0 \>\> si aucune session client n'est disponible. |
[Tableau 10. Renvoie]

{#r_N-getAvailableClients_String__table_jbs_r1n_ms}  
L'exemple suivant montre comment utiliser la méthode getAvailableClients() pour indexer dans la table notify_client_session, puis itérer sur tous les clients Notification disponibles.

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

### Équivalent dans le champ d'application {#r_N-getAvailableClients_String__section_bgp_tk2_1gb}

Pour utiliser la méthode getAvailableClients() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [NotifyScoped - getAvailableClients().](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-getAvailableClients_S "Renvoie une liste des sessions client disponibles pour recevoir des appels.")

## Notification : getParentCallID(GlideRecord callRecord) {#ariaid-title7}

Renvoie la sys_id de l'appel parent d'un appel spécifié.
Tout appel démarré par le renvoi d'un autre appel, comme avec l'activité de workflow Renvoi, est considéré comme un enfant de l'appel d'origine. L'appel d'origine est l'appel parent.
{#r_N-getParentCallID_GR__table_sqs_jxn_wr__entry__3}

| Nom | Type | Description |
|-|-|-|
| callRecord | GlideRecord | Enregistrement sur la table Appel de notification \[notify_call\] pour lequel renvoyer l'état de l'appel. |
[Tableau 11. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | sys_id unique de l'enregistrement de l'appel parent. |
[Tableau 12. Renvoie]

{#r_N-getParentCallID_GR__table_tqs_jxn_wr}  
Cet exemple montre comment obtenir l'appel parent de l'appel spécifié.

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

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

## Notification : getPhoneNumbers() {#ariaid-title8}

Renvoie tous les numéros de téléphone et les codes courts disponibles pour la notification.
{#r_N-getPhoneNumbers__table_hsf_mwf_wr__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 13. Paramètres]

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

| Type | Description |
|-|-|
| Liste | Liste des objets NotifyPhoneNumber, chaque objet représentant un numéro de téléphone disponible pour la notification. |
[Tableau 14. Renvoie]

{#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())
    }

### Équivalent dans le champ d'application {#r_N-getPhoneNumbers__section_it5_ktc_1gb}

Pour utiliser la méthode getPhoneNumbers() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [NotifyScoped - getPhoneNumbers().](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-getPhoneNumbers "Renvoie tous les numéros de téléphone et les codes courts disponibles pour la notification.")

## Notification : getTokens(GlideRecord, enregistrement) {#ariaid-title9}

Renvoie les jetons client pour tous les pilotes de téléphonie actifs à utiliser dans WebRTC ou les clients mobiles.
{#r_N-getTokens_GlideRecord__table_vsx_c3n_wr__entry__3}

| Nom | Type | Description |
|-|-|-|
| enregistrement | GlideRecord | GlideRecord à utiliser pour identifier le client Notify, tel qu'un enregistrement de groupe ou un enregistrement d'utilisateur. |
[Tableau 15. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Jetons RTC Web pour les pilotes pris en charge, sous la forme d'une chaîne JSON au format suivant : {driverName1 : \<\< token1 \>\>, driverName2 : \<\< token2"}, telle que \<\< TwilioDirect \>\> :"eyJhxxxx.eyJleHAiOiIxxxx.7fejxxx_mbLxxx \>\> |
[Tableau 16. Renvoie]

{#r_N-getTokens_GlideRecord__table_wsx_c3n_wr}  
Cet exemple montre comment obtenir les jetons client pour l'utilisateur actuellement connecté.

    // 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]);
    }

Cet exemple montre comment obtenir les jetons client pour chaque groupe Notification.

    // 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]]));
      }
    }

### Équivalent dans le champ d'application {#r_N-getTokens_GlideRecord__section_x32_ysl_1gb}

Pour utiliser la méthode getTokens() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [NotifyScoped - getTokens()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-getTokens_GR "Renvoie les jetons client pour tous les pilotes de téléphonie actifs à utiliser dans WebRTC ou les clients mobiles.").

## Notification : getTokenTTL (propriétaire de chaîne) {#ariaid-title10}

Renvoie la durée maximale pendant laquelle une session client reste active pour un pilote de téléphonie spécifié avant l'expiration automatique.
{#Notify-getTokenTTL_S__table_mnj_xqb_zfb__entry__3}

| Nom | Type | Description |
|-|-|-|
| propriétaire | Chaîne | Nom du pilote de téléphonie dont la longueur de session doit être récupérée. Valeurs valides : * Twilio : pour l'ancien conducteur * TwilioDirect : pour le nouveau pilote {#Notify-getTokenTTL_S__ul_ql5_vgc_1gb} |
[Tableau 17. Paramètres]

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

| Type | Description |
|-|-|
| Entier | Durée maximale de la session (en secondes). Par défaut : 1 800 secondes |
[Tableau 18. Renvoie]

{#Notify-getTokenTTL_S__table_nnj_xqb_zfb}  
L'exemple suivant montre comment appeler correctement cette méthode et la réponse associée. Il affiche également ce qui est renvoyé si un pilote non valide est transmis.

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

### Équivalent dans le champ d'application {#Notify-getTokenTTL_S__section_bgp_tk2_1gb}

Pour utiliser la méthode getTokenTTL() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [NotifyScoped - getAvailableClients().](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-getTokenTTL_S "Renvoie la durée maximale pendant laquelle une session client reste active pour un pilote de téléphonie spécifié avant l’expiration automatique.")

## Notification : hasCapability(String, notifyPhoneNumber, capacité de chaîne) {#ariaid-title11}

Détermine si le numéro de téléphone spécifié a l'aptitude spécifiée.
Le pilote de téléphonie associé au numéro de téléphone contient une liste de toutes les fonctionnalités du téléphone.  
Remarque :  
Dans le système de base, l'aptitude du pilote Notification JS est uniquement \<\< show_speakers \>\> ; Ceci peut être modifié.
{#Notify-hasCapability_S_S__table_vsy_rdg_yfb__entry__3}

| Nom | Type | Description |
|-|-|-|
| notifyPhoneNumber | Chaîne | Numéro de téléphone pour lequel vérifier l'aptitude spécifiée. |
| aptitude | Chaîne | Aptitude à détecter. Le texte de la chaîne doit correspondre exactement à ce qui se trouve dans le téléphone. |
[Tableau 19. Paramètres]

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

| Type | Description |
|-|-|
| Booléen | Marqueur qui indique si le téléphone spécifié dispose de l'aptitude spécifiée. * Vrai : le téléphone a la capacité * false : le téléphone n'en a pas la capacité {#Notify-hasCapability_S_S__ul_ryg_y2g_yfb} |
[Tableau 20. Renvoie]

{#Notify-hasCapability_S_S__table_wsy_rdg_yfb}  
Cet exemple montre comment vérifier si un téléphone dispose d'une fonction spécifique.

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

### Équivalent dans le champ d'application {#Notify-hasCapability_S_S__section_bgp_tk2_1gb}

Pour utiliser la méthode hasCapability() dans une application incluse dans le périmètre, utilisez la méthode correspondante délimitée : [NotifyScoped - hasCapability().](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-hasCapabilitiy_S_S "Détermine si le numéro de téléphone spécifié a l’aptitude spécifiée.")

## Notification : kick (participant GlideRecord) {#ariaid-title12}

Supprime l'appelant spécifié de la téléconférence Notification actuelle.
{#r_N-kick_GlideRecord__table_asm_xdx_ls__entry__3}

| Nom | Type | Description |
|-|-|-|
| participant | GlideRecord | Objet GlideRecord contenant l'enregistrement Notification du participant \[notify_participant\] de l'appelant à supprimer de la téléconférence. |
[Tableau 21. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 22. Renvoie]

{#r_N-kick_GlideRecord__table_bsm_xdx_ls}  
L'exemple suivant montre comment supprimer un participant d'une téléconférence.

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

### Équivalent dans le champ d'application {#r_N-kick_GlideRecord__section_myh_bfd_1gb}

Pour utiliser la méthode kick() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [NotifyScoped - kick()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-kick_GR "Supprime l’appelant spécifié de la téléconférence Notification actuelle.").

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

Effectue une ou plusieurs actions lors d'un appel téléphonique de Notification.
Les actions disponibles que vous pouvez effectuer lors des appels incluent la mise en file d'attente ou la suppression de la file d'attente de l'appel, la lecture de texte, la lecture audio ou le transfert d'appel. Vous pouvez également créer des actions personnalisées Appelez la méthode modifyCall() une fois que vous avez spécifié toutes les actions que vous souhaitez appliquer à l'appel spécifié. Consultez la documentation de l'API [NotifyAction](https://servicenow-prod.fluidtopics.net/98kHlTKE4suW0xTCBHQcRQ#c_NotifyActionApi "L’API NotifyAction vous permet de définir des actions à envoyer à un fournisseur de téléphonie.") pour plus d'informations sur les actions disponibles.
{#r_N-modifyCall_GR_NA__table_rrh_gzn_wr__entry__3}

| Nom | Type | Description |
|-|-|-|
| callRecord | GlideRecord | Enregistrement de l'appel de notification \[notify_call\] de l'appel auquel appliquer les actions. |
| notifyAction (en anglais seulement) | NotifyAction (en anglais seulement) | Objet NotifyAction décrivant une ou plusieurs actions à effectuer lors de l'appel. Créez cet objet en appelant une ou plusieurs des méthodes NotifyAction(). |
[Tableau 23. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 24. Renvoie]

{#r_N-modifyCall_GR_NA__table_srh_gzn_wr}  
Cet exemple montre comment modifier un appel.

    // 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');
    }

### Équivalent dans le champ d'application {#r_N-modifyCall_GR_NA__section_a4l_chd_1gb}

Pour utiliser la méthode modifyCall() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le périmètre : [NotifyScoped - modifyCall()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-modifyCall_GR_NA "Effectue une ou plusieurs activités lors d’un appel téléphonique de Notification.").

## Notification : muet (GlideRecord participantRecord) {#ariaid-title14}

Désactive le micro du participant à la téléconférence spécifié.
{#Notify-mute_GR__table_bch_xfg_yfb__entry__3}

| Nom | Type | Description |
|-|-|-|
| participantRecord | GlideRecord | GlideRecord de la table notify_participant pour que le participant mette en sourdine. |
[Tableau 25. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 26. Renvoie]

{#Notify-mute_GR__table_cch_xfg_yfb}  
L'exemple suivant montre comment couper le son d'un appelant.

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

### Équivalent dans le champ d'application

Pour utiliser la méthode mute() dans une application incluse dans le périmètre, utilisez la méthode correspondante délimitée : [NotifyScoped - mute()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-mute_GR "Désactive le micro du participant à la téléconférence spécifié.").

## Notification : queueCall(GlideRecord, callRecord) {#ariaid-title15}

Met l'appel spécifié dans une file d'attente (en attente).
Reprendre un appel en file d'attente à l'aide de la méthode dequeueCall().
{#r_N-queueCall_GlideRecord__table_uhl_mcy_js__entry__3}

| Nom | Type | Description |
|-|-|-|
| callRecord | GlideRecord | Objet GlideRecord de l'enregistrement d'appel Notify (table notify_call) à mettre en attente. |
[Tableau 27. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 28. Renvoie]

{#r_N-queueCall_GlideRecord__table_vhl_mcy_js}  
L'exemple suivant montre comment mettre un appel en attente (dans la file d'attente).

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

### Équivalent dans le champ d'application

Pour utiliser la méthode queueCall() dans une application incluse dans le périmètre, utilisez la méthode correspondante délimitée : [NotifyScoped - queueCall()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-queueCall_GR "Met l’appel spécifié dans une file d’attente (en attente).").

## Notification : sendBulkSMS(String notifyPhoneNumber, Array toPhoneNumbers, String messageBody, source GlideRecord) {#ariaid-title16}

Envoie un message SMS spécifié à la liste spécifiée de clients Notification (numéros de téléphone).
{#Notify-sendBulkSMS_NPN_S_S_GR__table_n2q_3zf_yfb__entry__3}

| Nom | Type | Description |
|-|-|-|
| notifyPhoneNumber | Chaîne | Numéro de téléphone de Notification à partir duquel le message SMS est envoyé. |
| Numéros de téléphone de destination | Tableau de chaînes | Liste de numéros de téléphone séparés par des virgules auxquels envoyer le message SMS. Format : E.164 |
| corps du message | Chaîne | SMS à envoyer. |
| source | GlideRecord | Enregistrement source à l'origine de ce message SMS, tel qu'un incident. |
[Tableau 29. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Zéro |
[Tableau 30. Renvoie]

{#Notify-sendBulkSMS_NPN_S_S_GR__table_o2q_3zf_yfb}  
L'exemple suivant montre comment envoyer un SMS en masse.

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

### Équivalent dans le champ d'application

Pour utiliser la méthode sendBulkSMS() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : [NotifyScoped - sendBulkSMS().](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-sendBulkSMS_NPN_S_S_GR "Envoie un message SMS spécifié à la liste spécifiée de clients Notification (numéros de téléphone).")

## Notification : sendSMS(String notifyPhoneNumber, String toPhoneNumber, String messageBody, source GlideRecord) {#ariaid-title17}

Envoie un SMS à un numéro de téléphone compatible E.164.
Cette méthode crée un nouvel enregistrement dans la table Message de notification \[notify_message\] et l'associe à l'enregistrement source.
{#r_N-sendSMS_NPN_S_S_GR__table_dnk_4dn_wr__entry__3}

| Nom | Type | Description |
|-|-|-|
| notifyPhoneNumber | Chaîne | Numéro de téléphone de Notification à partir duquel le message SMS est envoyé. |
| toPhoneNumber | Chaîne | Numéro de téléphone compatible E.164 sur lequel envoyer le message SMS. |
| corps du message | Chaîne | Corps du message texte SMS. |
| source | GlideRecord | Enregistrement source à l'origine de ce message SMS, tel qu'un incident. |
[Tableau 31. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | SID de message unique ; stocké dans l'enregistrement Message de notification \[notify_message\] en tant que message_id. |
[Tableau 32. Renvoie]

{#r_N-sendSMS_NPN_S_S_GR__table_enk_4dn_wr}  
L'exemple suivant montre comment envoyer un SMS.

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

### Équivalent dans le champ d'application {#r_N-sendSMS_NPN_S_S_GR__section_kby_cyc_1gb}

Pour utiliser la méthode sendSMS() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : [NotifyScoped - sendSMS()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-sendSMS_NPN_S_S_GR "Envoie un SMS à un numéro de téléphone compatible E.164.").

## Notification : réactiver le micro (GlideRecord participantRecord) {#ariaid-title18}

Active le micro du participant à la téléconférence spécifié.
{#Notify-unmute_GR__table_v1w_p3g_yfb__entry__3}

| Nom | Type | Description |
|-|-|-|
| participantRecord | GlideRecord | GlideRecord de la table notify_participant pour activer le micro du participant. |
[Tableau 33. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 34. Renvoie]

{#Notify-unmute_GR__table_w1w_p3g_yfb}  
L'exemple suivant montre comment réactiver le micro d'un appelant.

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

### Équivalent dans le champ d'application {#Notify-unmute_GR__section_a4l_chd_1gb}

Pour utiliser la méthode unmute() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [NotifyScoped - unmute()](https://servicenow-prod.fluidtopics.net/Q4kvSmcqxISNUBW2~WUVhA#NotifyScoped-unmute_GR "Active le micro du participant à la téléconférence spécifié.").