NotifyOnTaskClient : client

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 17 minutes de lecture
  • L’API NotifyOnTaskClient fournit des méthodes d’envoi de SMS ou de démarrage/gestion d’une téléconférence pour divers fournisseurs de services de téléphonie, tels que Zoom et Webex.

    N’importe quelle interface utilisateur peut utiliser l’API NotifyOnTaskClient en incluant explicitement le script d’interface utilisateur NotifyOnTaskClient.

    À l’aide de l’API NotifyOnTaskClient, vous pouvez :

    • Commencer une téléconférence
    • Terminer une téléconférence
    • Ajouter des participants
    • Effectuez les actions disponibles via le pilote de téléphonie, telles que :
      • Activer/désactiver le micro des participants
      • Supprimer des participants d’une téléconférence
      • Ajouter des participants à une téléconférence
      • Commencer une téléconférence
      • Mettre fin à une téléconférence

    Le module d’extension Notification (com.snc.notify) nécessite un abonnement distinct. Pour plus d’informations sur l’activation du module d’extension Notification, consultez Activer Notification.

    NotifyOnTaskClient : addParticipants(données d’objet)

    Ajoute les participants spécifiés à une téléconférence spécifiée.

    Tableau 1. Paramètres
    Nom Type Description
    données Objet Objet décrivant la téléconférence.
    données.addToWorkNotes Booléen Marqueur indiquant s’il faut ajouter des informations sur les participants qui ont participé à la téléconférence dans le champ Notes de travail de l’enregistrement associé.

    Pour que cette fonctionnalité fonctionne, vous devez également spécifier des valeurs dans les data.table paramètres and data.sysId . Ces paramètres identifient l’enregistrement dans lequel ajouter les notes de travail.

    Valeur par défaut : false

    data.confId Chaîne Sys_id de la téléconférence. Table : Téléconférence de Notification [notify_conference_call]
    données.éléments Tableau Informations que chaque participant doit inclure dans la téléconférence.
    "items": [
      "email": "String",
      "id": "String",
      "notifyParticipantId": "String",
      "phoneNumber": "String"
    ]
    data.items.email Chaîne Adresse e-mail du participant.
    data.items.id Chaîne sys_id de l’utilisateur.

    Table : utilisateur [sys_User]

    données.éléments.notificationIdentificateurParticipant Chaîne sys_id du participant.

    Table : Notifier le participant [notify_participant]

    numéro.téléphone.éléments.données Chaîne Numéro de téléphone du participant. Si cette valeur est transmise conjointement avec le id paramètre ou notifyParticipantId , elle remplace les numéros de téléphone dans l’enregistrement de l’utilisateur/participant et est utilisée pour passer l’appel.
    message.données Chaîne Message lu à haute voix lorsqu’un utilisateur répond à l’appel, tel que « Un incident P1 a été créé, veuillez vous connecter à l’instance ».
    data.serviceProvider Chaîne Requis. Nom du fournisseur de services de conférence, tel que Zoom ou Webex.
    data.sysId Chaîne Sys_id de l’enregistrement source à associer à la téléconférence.

    Par exemple, si une téléconférence est organisée pour discuter d’un incident ou d’un problème spécifique, indiquez le sys_id de l’enregistrement d’incident ou de problème dans cette valeur. Cette sys_id est stockée dans la colonne Source de la table Téléconférence de notification [notify_conference_call] et peut être suivie ultérieurement.

    Ce paramètre est utilisé conjointement avec les data.Tableparamètres , data.addToWorkNoteset allowMulticonference .

    Vous devez configurer cette valeur lorsque la téléconférence est initialement créée via une action « démarrer ». Si nécessaire, vous pouvez également définir cette valeur à l’aide de cette méthode.

    table.données Chaîne Table contenant l’enregistrement source à associer à la téléconférence. Un enregistrement source peut être n’importe quel enregistrement, tel qu’un « incident » ou un « problème », qui est le sujet de discussion lors de la téléconférence.

    Ce nom de table est stocké dans la colonne Table de la table Téléconférence de notification [notify_conference_call] et peut être suivi.

    Ce paramètre est utilisé conjointement avec les data.sysIdparamètres , data.addToWorkNoteset allowMulticonference .

    Vous devez configurer cette valeur lorsque la téléconférence est initialement créée via une action « démarrer ». Si nécessaire, vous pouvez également définir cette valeur à l’aide de cette méthode.

    Tableau 2. Renvoie
    Type Description
    Objet Résultats de l’action de la conférence.

    <action>.état : statut de l’action de la conférence.

    • Type de données : booléennes
    • Valeurs possibles :
      • vrai : action de la conférence réussie
      • faux : échec de l’action de la conférence

    <action>.successMessages : si l’état est vrai, message(s) de réussite, sinon vide(s).

    • Type de données : tableau de chaînes

    <action>.warnMessages : si l’état est faux, tout message d’avertissement déclenché pendant le traitement.

    • Type de données : tableau de chaînes

    <action>.errorMessages : si l’état est faux, tous les messages d’erreur générés pendant le traitement.

    • Type de données : tableau de chaînes

    L’exemple de code suivant montre comment appeler cette méthode.

    function addToConferenceCall() {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.serviceProvider = 'Telephony'; // e.g 'Zoom', 'WebEx'
        data.confId = 'Active conference sysId';
        data.items.push({ id: 'userSysId' });
        data.items.push({ phoneNumber: '+917799555331' });
        data.items.push({ email: 'yln99518@gmail.com' });
    
        NotifyOnTaskClient.addParticipants(data).then(function (result) {
            var joinActionResult = result[0];
            if(joinActionResult.status) {
                joinActionResult.successMessages.forEach(function(msg) {
                    console.log(msg);
                });
                return;
            }
    
            joinActionResult.warnMessages.forEach(function(msg) {
                console.warn(msg);
            });
            joinActionResult.errorMessages.forEach(function(msg) {
                console.error(msg);
            });
        }, function (errMsg) {
            console.log(errMsg);
        });
    }

    NotifyOnTaskClient : doConferenceAction(Action de chaîne, données d’objet)

    Effectue l’action de téléconférence spécifiée, telle que démarrer/mettre fin à une téléconférence ou rejoindre, supprimer, désactiver ou réactiver le son de participants d’une téléconférence.

    Vous pouvez démarrer une nouvelle téléconférence et ajouter des participants au sein d’un seul appel à cette méthode ou appeler la méthode plusieurs fois pour démarrer l’appel, puis gérer les participants séparément. En outre, via l’objet de données transmis, vous pouvez configurer la méthode pour :
    • Enregistrez les pointeurs de l’enregistrement de la téléconférence vers l’enregistrement spécifique (enregistrement source), tel qu’un incident ou un problème, qui est le sujet de discussion de la téléconférence.
    • Autoriser/interdire plusieurs téléconférences pour un enregistrement source.
    • Journalisez automatiquement les participants qui participaient à la téléconférence dans le champ Work notes (Notes de travail ) de l’enregistrement source.
    • Faites lire un message à haute voix lorsqu’un participant répond à un appel sortant de la conférence.
    Tableau 3. Paramètres
    Nom Type Description
    action Chaîne Définit l’action de téléconférence à effectuer.
    Les actions de téléconférence disponibles sont les suivantes :
    • fin : met fin à la téléconférence identifiée dans data.confId.
    • join : ajoute le participant spécifié dans le data.items tableau à la téléconférence identifiée dans data.confId.
    • coup de pied : supprime le participant spécifié dans le data.items tableau de la téléconférence identifiée dans data.confId.
    • multiJoin : ajoute les participants spécifiés dans le tableau à la data.items téléconférence identifiée dans data.confId
    • multiKick : supprime les participants spécifiés dans le data.items tableau de la téléconférence identifiée dans data.confId.
    • multiMuet : désactive le son des participants spécifiés dans le data.items tableau de la téléconférence identifiée dans data.confId.
    • multiUnmute : Active le micro des participants spécifiés dans le data.items tableau de la téléconférence identifiée dans data.confId.
    • mute : désactive le micro du participant spécifié dans le data.items tableau de la téléconférence identifiée dans data.confId.
    • selfJoin : ajoute l’utilisateur actuellement connecté à la téléconférence (aucune entrée data.items requise).
    • start : démarre la téléconférence identifiée dans data.confId.
    • Activer le micro : Active le micro du participant spécifié dans le data.items tableau de la téléconférence identifiée dans data.confId.
    données Objet Objet décrivant la téléconférence.
    données.addToWorkNotes Booléen Marqueur indiquant s’il faut ajouter des informations sur les participants qui ont participé à la téléconférence dans le champ Notes de travail de l’enregistrement associé.

    Pour que cette fonctionnalité fonctionne, vous devez également spécifier des valeurs dans les data.table paramètres and data.sysId . Ces paramètres identifient l’enregistrement dans lequel ajouter les notes de travail.

    Valeur par défaut : false

    Actions pour lesquelles ce paramètre est valide :

    • rejoindre
    • jointure multiple
    • Joindre automatiquement
    • début
    données.allowMulticonference Booléen Marqueur indiquant s’il faut autoriser plusieurs téléconférences à la fois pour un enregistrement spécifique.

    Pour que cette fonctionnalité fonctionne, vous devez également spécifier des valeurs dans les data.table paramètres and data.sysId . Ces paramètres identifient l’enregistrement qui est autorisé à avoir plusieurs téléconférences.

    Valeur par défaut : false

    Actions pour lesquelles ce paramètre est valide :

    • début
    data.confId Chaîne Sys_id de la téléconférence.

    Table : Téléconférence de Notification [notify_conference_call]

    Actions pour lesquelles ce paramètre est requis :

    • fin
    • rejoindre
    • jointure multiple
    • Joindre automatiquement
    Remarque :
    Les actions des participants telles que la désactivation, l’activation du son et l’exclusion ne nécessitent pas que ce paramètre soit défini, car la méthode obtient ces informations à partir de la table des participants à la téléconférence de Notification [notify_participant].
    data.fromNumber Chaîne Numéro du fournisseur de service à appeler pour la téléconférence.

    Localisez cette valeur dans la colonne Numéro ou Numéro de téléphone de la table Numéro de téléphone de Notification [notify_number].

    Actions pour lesquelles ce paramètre est requis :

    • début
    data.isNewConference Booléen Marqueur indiquant s’il s’agit d’une nouvelle téléconférence ou d’une téléconférence existante.

    Valeurs valides :

    • vrai : nouvelle téléconférence
    • faux : téléconférence existante

    Valeur par défaut : false

    Actions pour lesquelles ce paramètre est valide :

    • début
    message.données Chaîne Message lu à haute voix lorsqu’un utilisateur répond à l’appel, tel que « Un incident P1 a été créé, veuillez vous connecter à l’instance ».

    Actions pour lesquelles ce paramètre est valide :

    • rejoindre
    • jointure multiple
    • début
    données.éléments Tableau Informations que chaque participant doit inclure dans la téléconférence.

    Valeurs de tableau valides :

    • ID : Sys_id de l’utilisateur ; situé dans la table User [sys_User].

      Actions valides : join, multiJoin, start

    • notifyParticipantId : ID système du participant à la notification ; située dans la table Notifier les participants [notify_participant].

      Actions valides : join, kick, multiJoin, mute, start, unmute

    • phoneNumber : numéro de téléphone du participant. Si cette valeur est transmise en conjonction avec le id ou notifyParticipantId, cette valeur remplace les numéros de téléphone dans l’enregistrement de l’utilisateur/participant et est utilisée pour passer l’appel.

      Actions valides : join, multiJoin, start

    • e-mail : adresse e-mail du participant.

      Actions valides : join, multiJoin, start

    data.serviceProvider Chaîne Requis. Nom du fournisseur de services de conférence, tel que Zoom ou Webex.

    Actions pour lesquelles ce paramètre est requis :

    • tous
    data.sysId Chaîne Sys_id de l’enregistrement source à associer à la téléconférence.

    Par exemple, si une téléconférence est organisée pour discuter d’un incident ou d’un problème spécifique, indiquez le sys_id de l’enregistrement d’incident ou de problème dans cette valeur. Cette sys_id est stockée dans la colonne Source de la table Téléconférence de notification [notify_conference_call] et peut être suivie ultérieurement.

    Ce paramètre est utilisé conjointement avec les data.Tableparamètres , data.addToWorkNoteset allowMulticonference .

    Actions pour lesquelles ce paramètre est valide :

    • début
    table.données Chaîne Table contenant l’enregistrement source à associer à la téléconférence. Un enregistrement source peut être n’importe quel enregistrement, tel qu’un « incident » ou un « problème », qui est le sujet de discussion lors de la téléconférence.

    Ce nom de table est stocké dans la colonne Table de la table Téléconférence de notification [notify_conference_call] et peut être suivi.

    Ce paramètre est utilisé conjointement avec les data.sysIdparamètres , data.addToWorkNoteset allowMulticonference .

    Actions pour lesquelles ce paramètre est valide :

    • début
    Tableau 4. Renvoie
    Type Description
    Objet Résultats de l’action de la conférence.

    <action>.état : statut de l’action de la conférence.

    • Type de données : booléennes
    • Valeurs possibles :
      • vrai : action de la conférence réussie
      • faux : échec de l’action de la conférence

    <action>.successMessages : si l’état est vrai, message(s) de réussite, sinon vide(s).

    • Type de données : tableau de chaînes

    <action>.warnMessages : si l’état est faux, tout message d’avertissement déclenché pendant le traitement.

    • Type de données : tableau de chaînes

    <action>.errorMessages : si l’état est faux, tous les messages d’erreur générés pendant le traitement.

    • Type de données : tableau de chaînes

    L’exemple suivant montre comment créer une fonction pour appeler doConferenceAction() afin de manipuler les participants d’une téléconférence en transmettant l’action et les participants.

    
    /**
     * 
     * @param {string} action - action to perform on the conference object or participant object
     * @param {Array} participants;
     */
    function doConferenceAction(action, participants) {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.serviceProvider = 'Telephony'; // e.g 'Zoom', 'WebEx'
        data.confId = 'Active conference sysId';
        data.items = participants;
    
        NotifyOnTaskClient.doConferenceAction(action, data).then(function (result) {
            var kickActionResult = result[0];
            if (kickActionResult.status)
                console.log(action + ' succeeded');
            else {
                kickActionResult.warnMessages.forEach(function (msg) {
                    console.warn(msg);
                });
                kickActionResult.errorMessages.forEach(function (msg) {
                    console.error(msg);
                });
            }
        }, function (errMsg) {
                console.log(errMsg)
        });
    }
    
    // kick participants
    
    doConferenceAction('kick', [{notifyParticipantId: 'notifyParticipantSysId'}]);
    
    // kick multiple participants
    
    doConferenceAction('multiKick',
        [{notifyParticipantId: 'notifyParticipantSysId'},
        {notifyParticipantId: 'notifyParticipantSysId'}]);
    
    // Mute participants
    doConferenceAction('mute', [{notifyParticipantId: 'notifyParticipantSysId'}]);
    doConferenceAction('mute', [{notifyParticipantId: 'notifyParticipantSysId'}]);
    
    doConferenceAction('multiMute',
        [{notifyParticipantId: 'notifyParticipantSysId'},
        {notifyParticipantId: 'notifyParticipantSysId'}]);
    
    // self join to any confernece. 
    doConferenceAction('selfJoin', [{id: 'logged in userId'}]);
    

    NotifyOnTaskClient - endConference(Données d’objet)

    Met fin à la téléconférence spécifiée.

    Tableau 5. Paramètres
    Nom Type Description
    données Objet Objet décrivant la téléconférence.
    data.confId Chaîne Sys_id de la téléconférence.
    data.serviceProvider Chaîne Requis. Nom du fournisseur de services de conférence, tel que Zoom ou Webex.
    Tableau 6. Renvoie
    Type Description
    Objet Résultats de l’action de la conférence.

    <action>.état : statut de l’action de la conférence.

    • Type de données : booléennes
    • Valeurs possibles :
      • vrai : action de la conférence réussie
      • faux : échec de l’action de la conférence

    <action>.successMessages : si l’état est vrai, message(s) de réussite, sinon vide(s).

    • Type de données : tableau de chaînes

    <action>.warnMessages : si l’état est faux, tout message d’avertissement déclenché pendant le traitement.

    • Type de données : tableau de chaînes

    <action>.errorMessages : si l’état est faux, tous les messages d’erreur générés pendant le traitement.

    • Type de données : tableau de chaînes
    function endConferenceCall() {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.serviceProvider = 'Telephony'; // e.g 'Zoom', 'WebEx'
        data.confId = 'Active conference sysId';
    
        NotifyOnTaskClient.endConference(data).then(function (result) {
            var endActionResult = result[0];
            if (endActionResult.status)
                console.log('Conference has been ended');
            else {
                endActionResult.warnMessages.forEach(function (msg) {
                    console.warn(msg);
                });
                endActionResult.errorMessages.forEach(function (msg) {
                    console.error(msg);
                });
            }
        }, function (errMsg) {
            console.log(errMsg);
        });
    }

    NotifyOnTaskClient : getNotifyActionTemplate()

    Renvoie un modèle de données JSON à utiliser avec la méthode doConferenceAction(). L’utilisation de ce modèle structure automatiquement l’objet de données afin que vous n’ayez pas à le créer manuellement.

    Appelez cette méthode avant d’appeler la méthode doConferenceAction(). Pour l’action de téléconférence souhaitée, définissez les paramètres souhaités dans le modèle, puis transmettez le modèle dans l’appel doConferenceAction(). Pour plus d’informations sur les paramètres valides de chaque action, consultez doConferenceAction().

    Remarque :
    Il s’agit d’une méthode d’aide. Vous pouvez également construire manuellement cet objet et le passer dans la méthode doConferenceAction() et obtenir le même résultat.
    Tableau 7. Paramètres
    Nom Type Description
    Néant
    Tableau 8. Renvoie
    Type Description
    données Objet décrivant la téléconférence.
    données.addToWorkNotes Marqueur indiquant s’il faut ajouter des informations sur les participants qui ont participé à la téléconférence dans le champ Notes de travail de l’enregistrement associé.

    Pour que cette fonctionnalité fonctionne, vous devez également spécifier des valeurs dans les data.table paramètres and data.sysId . Ces paramètres identifient l’enregistrement dans lequel ajouter les notes de travail.

    Valeur par défaut : false

    Actions pour lesquelles ce paramètre est valide :

    • rejoindre
    • jointure multiple
    • Joindre automatiquement
    • début
    data.allowMultconference Marqueur indiquant s’il faut autoriser plusieurs téléconférences à la fois pour un enregistrement spécifique.

    Pour que cette fonctionnalité fonctionne, vous devez également spécifier des valeurs dans les data.table paramètres and data.sysId . Ces paramètres identifient l’enregistrement qui est autorisé à avoir plusieurs téléconférences.

    Valeur par défaut : false

    Actions pour lesquelles ce paramètre est valide :

    • début
    data.confId Sys_id de la téléconférence.

    Table : Téléconférence de Notification [notify_conference_call]

    Actions pour lesquelles ce paramètre est requis :

    • fin
    • rejoindre
    • jointure multiple
    • Joindre automatiquement
    Remarque :
    Les actions des participants telles que la désactivation, l’activation du son et l’exclusion ne nécessitent pas que ce paramètre soit défini, car la méthode obtient ces informations à partir de la table des participants à la téléconférence de Notification [notify_participant].
    data.fromNumber Numéro du fournisseur de service à appeler pour la téléconférence.

    Localisez cette valeur dans la colonne Numéro ou Numéro de téléphone de la table Numéro de téléphone de Notification [notify_number].

    Actions pour lesquelles ce paramètre est requis :

    • début
    data.isNewConference Marqueur indiquant s’il s’agit d’une nouvelle téléconférence ou d’une téléconférence existante.

    Valeurs valides :

    • vrai : nouvelle téléconférence
    • faux : téléconférence existante

    Valeur par défaut : false

    Actions pour lesquelles ce paramètre est valide :

    • début
    données.éléments Informations que chaque participant doit inclure dans la téléconférence.

    Valeurs de tableau valides :

    • ID : Sys_id de l’utilisateur ; situé dans la table User [sys_User].

      Actions valides : join, multiJoin, start

    • notifyParticipantId : ID système du participant à la notification ; située dans la table Notifier les participants [notify_participant].

      Actions valides : join, kick, multiJoin, mute, start, unmute

    • phoneNumber : numéro de téléphone du participant. Si cette valeur est transmise en conjonction avec le id ou notifyParticipantId, cette valeur remplace les numéros de téléphone dans l’enregistrement de l’utilisateur/participant et est utilisée pour passer l’appel.

      Actions valides : join, multiJoin, start

    • e-mail : adresse e-mail du participant.

      Actions valides : join, multiJoin, start

    message.données Message lu à haute voix lorsqu’un utilisateur répond à l’appel, tel que « Un incident P1 a été créé, veuillez vous connecter à l’instance ».

    Actions pour lesquelles ce paramètre est valide :

    • rejoindre
    • jointure multiple
    • début
    data.serviceProvider Requis. Nom du fournisseur de services de conférence, tel que Zoom ou Webex.

    Actions pour lesquelles ce paramètre est requis :

    • tous
    data.sysId Sys_id de l’enregistrement source à associer à la téléconférence.

    Par exemple, si une téléconférence est organisée pour discuter d’un incident ou d’un problème spécifique, indiquez le sys_id de l’enregistrement d’incident ou de problème dans cette valeur. Cette sys_id est stockée dans la colonne Source de la table Téléconférence de notification [notify_conference_call] et peut être suivie ultérieurement.

    Ce paramètre est utilisé conjointement avec les data.Tableparamètres , data.addToWorkNoteset allowMulticonference .

    Actions pour lesquelles ce paramètre est valide :

    • début
    table.données Table contenant l’enregistrement source à associer à la téléconférence. Un enregistrement source peut être n’importe quel enregistrement, tel qu’un « incident » ou un « problème », qui est le sujet de discussion lors de la téléconférence.

    Ce nom de table est stocké dans la colonne Table de la table Téléconférence de notification [notify_conference_call] et peut être suivi.

    Ce paramètre est utilisé conjointement avec les data.sysIdparamètres , data.addToWorkNoteset allowMulticonference .

    Actions pour lesquelles ce paramètre est valide :

    • début

    L’exemple suivant montre comment appeler getNotifyActionTemplate() pour obtenir le modèle de données nécessaire pour définir les actions pour doConferenceAction().

    
    /**
     * 
     * @param {string} action - action to perform on the conference object or participant object
     * @param {Array} participants;
     */
    function doConferenceAction(action, participants) {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.serviceProvider = 'Telephony'; // e.g 'Zoom', 'WebEx'
        data.confId = 'Active conference sysId';
        data.items = participants;
    
        NotifyOnTaskClient.doConferenceAction(action, data).then(function (result) {
            var kickActionResult = result[0];
            if (kickActionResult.status)
                console.log(action + ' succeeded');
            else {
                kickActionResult.warnMessages.forEach(function (msg) {
                    console.warn(msg);
                });
                kickActionResult.errorMessages.forEach(function (msg) {
                    console.error(msg);
                });
            }
        }, function (errMsg) {
                console.log(errMsg)
        });
    }
    
    // kick participants
    
    doConferenceAction('kick', [{notifyParticipantId: 'notifyParticipantSysId'}]);
    
    // kick multiple participants
    
    doConferenceAction('multiKick',
        [{notifyParticipantId: 'notifyParticipantSysId'},
        {notifyParticipantId: 'notifyParticipantSysId'}]);
    
    // Mute participants
    doConferenceAction('mute', [{notifyParticipantId: 'notifyParticipantSysId'}]);
    doConferenceAction('mute', [{notifyParticipantId: 'notifyParticipantSysId'}]);
    
    doConferenceAction('multiMute',
        [{notifyParticipantId: 'notifyParticipantSysId'},
        {notifyParticipantId: 'notifyParticipantSysId'}]);
    
    // self join to any confernece. 
    doConferenceAction('selfJoin', [{id: 'logged in userId'}]);
    

    NotifyOnTaskClient : start(données d’objet)

    Démarre une nouvelle téléconférence.

    Tableau 9. Paramètres
    Nom Type Description
    données Objet Objet décrivant la téléconférence.
    données.addToWorkNotes Booléen Facultatif.Marqueur indiquant s’il faut ajouter des informations sur les participants qui ont participé à la téléconférence dans le champ Notes de travail de l’enregistrement associé.

    Pour que cette fonctionnalité fonctionne, vous devez également spécifier des valeurs pour les paramètres et data.sysId afin d’identifier data.table l’enregistrement dans lequel ajouter les notes de travail.

    Valeur par défaut : false

    données.allowMulticonference Booléen Facultatif. Marqueur indiquant s’il faut autoriser plusieurs téléconférences à la fois pour un enregistrement spécifique.

    Pour que cette fonctionnalité fonctionne, vous devez également spécifier des valeurs dans les data.table paramètres and data.sysId . Ces paramètres identifient l’enregistrement qui est autorisé à avoir plusieurs téléconférences.

    Valeur par défaut : false

    data.fromNumber Chaîne Requis. Numéro du fournisseur de service à appeler pour la téléconférence.

    Localisez cette valeur dans la colonne Numéro ou Numéro de téléphone de la table Numéro de téléphone de Notification [notify_number].

    données.éléments Tableau Facultatif. Informations que chaque participant doit inclure dans la téléconférence.
    "items": [
      "email": "String",
      "id": "String",
      "notifyParticipantId": "String",
      "phoneNumber": "String"
    ]
    data.items.email Chaîne Adresse e-mail du participant.
    data.items.id Chaîne sys_id de l’utilisateur.

    Table : utilisateur [sys_User]

    données.éléments.notificationIdentificateurParticipant Chaîne sys_id du participant.

    Table : Notifier le participant [notify_participant]

    numéro.téléphone.éléments.données Chaîne Numéro de téléphone du participant. Si cette valeur est transmise conjointement avec le id paramètre ou notifyParticipantId , elle remplace les numéros de téléphone dans l’enregistrement de l’utilisateur/participant et est utilisée pour passer l’appel.
    message.données Chaîne Facultatif. Message lu à haute voix lorsqu’un utilisateur répond à l’appel, tel que « Un incident P1 a été créé, veuillez vous connecter à l’instance ».
    data.serviceProvider Chaîne Requis. Nom du fournisseur de services de conférence, tel que Zoom ou Webex.
    data.sysId Chaîne Facultatif. Sys_id de l’enregistrement source à associer à la téléconférence.

    Par exemple, si une téléconférence est organisée pour discuter d’un incident ou d’un problème spécifique, indiquez le sys_id de l’enregistrement d’incident ou de problème dans cette valeur. Cette sys_id est stockée dans la colonne Source de la table Téléconférence de notification [notify_conference_call] et peut être suivie ultérieurement.

    Ce paramètre est utilisé conjointement avec les data.Tableparamètres , data.addToWorkNoteset allowMulticonference .

    table.données Chaîne Facultatif. Table contenant l’enregistrement source à associer à la téléconférence. Un enregistrement source peut être n’importe quel enregistrement, tel qu’un « incident » ou un « problème », qui est le sujet de discussion lors de la téléconférence.

    Ce nom de table est stocké dans la colonne Table de la table Téléconférence de notification [notify_conference_call] et peut être suivi.

    Ce paramètre est utilisé conjointement avec les data.sysIdparamètres , data.addToWorkNoteset allowMulticonference .

    Tableau 10. Renvoie
    Type Description
    Objet Résultats de l’action de la conférence.

    <action>.état : statut de l’action de la conférence.

    • Type de données : booléennes
    • Valeurs possibles :
      • vrai : action de la conférence réussie
      • faux : échec de l’action de la conférence

    <action>.successMessages : si l’état est vrai, message(s) de réussite, sinon vide(s).

    • Type de données : tableau de chaînes

    <action>.warnMessages : si l’état est faux, tout message d’avertissement déclenché pendant le traitement.

    • Type de données : tableau de chaînes

    <action>.errorMessages : si l’état est faux, tous les messages d’erreur générés pendant le traitement.

    • Type de données : tableau de chaînes

    L’exemple de code suivant montre comment appeler cette méthode.

    function startConferenceCall() {
        var data = NotifyOnTaskClient.getNotifyActionTemplate();
        data.table = 'incident';
        data.sysId = '1234';
        data.serviceProvider = serviceProvider;
        data.addToWorkNotes = true;
        data.fromNumber = 'Telephony Number';
        data.items.push({ id: 'userSysId' });
        data.items.push({ phoneNumber: '+917799555332' });
        data.items.push({ email: 'yln99517@gmail.com' });
    
        NotifyOnTaskClient.start(data).then(function (result) {
            var startActionResult = result[0];
            if(startActionResult.status) {
                startActionResult.successMessages.forEach(function(msg) {
                    console.log(msg);
                });
                return;
            }
    
            startActionResult.warnMessages.forEach(function(msg) {
                console.warn(msg);
            });
            startActionResult.errorMessages.forEach(function(msg) {
                console.error(msg);
            });
        }, function (errMsg) {
            console.log(errMsg);
        });
    }