C TWO (préversion)

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

Ajouter un journal à la session

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

Annuler l’affectation d’un formulaire

Attribuer un formulaire

Créer un formulaire

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

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

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

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

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

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

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

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

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

Formulaire complet

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

Obtenir des files d’attente

Obtenir des formulaires

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

Obtenir le formulaire par ID

Obtenir les éléments de file d’attente

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

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

Verrouiller l’élément file d’attente

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

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

Définitions

string

Objet