C TWO (preview)

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst	Class	Regions
Copilot Studio	Premium	Alle Power Automate regio's behalve:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)
Logic-apps	Standard	Alle Logic Apps-regio's , met uitzondering van het volgende:      - Azure Government regio's      - Azure China-regio's      - Us Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps regio's behalve:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate regio's behalve:      - Amerikaanse overheid (GCC)      - Amerikaanse overheid (GCC High)      - China Cloud beheerd door 21Vianet      - Us Department of Defense (DoD)

Contact
Naam	C TWO-ondersteuning
URL	https://ctwo.com/
E-mailadres	customersuccess@ctwo.com

Connectormetagegevens
Publisher	C TWO
Website	https://ctwo.com/
Privacybeleid	https://ctwo.com/privacy-policy/
Categorieën	Business Intelligence; AI

C TWO

C TWO is een Agentic Management Platform waarmee automatiseringswerkstromen worden georganiseerd, menselijke robotinteracties worden beheerd en werkitems worden verwerkt via universele wachtrijen. Met deze connector kunt u Power Automate, Power Apps, Azure Logic Apps en Copilot Studio activeren en worden geactiveerd door C TWO-sessies, de levenscyclus van sessies beheren, Universele wachtrijitems maken en verwerken en interacties tussen mensen in de lus mogelijk maken en verwerken met digitale werknemers.

C TWO bevindt zich boven uw automatiseringsomgeving als één indelings-, governance- en bewakingslaag: wat het werk maakt of uitvoert, C TWO voegt SLA-tracering, nieuwe pogingen en zelfherstel, live sessietelemetrie en een volledig audittrail toe.

Prerequisites

Voordat u een verbinding maakt, hebt u het volgende nodig:

1. Een actieve C TWO-tenant: C TWO Cloud (gehost) of een on-premises C TWO-server die bereikbaar is via HTTPS.
2. Een serviceaccounttoken of persoonlijk toegangstoken dat is uitgegeven door uw C TWO-beheerder (zie Referenties verkrijgen).
3. Als C TWO on-premises wordt gehost, moet de server bereikbaar zijn via Power Platform via HTTPS (firewall waarmee de Power Automate uitgaande IP-adresbereiken van Microsoft worden toegestaan, Azure servicetags AzureConnectors.<region> en PowerPlatformPlex voor uw Power Platform Geo).
4. Een Power Platform-omgeving met aangepaste connectormachtigingen en een licentielaag die ondersteuning biedt voor aangepaste connectors (Power Automate Premium of gelijkwaardig).

Een verbinding maken

Wanneer u een verbinding maakt, geeft u drie waarden op, allemaal vanuit uw eigen C TWO-omgeving:

1. C TWO-host : uw C TWO-serverhostnaam alleen (geen schema, geen afsluitende slash), bijvoorbeeld connect24.ctwo.cloudof een on-premises host met optionele poort, zoals ctwo.contoso.com:8443.
2. C TWO-basis-URL : het basispad van uw C TWO-API, inclusief uw divisie, beginnend met een slash en zonder afsluitende slash, bijvoorbeeld /DEFAULT/CTWO.Server/api.
3. API-sleutel : uw token, ingevoerd als Bearer <your-token>. Een serviceaccounttoken wordt aanbevolen; een persoonlijk toegangstoken werkt ook.

Samen routeren host- en basis-URL de connector naar uw eigen C TWO-server (https://{Host}{Base URL}/…), zodat elke klant verbinding maakt met zijn eigen omgeving: C TWO Cloud of on-premises.

Referenties verkrijgen

Verificatie maakt gebruik van een API-sleutel die is verzonden als een Bearer-token in de Authorization header.

Token voor serviceaccounts (aanbevolen voor productie)

1. Meld u aan bij uw C TWO-exemplaar.
2. Ga naar Apps en verbindingen → Microsoft Power Automate → Serviceaccount maken.
3. Kopieer het gegenereerde token onmiddellijk. Het wordt slechts één keer weergegeven.

Persoonlijk toegangstoken (ontwikkeling/testen)

1. Open uw gebruikersprofiel in C TWO.
2. Ga naar het tabblad API-tokens en genereer een nieuw token.
3. Kopieer deze onmiddellijk. Het wordt slechts eenmaal weergegeven en is ongeldig als het gebruikersaccount is uitgeschakeld.

Behandel beide tokentypen als geheimen. Sla ze alleen op in de verbindingsreferentie van Power Platform, nooit in stroomvariabelen of code aan de clientzijde.

Ondersteunde bewerkingen

• Triggers : start een stroom wanneer C TWO een sessie verzendt, met of zonder een afgedwongen time-out.
• Sessiebeheer : voltooiing/fout rapporteren, getypte sessielogboeken schrijven, de sessietime-out aanpassen en controleren op een probleemloze stopaanvraag.
• Universele wachtrij : wachtrijitems maken, weergeven, vergrendelen, ontgrendelen, opnieuw proberen en uitstellen; itemgegevens bijwerken en logboeken op itemniveau toevoegen; tags toevoegen/verwijderen; bijlagen ophalen; aangepaste itemstatussen maken; lijstwachtrijen.
• Human-in-the-loop : maak, wijs gestructureerde formulieren voor menselijke hulp en vul deze in en haal deze op/query's op.

Interne helperbewerkingen vullen dynamische vervolgkeuzelijsten (taak- en gebruikerskiezers) en worden niet rechtstreeks aangeroepen.

Bekende problemen en beperkingen

• Juiste host- en basis-URL vereist. Beide worden ingevoerd tijdens de verbinding en routeren de connector naar uw C TWO-server. Onjuiste of onbereikbare waarden resulteren in verbindings- of aanvraagfouten.
• API-sleutelindeling. Het veld API-sleutel verwacht de letterlijke tekenreeks Bearer <token> , waarbij het Bearer voorvoegsel wordt weggelaten 401 Unauthorized.
• JSON-itemgegevens opgeven. Itemgegevensvelden (Create Queue Item, Set Queue Item Data) zijn JSON-objecten. Geef in een stroom letterlijke JSON op met de json('…') expressie, zodat deze wordt verzonden als een object in plaats van een tekenreeks.
• Latentie van pollingtriggers. Triggers peilen in plaats van pushen, dus er is een kleine vertraging (gebonden aan het trigger-terugkeerpatroon) tussen een sessie die wordt verzonden in C TWO en de stroom wordt gestart.
• Formulierveldtypen. Sommige id-velden die door de formulierbewerkingen worden geretourneerd, kunnen een geheel getal, een tekenreeks of null zijn, afhankelijk van de status van het formulier.

Veelvoorkomende fouten en oplossingen

Fout	Waarschijnlijke oorzaak	Oplossing
401 Unauthorized	API-sleutel ontbreekt het Bearer voorvoegsel, is verlopen of ingetrokken	Voer de referentie opnieuw in als Bearer <token>; genereer een nieuw serviceaccounttoken als dit is ingetrokken
400 Bad request bij Wachtrijitem maken	Een vereist veld ontbreekt (reference, queueItemState, itemKey)	Vul alle drie de vereiste velden in
Trigger wordt nooit geactiveerd	Verkeerde taak geselecteerd of de C TWO-taak wordt niet blootgesteld aan Power Automate	Controleer of de taak wordt weergegeven in de vervolgkeuzelijst Taak-id en is geconfigureerd als een weergegeven stroom in C TWO
Itemgegevens die zijn opgeslagen als een escape-tekenreeks	JSON opgegeven als tekst in plaats van een object	Gebruik de json('…') expressie (stromen) of Raw Body (connectortest) zodat deze wordt verzonden als een object

FAQ

Kan ik deze connector gebruiken vanuit Power Apps, Azure Logic Apps en Copilot Studio, niet alleen Power Automate? Yes. De triggers zijn Power Automate-specifiek, maar elke actie kan worden aangeroepen vanaf een van deze platforms zodra er een verbinding is gemaakt.

Beheert deze connector licenties? No. C TWO organiseert en beheert de uitvoering; klanten zijn verantwoordelijk voor hun eigen Microsoft licentieverlening.

Waar kan ik hulp krijgen? Neem contact op met C TWO Customer Success op customersuccess@ctwo.com.

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:

standaard	Parameters voor het maken van verbinding.	Alle regio's	Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Naam	Typ	Description	Verplicht
C TWO Host	string	Uw C TWO-serverhostnaam is slechts â€" geen schema, geen afsluitende slash. Bijvoorbeeld connect24.ctwo.cloud of een on-premises host met optionele poort, zoals ctwo.contoso.com:8443.	True
C TWO Base URL	string	Het basispad van uw C TWO-API, inclusief uw divisie. Begin met een slash, geen afsluitende slash. Bijvoorbeeld /DEFAULT/CTWO. Server/API.	True
API-sleutel	beveiligde string	Uw C TWO API-token, ingevoerd als: Bearer <your-token>. Een serviceaccounttoken wordt aanbevolen; een persoonlijk toegangstoken werkt ook.	True

Acties

Formulier intrekken	Hiermee verwijdert u de huidige gebruikerstoewijzing uit een robotinteractieformulier, zodat deze beschikbaar is voor andere gebruikers om te claimen.
Formulier invullen	Markeert een robotinteractieformulier als voltooid en signaleert dat de menselijke gebruiker de gevraagde invoer heeft verstrekt en de digitale werknemer de verwerking kan hervatten.
Formulier maken	Hiermee maakt u een nieuw robotinteractieformulier waarmee een digitale werknemer menselijke hulp kan aanvragen. Het formulier wordt gepresenteerd aan toegewezen gebruikers in het C TWO-platform, waardoor human-in-the-loop-scenario's mogelijk zijn waar menselijke expertise nodig is om uitzonderingen of complexe beslissingen af te handelen.
Formulier ophalen op id	Haalt een specifieke robotinteractievorm op met behulp van de unieke id. Gebruik deze actie om de details, velden en huidige status van een human-in-the-loop-formulier op te halen dat is gemaakt door een digitale werknemer.
Formulier toewijzen	Wijst een robotinteractieformulier toe aan een specifieke gebruiker, waardoor ze verantwoordelijk zijn voor het beoordelen en voltooien van de human-in-the-loop-aanvraag.
Formulieren ophalen	Hiermee haalt u een lijst met robotinteractieformulieren op met optionele filters. Gebruik deze actie om query's uit te voeren op aanvragen voor mensen in de lus, hun status te controleren of formulieren te zoeken die zijn toegewezen aan specifieke gebruikers.
Logboek toevoegen aan sessie	Hiermee schrijft u een logboekvermelding naar een C TWO-sessie. Gebruik deze actie om de voortgang bij te houden, beslissingen te nemen of diagnostische gegevens vast te leggen tijdens de uitvoering van de stroom. Logboeken zijn zichtbaar in het C TWO-platform voor controle en probleemoplossing.
Logboek toevoegen aan wachtrijitem	Hiermee voegt u een logboekbericht toe aan een wachtrijitem voor controletrail en traceerbaarheid. Gebruik deze actie om verwerkingsstappen, waarschuwingen of fouten vast te leggen voor een specifiek werkitem.
Moet sessie stoppen	Controleert of C TWO een respijtende (zachte) stop voor de opgegeven sessie heeft aangevraagd. Gebruik deze actie in lussen om periodiek te controleren of de sessie vroeg moet worden beëindigd, zodat de stroom resources kan opschonen voordat deze stopt.
Sessietime-out instellen	Hiermee wordt de time-outwaarde voor een actieve C TWO-sessie bijgewerkt. Gebruik deze actie om de toegestane uitvoeringstijd voor een actieve sessie uit te breiden of te verminderen wanneer de oorspronkelijke time-out moet worden aangepast.
Status van wachtrijitem instellen	Hiermee wijzigt u de status van een wachtrij-item (bijvoorbeeld van In behandeling naar Voltooid of in een aangepaste status). Gebruik deze actie om items door te voeren via uw werkstroompijplijn.
Status van wachtrijitem maken	Hiermee maakt u een nieuwe aangepaste status in een specifieke wachtrij. Met aangepaste statussen kunt u werkstroomfasen definiëren buiten de standaardstatussen (In behandeling, Voltooid, Verwezen), waarbij de wachtrij wordt aangepast aan uw bedrijfsproces.
Tags toevoegen aan wachtrijitem	Hiermee voegt u een of meer tags toe aan een wachtrij-item voor categorisatie en filtering. Tags helpen bij het organiseren en zoeken naar werkitems in wachtrijen.
Tags verwijderen uit wachtrijitem	Hiermee verwijdert u een of meer tags uit een wachtrijitem. Gebruik deze actie om de categorisatie van werkitems tijdens de verwerking bij te werken.
Uitvoeringsstatus van stroom instellen op Mislukt	Markeert een C TWO-sessie als mislukt, waarbij wordt aangegeven dat er een fout is opgetreden tijdens de uitvoering van de stroom. Gebruik deze actie in bereiken voor foutafhandeling om fouten terug te melden naar C TWO met details over wat er fout is gegaan.
Uitvoeringsstatus van stroom instellen op Voltooid	Markeert een C TWO-sessie als voltooid, waarbij wordt aangegeven dat de stroom zijn werk heeft voltooid. Plaats deze actie aan het einde van uw stroom om terug te rapporteren aan C TWO dat de automatisering zonder fouten is voltooid.
Wachtrij-item maken	Hiermee maakt u een nieuw werkitem in een opgegeven universele wachtrij. Gebruik deze actie om items toe te voegen voor verwerking door digitale werknemers, inclusief nettoladingen, tags en optionele bestandsbijlagen.
Wachtrij-item uitstellen	Hiermee wordt een wachtrijitem uitgesteld, zodat het niet wordt verwerkt tot de opgegeven datum/tijd. Gebruik deze actie wanneer een item nu niet kan worden verwerkt, maar later opnieuw moet worden geprobeerd.
Wachtrijen ophalen	Hiermee worden universele wachtrijen opgehaald op basis van filtercriteria. Gebruik deze actie om beschikbare wachtrijen weer te geven, de configuratie ervan te controleren of wachtrijgegevens op te zoeken. Deze bewerking zorgt ook voor dynamische vervolgkeuzelijsten in andere acties.
Wachtrijitem ontgrendelen	Ontgrendelt een eerder vergrendeld wachtrij-item en retourneert het naar de beschikbare status. Gebruik deze actie wanneer de verwerking wordt onderbroken en het item moet worden vrijgegeven voor andere werknemers.
Wachtrijitem opnieuw proberen	Voer een specifieke wachtrijitem opnieuw uit, stel de gegevens weer in op de oorspronkelijke waarde en maak een nieuwe poging.
Wachtrijitem vergrendelen	Hiermee wordt een wachtrijitem vergrendeld om te voorkomen dat andere werknemers het gelijktijdig verwerken. Gebruik deze actie voordat u een werkitem verwerkt om exclusieve toegang te garanderen.
Wachtrijitembijlage ophalen	Haalt een specifieke bestandsbijlage op uit een wachtrijitem als met base64 gecodeerde gegevens. Gebruik deze actie om bestanden te downloaden die zijn gekoppeld aan werkitems tijdens het maken of verwerken.
Wachtrijitemgegevens instellen	Hiermee werkt u de gegevensinhoud van een wachtrij-item bij. Gebruik deze actie om de nettolading van een werkitem tijdens de verwerking te wijzigen, bijvoorbeeld om tussenliggende resultaten op te slaan.
Wachtrijitems ophalen	Hiermee worden wachtrijitems opgehaald op basis van opgegeven filtercriteria, zoals status, tags, datums en wachtrijnamen. Gebruik deze actie om werkitems in uw universele wachtrijen te zoeken en te bewaken.

Formulier intrekken

Formulier invullen

Formulier maken

Formulier ophalen op id

Formulier toewijzen

Formulieren ophalen

Logboek toevoegen aan sessie

Logboek toevoegen aan wachtrijitem

Moet sessie stoppen

Sessietime-out instellen

Status van wachtrijitem instellen

Status van wachtrijitem maken

Tags toevoegen aan wachtrijitem

Tags verwijderen uit wachtrijitem

Uitvoeringsstatus van stroom instellen op Mislukt

Uitvoeringsstatus van stroom instellen op Voltooid

Wachtrij-item maken

Wachtrij-item uitstellen

Wachtrijen ophalen

Wachtrijitem ontgrendelen

Wachtrijitem opnieuw proberen

Wachtrijitem vergrendelen

Wachtrijitembijlage ophalen

Wachtrijitemgegevens instellen

Wachtrijitems ophalen

Triggers

Stroom starten vanaf sessieaanvraag zonder time-out	Polls voor nieuwe C TWO-sessies en activeert de stroom wanneer een sessie wordt gemaakt voor de geselecteerde taak. Gebruik deze trigger wanneer voor de automatisering geen time-outbeperking is vereist. De stroom ontvangt sessiedetails, inclusief invoerwaarden die zijn doorgegeven vanuit C TWO.
Stroom starten vanuit sessieaanvraag met time-out	Polls voor nieuwe C TWO-sessies en activeert de stroom met een time-outbeperking. Gebruik deze trigger wanneer de automatisering binnen een bepaald tijdvenster moet worden voltooid. Als de sessie de time-out overschrijdt, verwerkt C TWO deze volgens het time-outbeleid.

Stroom starten vanaf sessieaanvraag zonder time-out

Stroom starten vanuit sessieaanvraag met time-out

Definities

string

object