C TWO (préversion)

C TWO est une plateforme de gestion agentique qui orchestre les workflows d’automatisation, gère les interactions de robot humain et traite des éléments de travail via des files d’attente universelles. Utilisez ce connecteur pour déclencher des flux à partir de sessions C TWO, gérer le cycle de vie des sessions, créer et traiter des éléments de file d’attente et activer des interactions humaines dans la boucle avec des travailleurs numériques.

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

Service	Classe	Regions
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 de chine Azure      - Us Department of Defense (DoD)
Power Apps	Premium	Toutes les régions Power Apps à l’exception des éléments suivants :      - 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	Prise en charge de C TWO
URL	https://ctwo.com/
Courrier électronique	customersuccess@ctwo.com

Métadonnées du connecteur
Éditeur	C TWO
Website	https://ctwo.com/
Politique de confidentialité	https://ctwo.com/privacy-policy/
Categories	Informatique décisionnelle; IA

C TWO

C TWO est une plateforme de gestion agentique qui orchestre les workflows d’automatisation, gère les interactions de robot humain et traite des éléments de travail via des files d’attente universelles. Ce connecteur permet Power Automate, Power Apps, Azure Logic Apps et Copilot Studio déclencheur et être déclenché par les sessions C TWO, de gérer le cycle de vie de session, de créer et de traiter des éléments de file d’attente universels et d’activer des interactions humaines dans la boucle avec des travailleurs numériques.

C TWO se trouve au-dessus de votre patrimoine d’automatisation comme une seule couche d’orchestration, de gouvernance et de surveillance : tout ce qui crée ou exécute le travail, C TWO ajoute le suivi sla, les nouvelles tentatives et la réparation automatique, la télémétrie de session en direct et une piste d’audit complète.

Prerequisites

Avant de créer une connexion, vous aurez besoin des éléments suivants :

1. Un locataire C TWO actif : C TWO Cloud (hébergé) ou un serveur C TWO local accessible via HTTPS.
2. Jeton de compte de service ou jeton d’accès personnel émis par votre administrateur C TWO (voir Obtention d’informations d’identification).
3. Si C TWO est hébergé localement, le serveur doit être accessible à partir de Power Platform sur HTTPS (pare-feu autorisant les plages d'adresses IP sortantes de Power Automate Microsoft Microsoft , Azure balises AzureConnectors.<region> de service et PowerPlatformPlex pour votre géo-plateforme Power Platform).
4. Un environnement Power Platform avec des autorisations de connecteur personnalisé et un niveau de licence prenant en charge les connecteurs personnalisés (Power Automate Premium ou équivalent).

Création d’une connexion

Lorsque vous créez une connexion, vous fournissez trois valeurs, toutes à partir de votre propre environnement C TWO :

1. Hôte C TWO : nom d’hôte de votre serveur C TWO uniquement (aucun schéma, aucune barre oblique de fin), par exemple connect24.ctwo.cloud, ou un hôte local avec un port facultatif tel que ctwo.contoso.com:8443.
2. URL de base C TWO : chemin de base de votre API C TWO, y compris votre division, en commençant par une barre oblique et sans barre oblique de fin, par exemple /DEFAULT/CTWO.Server/api.
3. Clé API : votre jeton, entré en tant que Bearer <your-token>. Un jeton de compte de service est recommandé ; Un jeton d’accès personnel fonctionne également.

Ensemble, l’HÔTE et l’URL de base acheminent le connecteur vers votre propre serveur C TWO (https://{Host}{Base URL}/…), afin que chaque client se connecte à son propre environnement : C TWO Cloud ou local.

Obtention d’informations d’identification

L’authentification utilise une clé API envoyée en tant que jeton porteur dans l’en-tête Authorization .

Jeton de compte de service (recommandé pour la production)

1. Connectez-vous à votre instance C TWO.
2. Accédez aux applications et connexions → Microsoft Power Automate → Créer un compte de service.
3. Copiez immédiatement le jeton généré . Il n’est affiché qu’une seule fois.

Jeton d’accès personnel (développement/test)

1. Ouvrez votre profil utilisateur en C TWO.
2. Accédez à l’onglet Jetons d’API et générez un nouveau jeton.
3. Copiez-la immédiatement : elle n’est affichée qu’une seule fois et n’est invalidée que si le compte d’utilisateur est désactivé.

Traitez les deux types de jetons comme des secrets : stockez-les uniquement dans les informations d’identification de connexion Power Platform, jamais dans les variables de flux ou le code côté client.

Opérations prises en charge

• Déclencheurs : démarrez un flux lorsque C TWO distribue une session, avec ou sans délai d’expiration appliqué.
• Gestion de session : signaler l’achèvement/l’échec, écrire les journaux de session typés, ajuster le délai d’expiration de la session et rechercher une demande d’arrêt appropriée.
• File d’attente universelle : créer, lister, verrouiller, déverrouiller, réessayer et différer les éléments de file d’attente ; mettre à jour les données d’élément et ajouter des journaux au niveau de l’élément ; ajouter/supprimer des balises ; récupérer des pièces jointes ; créer des états d’élément personnalisés ; répertorier les files d’attente.
• Human-in-the-loop : créez, affectez, annulez l’affectation et complétez des formulaires d’assistance humaine structurés, puis récupérez/interrogez-les.

Les opérations d’assistance interne remplissent des listes déroulantes dynamiques (sélecteurs de tâches et d’utilisateurs) et ne sont pas appelées directement.

Problèmes connus et limites

• Correction de l’HÔTE et de l’URL de base requises. Les deux sont entrés au moment de la connexion et routent le connecteur vers votre serveur C TWO. Des valeurs incorrectes ou inaccessibles entraînent des échecs de connexion ou de requête.
• Format de clé API. Le champ Clé API attend la chaîne Bearer <token> littérale : omettre les résultats du Bearer préfixe .401 Unauthorized
• Fourniture de données d’élément JSON. Les champs de données d’élément (Create Queue Item, Set Queue Item Data) sont des objets JSON. Dans un flux, fournissez un JSON littéral avec l’expression json('…') afin qu’il soit envoyé en tant qu’objet plutôt qu’une chaîne.
• Latence du déclencheur d’interrogation. Déclenche un sondage au lieu d’envoyer (push) un petit délai (lié par la périodicité du déclencheur) entre une session distribuée en C TWO et le démarrage du flux.
• Types de champs de formulaire. Certains champs d’identificateur retournés par les opérations de formulaire peuvent être un entier, une chaîne ou une valeur Null en fonction de l’état du formulaire.

Erreurs courantes et solutions

Error	Cause la plus probable	Résolution
401 Unauthorized	Clé API manquant le Bearer préfixe, expiré ou révoqué	Entrez à nouveau les informations d’identification en tant que Bearer <token>; générez un nouveau jeton de compte de service en cas de révocation
400 Bad request sur Créer un élément de file d’attente	Absence d’un champ obligatoire (reference, queueItemState, itemKey)	Remplir les trois champs obligatoires
Le déclencheur ne se déclenche jamais	Tâche incorrecte sélectionnée, ou la tâche C TWO n’est pas exposée à Power Automate	Vérifiez que la tâche apparaît dans la liste déroulante ID de tâche et qu’elle est configurée en tant que flux exposé dans C TWO
Données d’élément stockées sous forme de chaîne d’échappement	JSON fourni en tant que texte au lieu d’un objet	Utilisez l’expression json('…') (flux) ou le corps brut (test du connecteur) afin qu’il soit envoyé en tant qu’objet

FAQ

Puis-je utiliser ce connecteur à partir de Power Apps, de Azure Logic Apps et de Copilot Studio, pas seulement Power Automate ? Yes. Les déclencheurs sont Power Automate spécifiques, mais chaque action peut être appelée à partir de l’une de ces plateformes une fois qu’une connexion est créée.

Ce connecteur gère-t-il les licences ? No. C TWO orchestre et régit l’exécution ; les clients sont responsables de leur propre licence Microsoft.

Où puis-je obtenir de l’aide ? Contactez C TWO Customer Success at customersuccess@ctwo.com.

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	Description	Obligatoire
Hôte C TWO	string	Votre nom d’hôte serveur C TWO n’est qu’un schéma, aucune barre oblique de fin. Par exemple, connect24.ctwo.cloud, ou un hôte local avec un port facultatif tel que ctwo.contoso.com:8443.	True
C TWO Base URL	string	Chemin de base de votre API C TWO, y compris votre division. Commencez par une barre oblique, pas de barre oblique de fin. Par exemple /DEFAULT/CTWO. Serveur/API.	True
Clé API	securestring	Votre jeton d’API C TWO, entré en tant que : porteur <de votre jeton>. Un jeton de compte de service est recommandé ; Un jeton d’accès personnel fonctionne également.	True

Actions

Ajouter des étiquettes à l’élément de file d’attente	Ajoute une ou plusieurs balises à un élément de file d’attente pour la catégorisation et le filtrage. Les balises permettent d’organiser et de rechercher des éléments de travail dans les files d’attente.
Ajouter un journal à la session	Écrit une entrée de journal dans une session C TWO. Utilisez cette action pour suivre la progression, enregistrer les décisions ou consigner les informations de diagnostic pendant l’exécution du flux. Les journaux sont visibles dans la plateforme C TWO pour l’audit et la résolution des problèmes.
Ajouter un journal à un élément de file d’attente	Ajoute un message de journal à un élément de file d’attente pour la piste d’audit et la traçabilité. Utilisez cette action pour enregistrer les étapes de traitement, les avertissements ou les erreurs sur un élément de travail spécifique.
Annuler l’affectation d’un formulaire	Supprime l’attribution d’utilisateur actuelle d’un formulaire d’interaction robot, ce qui permet à d’autres utilisateurs de revendiquer.
Attribuer un formulaire	Affecte un formulaire d’interaction de robot à un utilisateur spécifique, ce qui les rend responsables de l’examen et de la fin de la demande human-in-the-loop.
Créer un formulaire	Crée un formulaire d’interaction robot qui permet à un travailleur numérique de demander de l’aide humaine. Le formulaire est présenté aux utilisateurs affectés dans la plateforme C TWO, ce qui permet aux scénarios humains dans la boucle où l’expertise humaine est nécessaire pour gérer les exceptions ou les décisions complexes.
Créer un élément de file d’attente	Crée un élément de travail dans une file d’attente universelle spécifiée. Utilisez cette action pour ajouter des éléments pour le traitement par des travailleurs numériques, notamment des charges utiles de données, des balises et des pièces jointes de fichier facultatives.
Créer un état d’élément de file d’attente	Crée un état personnalisé dans une file d’attente spécifique. Les états personnalisés vous permettent de définir des étapes de flux de travail au-delà des états par défaut (En attente, Terminé, Référencé), en adaptant la file d’attente à votre processus métier.
Différer l’élément de file d’attente	Reporte un élément de file d’attente afin qu’il ne soit pas traité tant que la date/heure spécifiée n’est pas traitée. Utilisez cette action lorsqu’un élément ne peut pas être traité maintenant, mais qu’il doit être retenté ultérieurement.
Définir le délai d’expiration de session	Met à jour la valeur du délai d’expiration d’une session C TWO active. Utilisez cette action pour étendre ou réduire le temps d’exécution autorisé pour une session en cours d’exécution lorsque le délai d’expiration d’origine a besoin d’un ajustement.
Définir les données d’élément de file d’attente	Met à jour le contenu des données d’un élément de file d’attente. Utilisez cette action pour modifier la charge utile d’un élément de travail pendant le traitement, par exemple pour stocker les résultats intermédiaires.
Définir l’état de l’élément de file d’attente	Modifie l’état d’un élément de file d’attente (par exemple, de En attente à Terminé ou à un état personnalisé). Utilisez cette action pour avancer les éléments via votre pipeline de flux de travail.
Définir l’état d’exécution du flux sur terminé	Marque une session C TWO comme terminée, signalant que le flux a terminé son travail avec succès. Placez cette action à la fin de votre flux pour renvoyer à C TWO que l’automatisation s’est terminée sans erreurs.
Définir l’état d’exécution du flux sur Échec	Marque une session C TWO comme ayant échoué, signalant qu’une erreur s’est produite pendant l’exécution du flux. Utilisez cette action dans les étendues de gestion des erreurs pour signaler les échecs à C TWO avec des détails sur ce qui s’est passé.
Déverrouiller l’élément de file d’attente	Déverrouille un élément de file d’attente précédemment verrouillé et le retourne à son état disponible. Utilisez cette action lorsque le traitement est interrompu et que l’élément doit être libéré pour d’autres workers.
Formulaire complet	Marque un formulaire d’interaction robot comme terminé, signalant que l’utilisateur humain a fourni l’entrée demandée et que le worker numérique peut reprendre le traitement.
Nouvelle tentative d’élément de file d’attente	Réessayez un élément de file d’attente spécifique, en remettant ses données sur sa valeur d’origine et en créant une nouvelle tentative.
Obtenir des files d’attente	Récupère les files d’attente universelles en fonction des critères de filtre. Utilisez cette action pour répertorier les files d’attente disponibles, vérifier leur configuration ou rechercher les détails de la file d’attente. Cette opération alimente également les listes déroulantes dynamiques dans d’autres actions.
Obtenir des formulaires	Récupère une liste de formulaires d’interaction robot avec filtrage facultatif. Utilisez cette action pour interroger les demandes de boucles humaines en attente, vérifier leur état ou rechercher des formulaires attribués à des utilisateurs spécifiques.
Obtenir la pièce jointe de l’élément de file d’attente	Récupère une pièce jointe de fichier spécifique à partir d’un élément de file d’attente en tant que données encodées en base64. Utilisez cette action pour télécharger des fichiers attachés à des éléments de travail lors de la création ou du traitement.
Obtenir le formulaire par ID	Récupère un formulaire d’interaction de robot spécifique par son identificateur unique. Utilisez cette action pour extraire les détails, les champs et l’état actuel d’un formulaire human-in-the-loop créé par un worker numérique.
Obtenir les éléments de file d’attente	Récupère les éléments de file d’attente en fonction de critères de filtre spécifiés, tels que l’état, les balises, les dates et les noms de file d’attente. Utilisez cette action pour rechercher et surveiller les éléments de travail dans vos files d’attente universelles.
Si l’arrêt de session doit être arrêté	Vérifie si C TWO a demandé un arrêt approprié (soft) pour la session donnée. Utilisez cette action dans des boucles pour vérifier régulièrement si la session doit se terminer tôt, ce qui permet au flux de nettoyer les ressources avant d’arrêter.
Supprimer les étiquettes de l’élément de file d’attente	Supprime une ou plusieurs balises d’un élément de file d’attente. Utilisez cette action pour mettre à jour la catégorisation des éléments de travail pendant le traitement.
Verrouiller l’élément file d’attente	Verrouille un élément de file d’attente pour empêcher les autres workers de le traiter simultanément. Utilisez cette action avant de traiter un élément de travail pour garantir un accès exclusif.

Ajouter des étiquettes à l’élément de file d’attente

ID d’opération :

AddItemTag

Ajoute une ou plusieurs balises à un élément de file d’attente pour la catégorisation et le filtrage. Les balises permettent d’organiser et de rechercher des éléments de travail dans les files d’attente.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	string	ID de l’élément de file d’attente à laquelle ajouter des balises.
Tags	tags		string	Liste de balises séparées par des virgules à ajouter.

Ajouter un journal à la session

ID d’opération :

AddLogToSession

Écrit une entrée de journal dans une session C TWO. Utilisez cette action pour suivre la progression, enregistrer les décisions ou consigner les informations de diagnostic pendant l’exécution du flux. Les journaux sont visibles dans la plateforme C TWO pour l’audit et la résolution des problèmes.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Identifiant de session	sessionId	True	string	ID de session C TWO où l’entrée du journal sera enregistrée. La valeur par défaut est l’ID de session à partir de la sortie du déclencheur.
level	level	True	string	Niveau de gravité de l’entrée de journal.
message	message	True	string	Contenu du message de journal à enregistrer.

Ajouter un journal à un élément de file d’attente

ID d’opération :

AddItemLog

Ajoute un message de journal à un élément de file d’attente pour la piste d’audit et la traçabilité. Utilisez cette action pour enregistrer les étapes de traitement, les avertissements ou les erreurs sur un élément de travail spécifique.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	string	ID de l’élément de file d’attente à connecter.
Niveau du journal	level		string	Niveau de gravité de l’entrée de journal.
Message	message		string	Contenu du message de journal.

Annuler l’affectation d’un formulaire

ID d’opération :

UnassignForm

Supprime l’attribution d’utilisateur actuelle d’un formulaire d’interaction robot, ce qui permet à d’autres utilisateurs de revendiquer.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de formulaire	formId	True	string	Human in the loop form id to unassign.

Attribuer un formulaire

ID d’opération :

AssignForm

Affecte un formulaire d’interaction de robot à un utilisateur spécifique, ce qui les rend responsables de l’examen et de la fin de la demande human-in-the-loop.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de formulaire	formId	True	string	Humain dans l’ID de formulaire de boucle à affecter.
userId	userId		integer	ID de l’utilisateur à attribuer au formulaire.

Créer un formulaire

ID d’opération :

CreateForm

Crée un formulaire d’interaction robot qui permet à un travailleur numérique de demander de l’aide humaine. Le formulaire est présenté aux utilisateurs affectés dans la plateforme C TWO, ce qui permet aux scénarios humains dans la boucle où l’expertise humaine est nécessaire pour gérer les exceptions ou les décisions complexes.

Paramètres

Nom	Clé	Obligatoire	Type	Description
champs	fields		string	Chaîne au format JSON définissant les champs de formulaire que l’utilisateur humain doit remplir.
titre	title		string	Titre affiché à l’utilisateur humain lorsqu’il ouvre le formulaire.
date limite	deadline		date-time	Échéance à laquelle l’homme doit répondre au formulaire (format ISO 8601).
Intro	intro		string	Texte d’introduction présenté à l’utilisateur humain expliquant quelle action est nécessaire.
identifiant d'article	itemId		integer	ID d’élément de file d’attente associé à ce formulaire, liant l’interaction humaine à un élément de travail spécifique.
workflowTaskId	workflowTaskId		integer	Tâche C TWO qui a créé ce formulaire.

Retours

Nom	Chemin d’accès	Type	Description
id	id	integer	id

Créer un élément de file d’attente

ID d’opération :

CreateItem

Crée un élément de travail dans une file d’attente universelle spécifiée. Utilisez cette action pour ajouter des éléments pour le traitement par des travailleurs numériques, notamment des charges utiles de données, des balises et des pièces jointes de fichier facultatives.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Clé d’élément	itemKey	True	string	Clé métier unique pour identifier cet élément de file d’attente (par exemple, numéro de facture, ID de cas).
État de l’élément de file d’attente	queueItemState	True	string	État initial de l’élément de file d’attente (par exemple, En attente).
Informations de référence sur la file d'	reference	True	string	Référence de file d’attente où l’élément sera créé.
Différé jusqu’à ce que	deferredUntil		date-time	Différer le traitement jusqu’à cette date/heure (format ISO 8601).
Données d’élément	itemData		object	Charge utile de données pour l’élément de file d’attente au format JSON.
Tags	tags		string	Balises pour l’élément de file d’attente (séparées par des virgules).
fileName	fileName		string	Nom du fichier de pièce jointe.
fileData	fileData		string	Données de fichier encodées en base64.
Identifiant de session	sessionId		string	ID de session associé à cet élément.
Appareil	device		string	Appareil qui a créé cet élément.
Utilisateur	user		string	Utilisateur qui a créé cet élément.
Fournisseur Automation	automationProvider		string	Fournisseur d’automatisation pour cet élément.

Retours

Nom	Chemin d’accès	Type	Description
id	id	integer	id
itemKey	itemKey	string	itemKey
Tentatives	attempts	integer	Tentatives
queueId	queueId	integer	queueId
id	state.id	integer	id
nom	state.name	string	nom
état	state.state	string	état
tags	tags	array of string	tags
créé	created	string	créé
createdByVendorSessionId	createdByVendorSessionId	integer	createdByVendorSessionId
Conclu	concluded	string	Conclu
Différé	deferred	string	Différé
test	test	boolean	test
verrouillé	locked	boolean	verrouillé

Créer un état d’élément de file d’attente

ID d’opération :

CreateItemState

Crée un état personnalisé dans une file d’attente spécifique. Les états personnalisés vous permettent de définir des étapes de flux de travail au-delà des états par défaut (En attente, Terminé, Référencé), en adaptant la file d’attente à votre processus métier.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Nom	name		string	Nom du nouvel état.
Calcul du temps de réponse	responseTimeCalculationBasis	True	string	Détermine la façon dont les contrats SLA de temps de réponse sont calculés pour les éléments entrant dans cet état.
Type d’état	state	True	string	Type d’état (en attente, terminé ou référencé).
ID de file d’attente	queueId	True	integer	ID de la file d’attente où cet état sera créé.
Description	description		string	Description de ce que cet état représente dans votre flux de travail.
Durée enregistrée par élément	timeSavedPerItem		integer	Durée enregistrée par élément dans cet état (secondes), utilisée pour la création de rapports sur le retour sur investissement.
Valeur générée par élément	valueGeneratedPerItem		integer	Valeur générée par élément dans cet état, utilisée pour la création de rapports sur le retour sur investissement.
Inclure dans les rapports	includeInReports		boolean	Indique s’il faut inclure cet état dans les rapports et les analyses.

Différer l’élément de file d’attente

ID d’opération :

DeferItem

Reporte un élément de file d’attente afin qu’il ne soit pas traité tant que la date/heure spécifiée n’est pas traitée. Utilisez cette action lorsqu’un élément ne peut pas être traité maintenant, mais qu’il doit être retenté ultérieurement.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	string	ID de l’élément de file d’attente à différer.
Différé jusqu’à ce que	deferredUntil		date-time	Date/heure à différer jusqu’au format ISO 8601.

Retours

response

string

Définir le délai d’expiration de session

ID d’opération :

SetTimeout

Met à jour la valeur du délai d’expiration d’une session C TWO active. Utilisez cette action pour étendre ou réduire le temps d’exécution autorisé pour une session en cours d’exécution lorsque le délai d’expiration d’origine a besoin d’un ajustement.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Identifiant de session	sessionId	True	string	ID de session C TWO pour lequel mettre à jour le délai d’expiration. La valeur par défaut est l’ID de session à partir de la sortie du déclencheur.
Délai d'attente	timeout	True	integer	Nouvelle valeur de délai d’expiration en secondes à appliquer à la session.

Retours

response

string

Définir les données d’élément de file d’attente

ID d’opération :

SetItemData

Met à jour le contenu des données d’un élément de file d’attente. Utilisez cette action pour modifier la charge utile d’un élément de travail pendant le traitement, par exemple pour stocker les résultats intermédiaires.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	string	ID de l’élément de file d’attente à mettre à jour.
Data	data		object	Nouvelle charge utile de données pour l’élément de file d’attente, en tant qu’objet JSON.
Créé	created		date-time	Horodatage de création pour ces données.

Définir l’état de l’élément de file d’attente

ID d’opération :

SetItemState

Modifie l’état d’un élément de file d’attente (par exemple, de En attente à Terminé ou à un état personnalisé). Utilisez cette action pour avancer les éléments via votre pipeline de flux de travail.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	string	ID de l’élément de file d’attente à mettre à jour.
State	state		string	Nouvel état de l’élément de file d’attente.

Définir l’état d’exécution du flux sur terminé

ID d’opération :

SetSessionCompleted

Marque une session C TWO comme terminée, signalant que le flux a terminé son travail avec succès. Placez cette action à la fin de votre flux pour renvoyer à C TWO que l’automatisation s’est terminée sans erreurs.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Identifiant de session	sessionId	True	string	ID de session C TWO à marquer comme terminé avec succès. La valeur par défaut est l’ID de session à partir de la sortie du déclencheur.

Retours

response

object

Définir l’état d’exécution du flux sur Échec

ID d’opération :

SetSessionFailed

Marque une session C TWO comme ayant échoué, signalant qu’une erreur s’est produite pendant l’exécution du flux. Utilisez cette action dans les étendues de gestion des erreurs pour signaler les échecs à C TWO avec des détails sur ce qui s’est passé.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Identifiant de session	sessionId	True	string	ID de session C TWO à marquer comme ayant échoué. La valeur par défaut est l’ID de session à partir de la sortie du déclencheur.
details	details	True	string	Description de l’erreur ou de l’exception qui a provoqué l’échec de la session.

Déverrouiller l’élément de file d’attente

ID d’opération :

UnlockItem

Déverrouille un élément de file d’attente précédemment verrouillé et le retourne à son état disponible. Utilisez cette action lorsque le traitement est interrompu et que l’élément doit être libéré pour d’autres workers.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	string	ID de l’élément de file d’attente à déverrouiller.

Formulaire complet

ID d’opération :

CompleteForm

Marque un formulaire d’interaction robot comme terminé, signalant que l’utilisateur humain a fourni l’entrée demandée et que le worker numérique peut reprendre le traitement.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de formulaire	formId	True	string	Humain dans l’ID de formulaire de boucle à marquer comme terminé.
completedAt	completedAt		date-time	Horodatage lorsque le formulaire a été terminé (format ISO 8601).

Nouvelle tentative d’élément de file d’attente

ID d’opération :

RetryItem

Réessayez un élément de file d’attente spécifique, en remettant ses données sur sa valeur d’origine et en créant une nouvelle tentative.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	integer	ID d’élément de file d’attente spécifique à réessayer.
ID d’état	stateId		integer	ID d’état de l’élément de file d’attente en attente spécifique à définir ; prend la priorité sur le paramètre d’état.
State	state		string	Nom d’état de l’élément de file d’attente en attente spécifique à définir.
ID de tâche de flux de travail	workflowTaskId		integer	Identificateur WorkflowTask.
ID de l’application	appId		integer	Identificateur de l’application.

Obtenir des files d’attente

ID d’opération :

GetQueues

Récupère les files d’attente universelles en fonction des critères de filtre. Utilisez cette action pour répertorier les files d’attente disponibles, vérifier leur configuration ou rechercher les détails de la file d’attente. Cette opération alimente également les listes déroulantes dynamiques dans d’autres actions.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de file d’attente	id		string	Filtrez par ID de file d’attente.
Informations de référence sur la file d'	reference		string	Filtrez par référence de file d’attente.
Nom de la file d’attente	name		string	Filtrez par nom de file d’attente.
Nom de l’état	stateName		string	Filtrez par nom d’état.
Supprimé	deleted		boolean	Filtrez par état supprimé.
Ignorer	skip		integer	Nombre d’enregistrements à ignorer pour la pagination.
Take	take		integer	Nombre d’enregistrements à retourner.

Retours

Nom	Chemin d’accès	Type	Description
		array of object
id	id	integer	Identificateur unique de la file d'attente.
supprimé	deleted	boolean	Indique si la file d’attente est supprimée.
nom	name	string	Nom de la file d’attente.
description	description	string	Description de la file d’attente.
visible	visible	boolean	Indique si la file d’attente est visible.
includeInReports	includeInReports	boolean	Indique s’il faut inclure dans des rapports.
créé	created	string	L’horodatage de la création.
Actualisé	updated	string	Horodatage de la dernière mise à jour.
deletedTime	deletedTime	string	Horodatage de suppression.
divisionId	divisionId	integer	Identificateur de division.
type	type	integer	Type de file d’attente.
référence	reference	string	Référence de file d’attente.
states	states	array of object	États disponibles dans cette file d’attente.
id	states.id	integer	Identificateur d’état.
nom	states.name	string	Nom de l’état.
description	states.description	string	Description de l’état.
tagfilter	states.tagfilter	string	Filtre d’étiquettes pour cet état.
état	states.state	integer	Type d’état.
timeSavedPerItem	states.timeSavedPerItem	integer	Durée enregistrée par élément.
includeInReports	states.includeInReports	boolean	Indique s’il faut inclure dans des rapports.
responseTimeCalculationBasis	states.responseTimeCalculationBasis	integer	Base du calcul du temps de réponse.

Obtenir des formulaires

ID d’opération :

GetForms

Récupère une liste de formulaires d’interaction robot avec filtrage facultatif. Utilisez cette action pour interroger les demandes de boucles humaines en attente, vérifier leur état ou rechercher des formulaires attribués à des utilisateurs spécifiques.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Ignorer	skip		integer	Nombre d’enregistrements à ignorer pour la pagination.
Take	take		integer	Nombre d’enregistrements à retourner.
Échéance avant	deadlineBefore		date-time	Filtrer les formulaires avec une échéance avant cette date/heure (ISO 8601).
Échéance après	deadlineAfter		date-time	Filtrez les formulaires avec une échéance après cette date/heure (ISO 8601).
Inclure terminé	includeCompleted		boolean	Indique s’il faut inclure des formulaires terminés dans les résultats.
Revendiqué par ID d’utilisateur	claimedByUserId		integer	Filtrez les formulaires revendiqués par un ID d’utilisateur spécifique.
Créé par l’ID de tâche de flux de travail	createdByWorkflowTaskId		integer	Filtrez les formulaires créés par un ID de tâche de flux de travail spécifique.

Retours

Nom	Chemin d’accès	Type	Description
		array of object
id	id	integer	id
divisionId	divisionId		divisionId
sessionID	sessionId		sessionID
queueItemId	queueItemId		queueItemId
claimedByUserId	claimedByUserId		claimedByUserId
claimedOn	claimedOn	string	claimedOn
createdByWorkflowTaskId	createdByWorkflowTaskId		createdByWorkflowTaskId
createdByUserId	createdByUserId		createdByUserId
createdOn	createdOn	string	createdOn
date limite	deadline	string	date limite
Terminé	completed	string	Terminé
undeferred	undeferred	boolean	undeferred

Obtenir la pièce jointe de l’élément de file d’attente

ID d’opération :

GetItemAttachment

Récupère une pièce jointe de fichier spécifique à partir d’un élément de file d’attente en tant que données encodées en base64. Utilisez cette action pour télécharger des fichiers attachés à des éléments de travail lors de la création ou du traitement.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	string	ID de l’élément de file d’attente contenant la pièce jointe.
ID des pièces jointes	attachmentId	True	string	ID de la pièce jointe à récupérer.
Filename	filename		string	Nom de fichier de la pièce jointe.

Retours

response

string

Obtenir le formulaire par ID

ID d’opération :

GetFormById

Récupère un formulaire d’interaction de robot spécifique par son identificateur unique. Utilisez cette action pour extraire les détails, les champs et l’état actuel d’un formulaire human-in-the-loop créé par un worker numérique.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de formulaire	formId	True	string	Humain dans l’ID de formulaire de boucle pour obtenir des détails.

Retours

Nom	Chemin d’accès	Type	Description
id	id	integer	id
divisionId	divisionId		divisionId
sessionID	sessionId		sessionID
queueItemId	queueItemId		queueItemId
claimedByUserId	claimedByUserId		claimedByUserId
claimedOn	claimedOn	string	claimedOn
createdByWorkflowTaskId	createdByWorkflowTaskId		createdByWorkflowTaskId
createdByUserId	createdByUserId		createdByUserId
createdOn	createdOn	string	createdOn
date limite	deadline	string	date limite
Terminé	completed	string	Terminé
titre	title	string	titre
Intro	intro	string	introduction
champs	fields	string	champs

Obtenir les éléments de file d’attente

ID d’opération :

GetItems

Récupère les éléments de file d’attente en fonction de critères de filtre spécifiés, tels que l’état, les balises, les dates et les noms de file d’attente. Utilisez cette action pour rechercher et surveiller les éléments de travail dans vos files d’attente universelles.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Clé d’élément	itemKey		string	Filtrer par clé d’élément.
Attempts	attempts		integer	Filtrez par nombre de tentatives.
Différé avant	deferredBefore		date-time	Filtrez les éléments différés avant cette date.
Différé après	deferredAfter		date-time	Filtrez les éléments différés après cette date.
Créé avant	createdBefore		date-time	Filtrez les éléments créés avant cette date.
Créé après	createdAfter		date-time	Filtrez les éléments créés après cette date.
Terminé avant	concludedBefore		date-time	Filtrer les éléments terminés avant cette date.
Terminé après	concludedAfter		date-time	Filtrez les éléments terminés après cette date.
État entré avant	stateEnteredTimeBefore		date-time	Filtrez les éléments entrés dans l’état avant cette heure.
État entré après	stateEnteredTimeAfter		date-time	Filtrez les éléments entrés dans l’état après cette heure.
States	states		string	Filtrer par état d’élément de file d’attente.
ID d’état de l’élément de file d’attente	queueItemStateIds		integer	Filtrez par ID d’état d’élément de file d’attente.
Noms d’état d’élément de file d’attente	queueItemStateNames		string	Filtrer par noms d’état d’élément de file d’attente.
Tags	tags		string	Filtrez par balises (séparées par des virgules).
ID de file d’attente	queueIds		integer	Filtrez par ID de file d’attente.
Noms de file d’attente	queueNames	True	string	Filtrer par noms de file d’attente (obligatoire).
References	references		string	Filtrez par références de file d’attente.
Inclure des données d’élément	includeItemData		boolean	Indique s’il faut inclure des données d’élément en réponse.
Ignorer	skip		integer	Nombre d’enregistrements à ignorer pour la pagination.
Take	take		integer	Nombre d’enregistrements à retourner.

Retours

Nom	Chemin d’accès	Type	Description
		array of object
id	id	integer	Identificateur unique de l’élément de file d’attente.
itemKey	itemKey	string	Clé unique de l’élément de file d’attente.
Tentatives	attempts	integer	Nombre de tentatives de traitement.
queueId	queueId	integer	Identificateur de la file d’attente parente.
id	state.id	integer	Identificateur d’état.
nom	state.name	string	Nom de l’état.
état	state.state	string	Valeur d’état.
tags	tags	array of string	Balises associées à l’élément de file d’attente.
créé	created	string	L’horodatage de la création.
createdByVendorSessionId	createdByVendorSessionId	integer	ID de session qui a créé cet élément.
Conclu	concluded	string	Horodatage de conclusion.
Différé	deferred	string	Horodatage différé.
test	test	boolean	Indique s’il s’agit d’un élément de test.
verrouillé	locked	boolean	Indique si l’élément est verrouillé.

Si l’arrêt de session doit être arrêté

ID d’opération :

IsStopRequested

Vérifie si C TWO a demandé un arrêt approprié (soft) pour la session donnée. Utilisez cette action dans des boucles pour vérifier régulièrement si la session doit se terminer tôt, ce qui permet au flux de nettoyer les ressources avant d’arrêter.

Paramètres

Nom	Clé	Obligatoire	Type	Description
Identifiant de session	sessionId	True	string	ID de session C TWO à rechercher une demande d’arrêt. La valeur par défaut est l’ID de session à partir de la sortie du déclencheur.

Retours

Nom	Chemin d’accès	Type	Description
isStopRequested	isStopRequested	boolean	isStopRequested

Supprimer les étiquettes de l’élément de file d’attente

ID d’opération :

RemoveItemTag

Supprime une ou plusieurs balises d’un élément de file d’attente. Utilisez cette action pour mettre à jour la catégorisation des éléments de travail pendant le traitement.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId	True	string	ID de l’élément de file d’attente à partir duquel supprimer les balises.
Tags	tags		string	Liste de balises séparées par des virgules à supprimer.

Verrouiller l’élément file d’attente

ID d’opération :

LockItem

Verrouille un élément de file d’attente pour empêcher les autres workers de le traiter simultanément. Utilisez cette action avant de traiter un élément de travail pour garantir un accès exclusif.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de l’élément de file d’attente	queueItemId		string	ID de l’élément de file d’attente à verrouiller. S’il est omis, l’élément disponible suivant correspondant au filtre est verrouillé.
Nom de la file d’attente	reference		string	Référence de file d’attente à partir de laquelle verrouiller un élément.
ID d’état	stateId		string	ID d’état pour filtrer les éléments.
Nom de l’état	stateName		string	Nom de l’état par lequel filtrer les éléments.
Identifiant de session	sessionId		string	ID de session de ce verrou.

Retours

Nom	Chemin d’accès	Type	Description
id	id	integer	Identificateur unique de l’élément verrouillé.
itemKey	itemKey	string	Clé unique de l’élément verrouillé.
Tentatives	attempts	integer	Nombre de tentatives de traitement.
queueId	queueId	integer	Identificateur de la file d’attente parente.
id	state.id	integer	Identificateur d’état.
nom	state.name	string	Nom de l’état.
état	state.state	string	Valeur d’état.
tags	tags	array of string	Balises associées à l’élément de file d’attente.
créé	created	string	L’horodatage de la création.
createdByVendorSessionId	createdByVendorSessionId	integer	ID de session qui a créé cet élément.
Conclu	concluded	string	Horodatage de conclusion.
Différé	deferred	string	Horodatage différé.
test	test	boolean	Indique s’il s’agit d’un élément de test.
verrouillé	locked	boolean	Indique si l’élément est verrouillé.

Déclencheurs

Démarrer le flux à partir de la demande de session sans délai d’expiration	Interroge les nouvelles sessions C TWO et déclenche le flux lorsqu’une session est créée pour la tâche sélectionnée. Utilisez ce déclencheur lorsque l’automatisation ne nécessite pas de contrainte de délai d’expiration. Le flux reçoit les détails de session, y compris les valeurs d’entrée transmises par C TWO.
Démarrer le flux à partir d’une demande de session avec délai d’expiration	Interroge les nouvelles sessions C TWO et déclenche le flux avec une contrainte de délai d’attente. Utilisez ce déclencheur lorsque l’automatisation doit se terminer dans une fenêtre de temps spécifique. Si la session dépasse le délai d’expiration, C TWO le gère en fonction de sa stratégie de délai d’expiration.

Démarrer le flux à partir de la demande de session sans délai d’expiration

ID d’opération :

StartFlowWithoutTimeout

Interroge les nouvelles sessions C TWO et déclenche le flux lorsqu’une session est créée pour la tâche sélectionnée. Utilisez ce déclencheur lorsque l’automatisation ne nécessite pas de contrainte de délai d’expiration. Le flux reçoit les détails de session, y compris les valeurs d’entrée transmises par C TWO.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de tâche	taskId	True	integer	Sélectionnez la tâche C TWO qui déclenchera ce flux. Lorsqu’une nouvelle session est créée pour cette tâche en C TWO, le flux démarre automatiquement sans appliquer de délai d’expiration.

Retours

Nom	Chemin d’accès	Type	Description
Sessions	sessions	array of object	Ensemble de sessions déclenchées par C TWO sans délai d’expiration
sessionID	sessions.sessionId	integer	sessionID
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
Nom du flux de travail	sessions.workflowName	string	Nom du flux de travail
nomDeTâche	sessions.taskName	string	nomDeTâche
créé	sessions.created	string	créé
processInputValues	sessions.processInputValues	object	processInputValues

Démarrer le flux à partir d’une demande de session avec délai d’expiration

ID d’opération :

StartFlowWithTimeout

Interroge les nouvelles sessions C TWO et déclenche le flux avec une contrainte de délai d’attente. Utilisez ce déclencheur lorsque l’automatisation doit se terminer dans une fenêtre de temps spécifique. Si la session dépasse le délai d’expiration, C TWO le gère en fonction de sa stratégie de délai d’expiration.

Paramètres

Nom	Clé	Obligatoire	Type	Description
ID de tâche	taskId	True	integer	Sélectionnez la tâche C TWO qui déclenchera ce flux. Lorsqu’une session est créée pour cette tâche, le flux commence par le délai d’expiration spécifié appliqué.
Délai d’expiration des secondes	timeout	True	integer	Durée maximale en secondes pendant laquelle la session est autorisée à s’exécuter avant que C TWO le marque comme expiré.

Retours

Nom	Chemin d’accès	Type	Description
Sessions	sessions	array of object	Ensemble de sessions déclenchées par C TWO avec délai d’expiration
sessionID	sessions.sessionId	integer	sessionID
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
Nom du flux de travail	sessions.workflowName	string	Nom du flux de travail
nomDeTâche	sessions.taskName	string	nomDeTâche
créé	sessions.created	string	créé
processInputValues	sessions.processInputValues	object	processInputValues

Définitions

string

Il s’agit du type de données de base « string ».

Objet

Il s’agit du type 'object'.