Partager via


Luware Nimbus

Connecteur pour le Centre de contacts Nimbus et les services sous licence Routage entreprise pour connecter rapidement Nimbus avec des systèmes tiers. En écoutant et en réagissant aux événements déclencheurs, le connecteur peut suivre les actions de flux, par exemple pour récupérer des données à partir de systèmes externes et les stocker dans des paramètres Nimbus pour une utilisation ultérieure dans vos flux de travail Nimbus.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Support technique Luware
URL https://helpdesk.luware.cloud/
Messagerie électronique nimbus.support@luware.com
Métadonnées du connecteur
Éditeur Luware
Site internet https://luware.com/
Politique de confidentialité https://luware.com/en/privacy-policy/
Catégories Communication; Collaboration

Le connecteur Luware Nimbus permet l’intégration entre Nimbus et les logiciels tiers tels que les machines virtuelles ou les systèmes de tickets. Il vous permet d’écouter les événements d’entrée de tâche et de planificateur qui se produisent dans Luware Nimbus. Vous pouvez créer des tâches, enrichir les tâches existantes avec des données d’informations de l’appelant, ajouter des paramètres de routage ou déclencher un événement dans votre système tiers. En outre, vous pouvez gérer les carnets d’adresses, planifier des appels sortants ou ajouter des tâches externes.

Certains cas d’usage sont les suivants :

  • Afficher les coordonnées dans Nimbus pour un appel entrant.
  • Conserver le choix de langue d’IVR dans Nimbus vers un CRM.
  • Créez un élément de travail après appel après l’appel dans un CRM.
  • Créez une tâche de rappel pour un appel manqué dans un CRM.
  • Créez un appel sortant Nimbus basé sur une campagne dans le CRM.
  • Acheminer un appel en fonction des préférences du client.
  • Afficher les préférences de l’appelant pour un appel entrant.
  • Créez des tickets dans un système tiers.
  • Créez une liste d’appels manqués dans un système tiers.
  • Ouvrez l’enregistrement du client quand un agent prend l’appel.

Vous trouverez plus d’informations et beaucoup d’aide sur la base de connaissances de Luware : https://help.luware.com/nimbus-power-automate-connector

Prerequisites

  • Un plan Microsoft PowerApps ou PowerAutomate avec le niveau « Premium »
  • Un locataire Azure
  • Au moins un service Luware Nimbus approvisionné
  • Rôle dans Luware Nimbus permettant l’utilisation du connecteur Luware Nimbus (https://help.luware.com/power-automate-roles)

Comment établir une connexion sécurisée

Les API Nimbus sont sécurisées via Azure Active Directory (AAD) / Microsoft Entra ID à l’aide d’autorisations déléguées. En tant qu’administrateur client, vous devez accorder ces autorisations pour l’application « Connexion Luware Nimbus » afin que le connecteur puisse accéder en toute sécurité à Luware Nimbus. Dans la plupart des cas, ces autorisations ont déjà été accordées lors de l’intégration de Nimbus et n’ont pas besoin d’être reconfirmées.

Une fois cette étape terminée, vous pouvez utiliser le connecteur en établissant une connexion aux clusters Nimbus. Veillez à choisir le même emplacement de cluster que votre installation Nimbus. Si vous ne savez pas cela, connectez-vous à l’administration Nimbus pour vérifier le cluster vers lequel vous êtes redirigé.

Bien démarrer avec votre connecteur

  1. Sélectionnez le déclencheur « Quand une tâche change d’état » sur les déclencheurs Luware Nimbus.
  2. Configurez votre service Nimbus sur lequel vous souhaitez écouter les appels entrants.
  3. Sélectionnez l’événement « Système accepté » (déclenché lorsque l’activité « Accepter la conversation » dans le flux de travail est atteinte).
  4. Implémentez la recherche des informations de l’appelant en fonction du numéro de téléphone de l’appelant, par exemple dans votre CRM ou à des fins de test dans une feuille Excel hébergée sur Sharepoint.
  5. Utilisez l’action « Mettre à jour la tâche » pour définir les informations du client telles que Prénom/Nom, Adresse, Ville, Pays, etc. sur la tâche.

Reportez-vous à notre section cas d’usage sur la base de connaissances : https://help.luware.com/power-automate-use-cases

Problèmes connus et limitations

  • La perte d’autorisations (RBAC) dans Luware Nimbus désactive les déclencheurs dans Power Automate sans informations transparentes pour l’utilisateur final. Les flux ne seront plus déclenchés.
  • Luware n’a pas d’influence sur le temps d’exécution des flux, de sorte que les résultats peuvent arriver dans Nimbus avec un délai. Les flux de travail en fonction de l’achèvement du flux doivent être créés en gardant cette limitation à l’esprit.

Erreurs courantes et solutions

Code d’erreur HTTP :

  • 400 : La demande que vous avez envoyée à l’API Luware Nimbus ne contient pas de paramètres valides ou ne peut pas être appliquée. Exemples : tous les utilisateurs préférés passés ne sont pas valides, par conséquent les utilisateurs préférés ne sont pas définis ou vous essayez de supprimer une tâche externe lorsqu’elle est déjà affectée à un utilisateur.
  • 401 : Le jeton d’authentification fourni ne peut pas être analysé ou non valide. Vérifiez la configuration correcte de l’inscription de l’application Azure AD / Entra ID et que vous avez fourni les informations d’identification appropriées pour votre compte O365.
  • 403 : votre compte ne dispose pas des autorisations nécessaires dans Nimbus pour effectuer l’action configurée dans votre flux. Reportez-vous à la Base de connaissances et contactez votre administrateur si vous avez besoin de rôles/droits supplémentaires.
  • 404 : Le ou les identificateurs passés ne peuvent pas être mis en correspondance avec une entité dans le back-end.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Emplacement ficelle Emplacement dans lequel se trouve votre locataire. Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Ajouter un contact à un carnet d’adresses

Ajoute un nouveau contact à un carnet d’adresses spécifique. ExternalId est utilisé comme référence dans d’autres requêtes.

Ajouter une nouvelle tâche externe

Ajouter une nouvelle tâche externe

Mettre à jour un appel sortant avec l’entrée du planificateur de flux de travail

Modifiez les paramètres d’un appel sortant déjà créé avec l’entrée du planificateur de flux de travail.

Mettre à jour un contact dans un carnet d’adresses

Met à jour un contact unique dans le carnet d’adresses spécifié.

Mettre à jour une entrée du planificateur

Modifiez les paramètres d’une entrée de planificateur déjà créée.

Mettre à jour une tâche

Mettez à jour les informations client, le paramètre de contexte et/ou les paramètres utilisateur préférés pour une tâche en cours.

Obtenir des contacts à partir d’un carnet d’adresses

Retourne des contacts à partir d’un carnet d’adresses.

Obtenir les données de l’Assistant Utilisateur virtuel

Retourne les données de l’Assistant utilisateur virtuel pour la session de service sélectionnée.

Obtenir les heures d’ouverture

Obtenez des heures d’ouverture de service : elle retourne l’état du service (Ouvert, Fermé, Congé, etc.) à un moment donné.

Obtenir toutes les entrées du planificateur

Retourne toutes les entrées du planificateur pour le service spécifié.

Planifier un nouvel appel sortant

Planifiez un nouvel appel sortant (entrée du planificateur).

Planifier un nouvel appel sortant avec le flux de travail

Planifiez un nouvel appel sortant avec le flux de travail (entrée du planificateur).

Supprimer les contacts d’un carnet d’adresses

Supprimez un ou plusieurs contacts d’un carnet d’adresses.

Supprimer une entrée de planificateur

Supprimez une entrée de planificateur du système. Seule possible, alors que l’entrée du planificateur n’est pas encore en cours.

Supprimer une tâche externe

Supprimer une tâche externe

Vider un carnet d’adresses

Supprimez tous les contacts dans le carnet d’adresses spécifié.

Ajouter un contact à un carnet d’adresses

Ajoute un nouveau contact à un carnet d’adresses spécifique. ExternalId est utilisé comme référence dans d’autres requêtes.

Paramètres

Nom Clé Obligatoire Type Description
Carnet d’adresses
AddressBook True string

Carnet d’adresses à laquelle ajouter le contact.

Contacter l’ID externe
externalId True string

ID du contact donné par le système externe.

Prénom du contact
firstName string

Prénom du contact.

Nom du contact
lastName string

Nom du contact.

Nom complet du contact
displayName string

Nom complet du contact.

Initiales du contact
initials string

Initiales du contact.

Contacter l’entreprise
company string

Société du contact.

Contacter le service
department string

Service du contact.

Titre du travail de contact
jobTitle string

Titre du travail du contact.

Contacter le nom d’utilisateur principal
userPrincipalName string

Nom d’utilisateur principal du contact.

Adresses de messagerie instantanée de contact
imAddresses array of string

Liste des adresses de messagerie instantanée.

Adresses e-mail de contact
emailAddresses array of string

Liste des adresses e-mail.

Contacter les téléphones professionnels
businessPhones array of string

Liste des téléphones professionnels.

Contacter les téléphones mobiles
mobilePhones array of string

Liste des téléphones mobiles.

Contacter les téléphones domestiques
homePhones array of string

Liste des téléphones domestiques.

Rue d’adresse
street string

Rue et numéro de l’adresse.

Ville d’adresse
city string

Ville de l’adresse.

Pays d’adresse
country string

Pays de l’adresse.

État de l’adresse
state string

État de l’adresse.

Code postal d’adresse
postalCode string

Code postal de l’adresse.

Nom
name True string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

Retours

Ajouter une nouvelle tâche externe

Ajouter une nouvelle tâche externe

Paramètres

Nom Clé Obligatoire Type Description
Service UPN
serviceUpn True string

UPN du service.

Identificateur du client
customerIdentifier string

Identificateur de création de rapports unique facultatif, anonyme lorsqu’il est vide.

Prénom du client
firstName string

Prénom du client.

Nom du client
lastName string

Nom du client.

Nom d’affichage du client
displayName string

Nom complet du client.

Entreprise cliente
company string

Société du client.

Titre du travail client
jobTitle string

Titre du travail du client.

Service client
department string

Service du client.

Adresse postale du client
streetAddress string

Adresse postale du client.

Code postal du client
postCode string

Code postal du client.

Ville du client
city string

Ville du client.

Région du client
state string

État du client.

Pays du client
country string

Pays du client.

Numéro de téléphone principal du client
primaryTelNumber string

Numéro de téléphone principal du client.

Nom
name True string

Désignation du numéro de téléphone.

Valeur
value string

Valeur du numéro de téléphone.

UPN client
UPN string

UPN du client.

Adresse de messagerie instantanée du client
imAddress string

Adresse de messagerie instantanée du client.

E-mail client
email string

E-mail du client.

Nom
name True string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

Nom
name True string

Nom du paramètre de contexte personnalisé.

Valeur
value string

Valeur du paramètre de contexte personnalisé.

Priorité de distribution
distributionPriority string

Priorité avec laquelle la tâche doit être gérée dans Nimbus une fois qu’elle est due.

UPN
upn True string

UPN de l’utilisateur préféré.

Priority
priority integer

Priorité. 1 haut à 99 bas.

Retours

Mettre à jour un appel sortant avec l’entrée du planificateur de flux de travail

Modifiez les paramètres d’un appel sortant déjà créé avec l’entrée du planificateur de flux de travail.

Paramètres

Nom Clé Obligatoire Type Description
ID d’entrée du planificateur
SchedulerEntryID True string

ID de l’entrée du planificateur à mettre à jour.

ID de référence
ReferenceId string

ID de référence passé par le système tiers.

Destination
destination True string

Destination de l’appel sortant avec workflow.

Date d’échéance (UTC)
dueDateTimeUtc True date-time

Date et heure d’échéance au format UTC : Exemple : « 2020-03-23T11:00:00Z ».

Service UPN
serviceUpn True string

UPN du service.

Nombre maximal de tentatives
maxAttempts integer

Nombre maximal de tentatives d’atteindre la destination.

Délai d’expiration de la tentative en secondes
attemptTimeoutInSeconds integer

Définit la durée pendant laquelle Nimbus tente d’atteindre la destination avant l’arrêt de la tentative.

Nom
name True string

Nom du paramètre de contexte personnalisé.

Valeur
value string

Valeur du paramètre de contexte personnalisé.

Prénom du client
firstName string

Prénom du client.

Nom du client
lastName string

Nom du client.

Nom d’affichage du client
displayName string

Nom complet du client.

Entreprise cliente
company string

Société du client.

Titre du travail client
jobTitle string

Titre du travail du client.

Service client
department string

Service du client.

Adresse postale du client
streetAddress string

Adresse postale du client.

Code postal du client
postCode string

Code postal du client.

Ville du client
city string

Ville du client.

Région du client
state string

État du client.

Pays du client
country string

Pays du client.

Numéro de téléphone principal du client
primaryTelNumber string

Numéro de téléphone principal du client.

Nom
name True string

Désignation du numéro de téléphone.

Valeur
value string

Valeur du numéro de téléphone.

UPN client
UPN string

UPN du client.

Adresse de messagerie instantanée du client
imAddress string

Adresse de messagerie instantanée du client.

E-mail client
email string

E-mail du client.

Nom
name True string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

Retours

Mettre à jour un contact dans un carnet d’adresses

Met à jour un contact unique dans le carnet d’adresses spécifié.

Paramètres

Nom Clé Obligatoire Type Description
Carnet d’adresses
AddressBook True string

Carnet d’adresses dans lequel mettre à jour le contact.

Contacter l’ID externe
externalId True string

ID du contact donné par le système externe.

Prénom du contact
firstName string

Prénom du contact.

Nom du contact
lastName string

Nom du contact.

Nom complet du contact
displayName string

Nom complet du contact.

Initiales du contact
initials string

Initiales du contact.

Contacter l’entreprise
company string

Société du contact.

Contacter le service
department string

Service du contact.

Titre du travail de contact
jobTitle string

Titre du travail du contact.

Contacter le nom d’utilisateur principal
userPrincipalName string

Nom d’utilisateur principal du contact.

Adresses de messagerie instantanée de contact
imAddresses array of string

Liste des adresses de messagerie instantanée.

Adresses e-mail de contact
emailAddresses array of string

Liste des adresses e-mail.

Contacter les téléphones professionnels
businessPhones array of string

Liste des téléphones professionnels.

Contacter les téléphones mobiles
mobilePhones array of string

Liste des téléphones mobiles.

Contacter les téléphones domestiques
homePhones array of string

Liste des téléphones domestiques.

Rue d’adresse
street string

Rue et numéro de l’adresse.

Ville d’adresse
city string

Ville de l’adresse.

Pays d’adresse
country string

Pays de l’adresse.

État de l’adresse
state string

État de l’adresse.

Code postal d’adresse
postalCode string

Code postal de l’adresse.

Nom
name True string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

Retours

Mettre à jour une entrée du planificateur

Modifiez les paramètres d’une entrée de planificateur déjà créée.

Paramètres

Nom Clé Obligatoire Type Description
ID d’entrée du planificateur
SchedulerEntryID True string

ID de l’entrée du planificateur à mettre à jour.

ID de référence
ReferenceId string

ID de référence passé par le système tiers.

Destination
destination True string

Destination des entrées du planificateur avec direction « Sortant ».

Priorité de distribution
distributionPriority string

Priorité avec laquelle la tâche doit être gérée dans Nimbus.

Date d’échéance (UTC)
dueDateTimeUtc True date-time

Date et heure d’échéance au format UTC : Exemple : « 2020-03-23T11:00:00Z ».

Service UPN
serviceUpn True string

UPN du service.

Nombre maximal de tentatives
maxAttempts integer

Nombre maximal de tentatives d’atteindre la destination.

Délai d’expiration de la tentative en secondes
attemptTimeoutInSeconds integer

Délai d’expiration (intervalles) entre les nouvelles tentatives de connexion jusqu’à ce que le nombre maximal de tentatives soit atteint.

Durée maximale de file d’attente en secondes
maxQueueTimeInSeconds integer

Définit la durée pendant laquelle Nimbus tente de résoudre la tâche jusqu’à ce que la tâche soit considérée comme limite atteinte.

Délai d’expiration RONA en secondes
ronaTimeoutInSeconds integer

Définit la durée pendant laquelle Nimbus tente d’atteindre l’utilisateur jusqu’à ce que la tâche soit considérée comme RONA et qu’un nouvel utilisateur sera sélectionné.

Nom
name True string

Nom du paramètre de contexte personnalisé.

Valeur
value string

Valeur du paramètre de contexte personnalisé.

Prénom du client
firstName string

Prénom du client.

Nom du client
lastName string

Nom du client.

Nom d’affichage du client
displayName string

Nom complet du client.

Entreprise cliente
company string

Société du client.

Titre du travail client
jobTitle string

Titre du travail du client.

Service client
department string

Service du client.

Adresse postale du client
streetAddress string

Adresse postale du client.

Code postal du client
postCode string

Code postal du client.

Ville du client
city string

Ville du client.

Région du client
state string

État du client.

Pays du client
country string

Pays du client.

Numéro de téléphone principal du client
primaryTelNumber string

Numéro de téléphone principal du client.

Nom
name True string

Désignation du numéro de téléphone.

Valeur
value string

Valeur du numéro de téléphone.

UPN client
UPN string

UPN du client.

Adresse de messagerie instantanée du client
imAddress string

Adresse de messagerie instantanée du client.

E-mail client
email string

E-mail du client.

Nom
name True string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

Retours

Mettre à jour une tâche

Mettez à jour les informations client, le paramètre de contexte et/ou les paramètres utilisateur préférés pour une tâche en cours.

Paramètres

Nom Clé Obligatoire Type Description
ID de tâche
taskId True string

ID spécifique à Nimbus de la tâche.

Prénom du client
firstName string

Prénom du client.

Nom du client
lastName string

Nom du client.

Nom d’affichage du client
displayName string

Nom complet du client.

Entreprise cliente
company string

Société du client.

Titre du travail client
jobTitle string

Titre du travail du client.

Service client
department string

Service du client.

Adresse postale du client
streetAddress string

Adresse postale du client.

Code postal du client
postCode string

Code postal du client.

Ville du client
city string

Ville du client.

Région du client
state string

État du client.

Pays du client
country string

Pays du client.

Numéro de téléphone principal du client
primaryTelNumber string

Numéro de téléphone principal du client.

Nom
name True string

Désignation du numéro de téléphone.

Valeur
value string

Valeur du numéro de téléphone.

UPN client
UPN string

UPN du client.

Adresse de messagerie instantanée du client
imAddress string

Adresse de messagerie instantanée du client.

E-mail client
email string

E-mail du client.

Nom
name True string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

Nom
name True string

Nom du paramètre de contexte personnalisé.

Valeur
value string

Valeur du paramètre de contexte personnalisé.

UPN
upn True string

UPN de l’utilisateur préféré.

Priority
priority integer

Priorité. 1 haut à 99 bas.

Service Session ID
serviceSessionId string

ID de la session de service.

ID de session utilisateur
userSessionId string

ID de la session utilisateur.

Obtenir des contacts à partir d’un carnet d’adresses

Retourne des contacts à partir d’un carnet d’adresses.

Paramètres

Nom Clé Obligatoire Type Description
Carnet d’adresses
AddressBook True string

Carnet d’adresses à partir duquel obtenir le ou les contacts.

ExternalId
externalIds array

ID externes des contacts à extraire. Facultatif : si aucun n’est fourni, tous les contacts sont retournés.

Retours

Contacts retournés.

Obtenir les données de l’Assistant Utilisateur virtuel

Retourne les données de l’Assistant utilisateur virtuel pour la session de service sélectionnée.

Paramètres

Nom Clé Obligatoire Type Description
Service Session ID
serviceSessionId True string

ID de la session de service pour laquelle les données de l’Assistant utilisateur virtuel doivent être retournées.

ID de session utilisateur
userSessionId string

ID de la session utilisateur pour laquelle les données de l’Assistant utilisateur virtuel doivent être retournées.

Type de données
dataType True string

Type de données qui doivent être retournées pour la session de service.

Retours

Les sorties de cette opération sont dynamiques.

Obtenir les heures d’ouverture

Obtenez des heures d’ouverture de service : elle retourne l’état du service (Ouvert, Fermé, Congé, etc.) à un moment donné.

Paramètres

Nom Clé Obligatoire Type Description
Service UPN
serviceUpn True string

UPN du service pour lequel l’état sera vérifié.

Date d’échéance (UTC)
time date-time

Date et heure d’échéance au format UTC : Exemple : « 2020-03-23T11:00:00Z ».

Retours

État du service (Ouvert, Fermé, etc.).

response
CalendarStatus

Obtenir toutes les entrées du planificateur

Retourne toutes les entrées du planificateur pour le service spécifié.

Paramètres

Nom Clé Obligatoire Type Description
Service UPN
serviceUpn True string

UPN du service pour lequel les entrées du planificateur doivent être retournées.

Retours

Liste de toutes les tâches planifiées pour le service spécifié

Tâches planifiées
array of SchedulerEntryEventData

Planifier un nouvel appel sortant

Planifiez un nouvel appel sortant (entrée du planificateur).

Paramètres

Nom Clé Obligatoire Type Description
ID de référence
ReferenceId string

ID de référence passé par le système tiers.

Destination
destination True string

Destination des entrées du planificateur avec direction « Sortant ».

Priorité de distribution
distributionPriority string

Priorité avec laquelle la tâche doit être gérée dans Nimbus.

Date d’échéance (UTC)
dueDateTimeUtc True date-time

Date et heure d’échéance au format UTC : Exemple : « 2020-03-23T11:00:00Z ».

Service UPN
serviceUpn True string

UPN du service.

Nombre maximal de tentatives
maxAttempts integer

Nombre maximal de tentatives d’atteindre la destination.

Délai d’expiration de la tentative en secondes
attemptTimeoutInSeconds integer

Délai d’expiration (intervalles) entre les nouvelles tentatives de connexion jusqu’à ce que le nombre maximal de tentatives soit atteint.

Durée maximale de file d’attente en secondes
maxQueueTimeInSeconds integer

Définit la durée pendant laquelle Nimbus tente de résoudre la tâche jusqu’à ce que la tâche soit considérée comme limite atteinte.

Délai d’expiration RONA en secondes
ronaTimeoutInSeconds integer

Définit la durée pendant laquelle Nimbus tente d’atteindre l’utilisateur jusqu’à ce que la tâche soit considérée comme RONA et qu’un nouvel utilisateur sera sélectionné.

Nom
name True string

Nom du paramètre de contexte personnalisé.

Valeur
value string

Valeur du paramètre de contexte personnalisé.

Prénom du client
firstName string

Prénom du client.

Nom du client
lastName string

Nom du client.

Nom d’affichage du client
displayName string

Nom complet du client.

Entreprise cliente
company string

Société du client.

Titre du travail client
jobTitle string

Titre du travail du client.

Service client
department string

Service du client.

Adresse postale du client
streetAddress string

Adresse postale du client.

Code postal du client
postCode string

Code postal du client.

Ville du client
city string

Ville du client.

Région du client
state string

État du client.

Pays du client
country string

Pays du client.

Numéro de téléphone principal du client
primaryTelNumber string

Numéro de téléphone principal du client.

Nom
name True string

Désignation du numéro de téléphone.

Valeur
value string

Valeur du numéro de téléphone.

UPN client
UPN string

UPN du client.

Adresse de messagerie instantanée du client
imAddress string

Adresse de messagerie instantanée du client.

E-mail client
email string

E-mail du client.

Nom
name True string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

Retours

Planifier un nouvel appel sortant avec le flux de travail

Planifiez un nouvel appel sortant avec le flux de travail (entrée du planificateur).

Paramètres

Nom Clé Obligatoire Type Description
ID de référence
ReferenceId string

ID de référence passé par le système tiers.

Destination
destination True string

Destination de l’appel sortant avec workflow.

Date d’échéance (UTC)
dueDateTimeUtc True date-time

Date et heure d’échéance au format UTC : Exemple : « 2020-03-23T11:00:00Z ».

Service UPN
serviceUpn True string

UPN du service.

Nombre maximal de tentatives
maxAttempts integer

Nombre maximal de tentatives d’atteindre la destination.

Délai d’expiration de la tentative en secondes
attemptTimeoutInSeconds integer

Définit la durée pendant laquelle Nimbus tente d’atteindre la destination avant l’arrêt de la tentative.

Nom
name True string

Nom du paramètre de contexte personnalisé.

Valeur
value string

Valeur du paramètre de contexte personnalisé.

Prénom du client
firstName string

Prénom du client.

Nom du client
lastName string

Nom du client.

Nom d’affichage du client
displayName string

Nom complet du client.

Entreprise cliente
company string

Société du client.

Titre du travail client
jobTitle string

Titre du travail du client.

Service client
department string

Service du client.

Adresse postale du client
streetAddress string

Adresse postale du client.

Code postal du client
postCode string

Code postal du client.

Ville du client
city string

Ville du client.

Région du client
state string

État du client.

Pays du client
country string

Pays du client.

Numéro de téléphone principal du client
primaryTelNumber string

Numéro de téléphone principal du client.

Nom
name True string

Désignation du numéro de téléphone.

Valeur
value string

Valeur du numéro de téléphone.

UPN client
UPN string

UPN du client.

Adresse de messagerie instantanée du client
imAddress string

Adresse de messagerie instantanée du client.

E-mail client
email string

E-mail du client.

Nom
name True string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

Retours

Supprimer les contacts d’un carnet d’adresses

Supprimez un ou plusieurs contacts d’un carnet d’adresses.

Paramètres

Nom Clé Obligatoire Type Description
Carnet d’adresses
AddressBook True string

Carnet d’adresses à partir duquel supprimer le contact.

externalIds
externalIds True array of string

Supprimer une entrée de planificateur

Supprimez une entrée de planificateur du système. Seule possible, alors que l’entrée du planificateur n’est pas encore en cours.

Paramètres

Nom Clé Obligatoire Type Description
ID d’entrée du planificateur
SchedulerEntryID True string

ID de l’entrée du planificateur à supprimer.

Supprimer une tâche externe

Supprimer une tâche externe

Paramètres

Nom Clé Obligatoire Type Description
ID de tâche externe
externalTaskId True string

ID de la tâche externe en cours de suppression

Vider un carnet d’adresses

Supprimez tous les contacts dans le carnet d’adresses spécifié.

Paramètres

Nom Clé Obligatoire Type Description
Carnet d’adresses
AddressBook True string

Carnet d’adresses à vide

Déclencheurs

Lorsqu’une entrée du planificateur change d’état

Déclenché chaque fois qu’une entrée du planificateur correspondant aux critères de filtre change son état.

Lorsqu’une tâche change d’état

Déclenché chaque fois qu’une tâche correspondant aux critères de filtre change son état.

Quand l’Assistant utilisateur virtuel a une mise à jour

Cet événement est déclenché lorsque l’Assistant utilisateur virtuel a une nouvelle mise à jour.

Lorsqu’une entrée du planificateur change d’état

Déclenché chaque fois qu’une entrée du planificateur correspondant aux critères de filtre change son état.

Paramètres

Nom Clé Obligatoire Type Description
Services
services True array of string

UPN des services pour lesquels les événements pour les tâches doivent être récupérés.

Événements d’entrée du planificateur
schedulerEntryEvents True array of string

Événements de l’entrée du planificateur, pour lesquels ce déclencheur doit être déclenché.

Retours

Lorsqu’une tâche change d’état

Déclenché chaque fois qu’une tâche correspondant aux critères de filtre change son état.

Paramètres

Nom Clé Obligatoire Type Description
Services
services True array of string

UPN des services pour lesquels les événements pour les tâches doivent être récupérés.

Événements de tâche
taskEvents True array of string

Événements des tâches pour lesquelles ce déclencheur doit être déclenché.

Modalités
modalities array of string

Spécifiez les modalités initiales des tâches.

Directions
directions array of string

Spécifiez les instructions des tâches.

Retours

Quand l’Assistant utilisateur virtuel a une mise à jour

Cet événement est déclenché lorsque l’Assistant utilisateur virtuel a une nouvelle mise à jour.

Paramètres

Nom Clé Obligatoire Type Description
Services
services True array of string

UPN des services pour lesquels les événements pour les tâches doivent être récupérés.

Événements de l’Assistant Utilisateur virtuel
virtualUserAssistantEvents True array of string

Événements de l’Assistant utilisateur virtuel pour lequel ce déclencheur doit être déclenché.

Retours

Définitions

TaskEventData

Nom Chemin d’accès Type Description
ID de tâche
taskId string

ID spécifique à Nimbus de la tâche.

Service Session ID
serviceSessionId string

ID de la session de service

ID de session utilisateur
userSessionId string

ID de la session utilisateur

Session utilisateur démarrée avec le transfert
userSessionStartedWithTransfer boolean

Indique si la session utilisateur a été démarrée suite à un transfert.

ID de chaîne d’appels
callChainId string

ID de chaîne d’appels de Microsoft de la tâche.

Événement
event string

Événement qui s’est produit dans Nimbus pour la tâche.

Direction
direction string

Direction de la tâche en cours dans Nimbus (entrant/sortant/Aucun).

Modality
modality string

Modalité initiale de la tâche dans Nimbus.

Créé
created string

Horodatage, lorsque la tâche a été créée.

Arrêté
terminated string

Horodatage, lorsque la tâche a été arrêtée.

Reason
reason string

Motif de l’arrêt.

ID du dernier utilisateur connecté
lastConnectedUserId string

ID d’objet (AAD) du dernier utilisateur connecté de la tâche.

UPN de l’utilisateur connecté
LastConnectedUserUPN string

UPN du dernier utilisateur connecté de la tâche.

E-mail du dernier utilisateur connecté
LastConnectedUserEmail string

E-mail du dernier utilisateur connecté de la tâche.

ID de l’appelant Microsoft
microsoftCallerId string

ID d’objet (AAD) de l’appelant.

ID de référence
referenceId string

ID de référence passé par le système tiers.

ID de l’appelant
callerId string

ID interne de l’appelant dans Nimbus. ID d’objet (AAD) si l’appelant est connu.

Numéro de téléphone de l’appelant
callerTelNumber string

Numéro de téléphone (E.164) de l’appelant. Définissez uniquement pour les tâches avec modality=Audio.

UPN de l’appelant
callerUPN string

UPN du client.

Microsoft Destination ID
microsoftDestinationId string

ID d’objet (AAD) de l’appelé dans une tâche sortante.

Destination ID
destinationId string

ID interne de la destination (sortante) dans Nimbus. ID d’objet (AAD) si l’appelant est connu.

Numéro de téléphone de destination
destinationTelNumber string

Numéro de téléphone (E.164) de la destination (sortante).

Destination UPN
destinationUPN string

UPN de la destination (sortante).

ACS ID
acsId string

ID de communication Azure de l’appelant.

Est anonyme
isAnonymous boolean

Indicateur défini sur true, lorsque l’appelant est anonyme.

Identificateur du client
customerIdentifier string

Identificateur du client dans tous les types de tâches.

Initial Message
initialMessage string

Commencez par envoyer un message au client de messagerie instantanée.

Identifiant de service
serviceId string

ID interne du service Nimbus.

Nom du service
serviceName string

Nom du service Nimbus.

Service Description
serviceDescription string

Description du service Nimbus (hérité de Microsoft Teams).

Nom complet du service
serviceDisplayName string

Nom complet du service Nimbus.

Service UPN
serviceUPN string

UPN du service Nimbus.

Numéro de téléphone du service
serviceTelNumber string

Numéro de téléphone (E.164) du service Nimbus.

Objet de l’e-mail
emailSubject string

Objet de l’e-mail.

Texte enrichi unique du corps de l’e-mail
emailBodyUniqueRichText string

Corps de l’e-mail, texte enrichi.

Texte brut unique du corps de l’e-mail
emailBodyUniquePlainText string

Corps de l’e-mail, texte brut.

UPN de boîte aux lettres du service de messagerie
emailServiceMailboxUPN string

UPN de la boîte aux lettres affectée au service.

Tentatives de trafic sortant
outboundAttempt integer

Nombre de tentatives d’atteindre la destination sortante.

Nom du paramètre mis à jour
updatedParameterName string

Nom du dernier paramètre mis à jour.

Valeur de paramètre mise à jour
updatedParameterValue string

Valeur du dernier paramètre mis à jour.

Informations sur la tâche
taskInformation TaskInformation

Contient des informations sur le client, le paramètre de contexte personnalisé et les utilisateurs préférés.

TaskInformation

Contient des informations sur le client, le paramètre de contexte personnalisé et les utilisateurs préférés.

Nom Chemin d’accès Type Description
client
customer Customer

Objet contenant toutes les informations du client.

Paramètres de contexte personnalisés
customContextParameters array of CustomContextParameter

Liste des paramètres de contexte personnalisés (Key-Value).

Utilisateurs préférés
preferredUsers array of PreferredUser

Liste des utilisateurs préférés pour les tâches (UPN-Priority).

Client

Objet contenant toutes les informations du client.

Nom Chemin d’accès Type Description
Prénom du client
firstName string

Prénom du client.

Nom du client
lastName string

Nom du client.

Nom d’affichage du client
displayName string

Nom complet du client.

Entreprise cliente
company string

Société du client.

Titre du travail client
jobTitle string

Titre du travail du client.

Service client
department string

Service du client.

Adresse postale du client
streetAddress string

Adresse postale du client.

Code postal du client
postCode string

Code postal du client.

Ville du client
city string

Ville du client.

Région du client
state string

État du client.

Pays du client
country string

Pays du client.

Numéro de téléphone principal du client
primaryTelNumber string

Numéro de téléphone principal du client.

Numéros de téléphone
telNumbers array of TelNumber

Liste des numéros de téléphone supplémentaires du client.

UPN client
UPN string

UPN du client.

Adresse de messagerie instantanée du client
imAddress string

Adresse de messagerie instantanée du client.

E-mail client
email string

E-mail du client.

Champs personnalisés
customFields array of CustomField

Liste des champs personnalisés du client.

TelNumber

Nom Chemin d’accès Type Description
Nom
name string

Désignation du numéro de téléphone.

Valeur
value string

Valeur du numéro de téléphone.

CustomField

Nom Chemin d’accès Type Description
Nom
name string

Désignation du champ personnalisé.

Valeur
value string

Valeur du champ personnalisé.

CustomContextParameter

Nom Chemin d’accès Type Description
Nom
name string

Nom du paramètre de contexte personnalisé.

Valeur
value string

Valeur du paramètre de contexte personnalisé.

PreferredUser

Nom Chemin d’accès Type Description
UPN
upn string

UPN de l’utilisateur préféré.

Priority
priority integer

Priorité. 1 haut à 99 bas.

ContactReadDto

Nom Chemin d’accès Type Description
Contacter l’ID externe
externalId string

ID du contact donné par le système externe.

Prénom du contact
firstName string

Prénom du contact.

Nom du contact
lastName string

Nom du contact.

Nom complet du contact
displayName string

Nom complet du contact.

Initiales du contact
initials string

Initiales du contact.

Contacter l’entreprise
company string

Société du contact.

Contacter le service
department string

Service du contact.

Titre du travail de contact
jobTitle string

Titre du travail du contact.

Contacter le nom d’utilisateur principal
userPrincipalName string

Nom d’utilisateur principal du contact.

Adresses de messagerie instantanée de contact
imAddresses array of string

Liste des adresses de messagerie instantanée.

Adresses e-mail de contact
emailAddresses array of string

Liste des adresses e-mail.

Contacter les téléphones professionnels
businessPhones array of string

Liste des téléphones professionnels.

Contacter les téléphones mobiles
mobilePhones array of string

Liste des téléphones mobiles.

Contacter les téléphones domestiques
homePhones array of string

Liste des téléphones domestiques.

Adresses
addresses array of Address

Liste des adresses.

customFields
customFields array of CustomField

Liste des champs personnalisés du contact.

Adresse

Nom Chemin d’accès Type Description
Rue d’adresse
street string

Rue et numéro de l’adresse.

Ville d’adresse
city string

Ville de l’adresse.

Pays d’adresse
country string

Pays de l’adresse.

État de l’adresse
state string

État de l’adresse.

Code postal d’adresse
postalCode string

Code postal de l’adresse.

SchedulerEntryEventData

Nom Chemin d’accès Type Description
ID d’entrée du planificateur
schedulerEntryId string

ID spécifique à Nimbus de l’entrée du planificateur.

ConversationType
conversationType string

Type de conversation de l’entrée du planificateur.

Événement
event string

Événement qui s’est produit dans Nimbus pour la tâche planifiée.

Direction
direction string

Direction de la tâche en cours dans Nimbus (entrant/sortant/Aucun).

Modality
modality string

Modalité initiale de la tâche dans Nimbus.

ID de référence
ReferenceId string

ID de référence passé par le système tiers.

ID de conversation unifiée
unifiedConversationId string

ID de conversation unifiée.

Raison de l’achèvement
completionReason string

Résultat de l’entrée du planificateur lorsqu’elle est terminée.

Destination
destination string

Destination des entrées du planificateur avec direction « Sortant ».

Priorité de distribution
distributionPriority string

Priorité avec laquelle la tâche doit être gérée dans Nimbus.

Date d’échéance (UTC)
dueDateTimeUtc date-time

Date et heure d’échéance au format UTC : Exemple : « 2020-03-23T11:00:00Z ».

Service UPN
serviceUpn string

UPN du service pour lequel l’entrée est planifiée.

Nombre maximal de tentatives
maxAttempts integer

Nombre maximal de tentatives d’atteindre la destination.

Délai d’expiration de la tentative en secondes
attemptTimeoutInSeconds integer

Délai d’expiration (intervalles) entre les nouvelles tentatives de connexion jusqu’à ce que le nombre maximal de tentatives soit atteint.

Durée maximale de file d’attente en secondes
maxQueueTimeInSeconds integer

Définit la durée pendant laquelle Nimbus tente de résoudre la tâche jusqu’à ce que la tâche soit considérée comme limite atteinte.

Délai d’expiration RONA en secondes
ronaTimeoutInSeconds integer

Définit la durée pendant laquelle Nimbus tente d’atteindre l’utilisateur jusqu’à ce que la tâche soit considérée comme RONA et qu’un nouvel utilisateur sera sélectionné.

Paramètres de contexte personnalisés
customCallContextParameters array of CustomContextParameter

Liste des paramètres de contexte personnalisés (Key-Value).

client
customer Customer

Objet contenant toutes les informations du client.

OutboundCallWithWorkflowSchedulerEntryEventData

Nom Chemin d’accès Type Description
ID d’entrée du planificateur
schedulerEntryId string

ID spécifique à Nimbus de l’entrée du planificateur.

ConversationType
conversationType string

Type de conversation de l’entrée du planificateur.

Événement
event string

Événement qui s’est produit dans Nimbus pour la tâche planifiée.

Direction
direction string

Direction de la tâche en cours dans Nimbus (entrant/sortant/Aucun).

Modality
modality string

Modalité initiale de la tâche dans Nimbus.

ID de référence
ReferenceId string

ID de référence passé par le système tiers.

ID de conversation unifiée
unifiedConversationId string

ID de conversation unifiée.

Raison de l’achèvement
completionReason string

Résultat de l’entrée du planificateur lorsqu’elle est terminée.

Destination
destination string

Destination des entrées du planificateur avec direction « Sortant ».

Priorité de distribution
distributionPriority string

Priorité avec laquelle la tâche doit être gérée dans Nimbus.

Date d’échéance (UTC)
dueDateTimeUtc date-time

Date et heure d’échéance au format UTC : Exemple : « 2020-03-23T11:00:00Z ».

Service UPN
serviceUpn string

UPN du service pour lequel l’entrée est planifiée.

Nombre maximal de tentatives
maxAttempts integer

Nombre maximal de tentatives d’atteindre la destination.

Délai d’expiration de la tentative en secondes
attemptTimeoutInSeconds integer

Définit la durée pendant laquelle Nimbus tente d’atteindre la destination avant l’arrêt de la tentative.

Paramètres de contexte personnalisés
customCallContextParameters array of CustomContextParameter

Liste des paramètres de contexte personnalisés (Key-Value).

client
customer Customer

Objet contenant toutes les informations du client.

VirtualUserAssistantEventData

Nom Chemin d’accès Type Description
ID de session unifiée
unifiedSessionId string

ID de la session unifiée Nimbus associée.

Service Session ID
serviceSessionId string

ID de la session de service Nimbus associée.

ID de session utilisateur
userSessionId string

ID de la session utilisateur Nimbus associée.

Service UPN
serviceUpn string

UPN du service pour lequel l’événement s’est produit.

Identifiant de service
serviceId string

ID du service pour lequel l’événement s’est produit.

Nom du service
serviceName string

Nom du service pour lequel l’événement s’est produit.

Événement
event string

Événement de l’Assistant utilisateur virtuel qui s’est produit dans Nimbus.

Session utilisateur démarrée avec le transfert
userSessionStartedWithTransfer boolean

Indique si la session utilisateur a été démarrée suite à un transfert.

ExternalTaskWriteResult

Nom Chemin d’accès Type Description
ID de tâche externe
id string

ID de la tâche externe ajoutée.

Modality
modality Modality

La modalité de la tâche.

Créé
created string

Horodatage, lorsque la tâche externe a été créée.

Type
type string

Type de la tâche externe.

Est anonyme
isAnonymous boolean

Indicateur défini sur true, lorsque l’appelant est anonyme.

Identifiant de service
serviceId string

ID interne du service Nimbus.

Nom du service
serviceName string

Nom du service Nimbus.

Service Description
serviceDescription string

Description du service Nimbus (hérité de Microsoft Teams).

Nom complet du service
serviceDisplayName string

Nom complet du service.

Service UPN
serviceUPN string

UPN du service.

Numéro de téléphone du service
serviceTelNumber string

Numéro de téléphone du service.

Utilisateurs préférés
preferredUsers array of PreferredUser

Liste des utilisateurs préférés pour les tâches (UPN-Priority).

Modality

La modalité de la tâche.

La modalité de la tâche.

Modality
string

CalendarStatus

État du service (Ouvert, Fermé, etc.).

État du service (Ouvert, Fermé, etc.).

État des heures d’ouverture
string