C TWO (versão prévia)

O C TWO é uma Plataforma de Gerenciamento Agentic que orquestra fluxos de trabalho de automação, gerencia interações entre humanos e robôs e processa itens de trabalho por meio de filas universais. Use esse conector para disparar fluxos de sessões C TWO, gerenciar o ciclo de vida da sessão, criar e processar itens de fila e habilitar interações humanas no loop com trabalhadores digitais.

Esse conector está disponível nos seguintes produtos e regiões:

Service	Class	Regions
Copilot Studio	Premium	Todas as regiões Power Automate exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos	Standard	Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:      – Azure Governamental regiões      - Azure regiões da China      - Departamento de Defesa dos EUA (DoD)
Power Apps	Premium	Todas as regiões Power Apps exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Power Automate	Premium	Todas as regiões Power Automate exceto as seguintes:      – Governo dos EUA (GCC)      – Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contact
Nome	Suporte a C TWO
URL	https://ctwo.com/
Email	customersuccess@ctwo.com

Metadados do conector
Publicador	C DOIS
Website	https://ctwo.com/
Política de privacidade	https://ctwo.com/privacy-policy/
Categories	Business Intelligence; IA

C DOIS

O C TWO é uma Plataforma de Gerenciamento Agentic que orquestra fluxos de trabalho de automação, gerencia interações entre humanos e robôs e processa itens de trabalho por meio de filas universais. Esse conector permite Power Automate, Power Apps, Aplicativos Lógicos do Azure e disparar Copilot Studio e ser disparado por sessões C TWO, gerenciar o ciclo de vida da sessão, criar e processar itens da Fila Universal e habilitar interações humanas no loop com trabalhadores digitais.

O C TWO está acima de sua propriedade de automação como uma única camada de orquestração, governança e monitoramento: o que quer que crie ou execute o trabalho, C TWO adiciona acompanhamento de SLA, repetições e auto-recuperação, telemetria de sessão ao vivo e uma trilha de auditoria completa.

Pré-requisitos

Antes de criar uma conexão, você precisará:

1. Um locatário C TWO ativo – C TWO Cloud (hospedado) ou um servidor C TWO local acessível por HTTPS.
2. Um token de Conta de Serviço ou Token de Acesso Pessoal emitido pelo administrador do C TWO (consulte Obtendo credenciais).
3. Se o C TWO estiver hospedado localmente, o servidor deverá ser acessível do Power Platform via HTTPS (firewall que permite os intervalos de IP de saída Power Automate do Microsoft — Azure Marcas AzureConnectors.<region> de Serviço e PowerPlatformPlex para o Power Platform Geo).
4. Um ambiente do Power Platform com permissões de Conector Personalizado e uma camada de licença que dá suporte a conectores personalizados (Power Automate Premium ou equivalente).

Criando uma conexão

Ao criar uma conexão, você fornece três valores, todos de seu próprio ambiente C TWO:

1. Host C TWO – seu nome de host do servidor C TWO somente (sem esquema, sem barra à direita), por exemplo connect24.ctwo.cloud, ou um host local com porta opcional, como ctwo.contoso.com:8443.
2. URL base C TWO – o caminho base da sua API C TWO, incluindo sua divisão, começando com uma barra e sem barra à direita, por exemplo. /DEFAULT/CTWO.Server/api
3. Chave de API – seu token, inserido como Bearer <your-token>. Um token de Conta de Serviço é recomendado; um Token de Acesso Pessoal também funciona.

Juntos, o Host e a URL Base roteiam o conector para seu próprio servidor C TWO (https://{Host}{Base URL}/…), para que cada cliente se conecte ao seu próprio ambiente – C TWO Cloud ou local.

Obtendo credenciais

A autenticação usa uma chave de API enviada como um token de portador no Authorization cabeçalho.

Token da Conta de Serviço (recomendado para produção)

1. Entre na instância do C TWO.
2. Vá para Aplicativos e Conexões → Microsoft Power Automate → Criar conta de serviço.
3. Copie o token gerado imediatamente — ele é mostrado apenas uma vez.

Token de Acesso Pessoal (desenvolvimento/teste)

1. Abra seu perfil de usuário em C2.
2. Vá para a guia Tokens de API e gere um novo token.
3. Copie-o imediatamente – ele será mostrado apenas uma vez e será invalidado se a conta de usuário estiver desabilitada.

Trate ambos os tipos de token como segredos – armazene-os apenas na credencial de conexão do Power Platform, nunca em variáveis de fluxo ou código do lado do cliente.

Operações com suporte

• Gatilhos – inicie um fluxo quando C TWO expedir uma sessão, com ou sem um tempo limite imposto.
• Gerenciamento de sessão – Conclusão/falha do relatório, gravação de logs de sessão tipado, ajuste o tempo limite da sessão e verifique se há uma solicitação de parada normal.
• Fila Universal — Criar, listar, bloquear, desbloquear, tentar novamente e adiar itens de fila; atualizar dados de item e adicionar logs no nível do item; adicionar/remover marcas; recuperar anexos; criar estados de item personalizados; listar filas.
• Human-in-the-loop – Criar, atribuir, cancelar a atribuição e preencher formulários estruturados de assistência humana e recuperá-los/consultá-los.

As operações auxiliares internas populam listas suspensas dinâmicas (seletores de tarefas e usuários) e não são chamadas diretamente.

Limitações e problemas conhecidos

• Host correto e URL base necessários. Ambos são inseridos no momento da conexão e roteam o conector para o servidor C TWO. Valores incorretos ou inacessíveis resultam em falhas de conexão ou solicitação.
• Formato de chave de API. O campo Chave de API espera a cadeia Bearer <token> de caracteres literal – omitindo os resultados do Bearer prefixo em 401 Unauthorized.
• Fornecendo dados de item JSON. Campos de dados de item (Create Queue Item, Set Queue Item Data) são objetos JSON. Em um fluxo, forneça JSON literal com a json('…') expressão para que ela seja enviada como um objeto em vez de uma cadeia de caracteres.
• Latência do gatilho de sondagem. Dispara a sondagem em vez de push, portanto, há um pequeno atraso (limitado pela recorrência do gatilho) entre uma sessão sendo expedida em C TWO e o fluxo começando.
• Tipos de campo de formulário. Alguns campos de identificador retornados pelas operações de formulário podem ser inteiros, uma cadeia de caracteres ou nulos, dependendo do estado do formulário.

Erros e soluções comuns

Erro	Causa provável	Solução
401 Unauthorized	Chave de API ausente do Bearer prefixo, expirada ou revogada	Insira novamente a credencial como Bearer <token>; gere um novo token de Conta de Serviço se revogado
400 Bad request em Criar Item de Fila	Faltando um campo necessário (reference, queueItemState, itemKey)	Preencher todos os três campos necessários
Gatilho nunca é acionado	Tarefa incorreta selecionada ou a tarefa C TWO não é exposta a Power Automate	Confirme se a tarefa aparece na lista suspensa ID da Tarefa e é configurada como um fluxo exposto em C TWO
Dados de item armazenados como uma cadeia de caracteres com escape	JSON fornecido como texto em vez de um objeto	Use a json('…') expressão (fluxos) ou Corpo Bruto (teste do conector) para que ela seja enviada como um objeto

perguntas frequentes

Posso usar esse conector de Power Apps, Aplicativos Lógicos do Azure e Copilot Studio, não apenas Power Automate? Sim. Os gatilhos são Power Automate específicos, mas todas as ações podem ser chamadas de qualquer uma dessas plataformas depois que uma conexão é criada.

Esse conector gerencia o licenciamento? No. O C TWO orquestra e rege a execução; os clientes são responsáveis por seu próprio licenciamento Microsoft.

Onde posso obter ajuda? Contate o êxito do cliente C TWO em customersuccess@ctwo.com.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Default	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
C TWO Host	cadeia	Seu nome de host do servidor C TWO apenas "sem esquema, sem barra à direita. Por exemplo, connect24.ctwo.cloud ou um host local com porta opcional, como ctwo.contoso.com:8443.	Verdade
C TWO Base URL	cadeia	O caminho base da sua API C TWO, incluindo sua divisão. Comece com uma barra, sem barra à direita. Por exemplo /DEFAULT/CTWO. Servidor/api.	Verdade
Chave de API	secureString	Seu token de API C TWO, inserido como: Portador <do token>. Um token de Conta de Serviço é recomendado; um Token de Acesso Pessoal também funciona.	Verdade

Ações

Adiar item de fila	Adia um item de fila para que ele não seja processado até a data/hora especificada. Use essa ação quando um item não puder ser processado agora, mas deverá ser repetido mais tarde.
Adicionar log ao item de fila	Adiciona uma mensagem de log a um item de fila para rastreamento e trilha de auditoria. Use essa ação para registrar etapas de processamento, avisos ou erros em um item de trabalho específico.
Adicionar log à sessão	Grava uma entrada de log em uma sessão C TWO. Use essa ação para acompanhar o progresso, as decisões de registro ou as informações de diagnóstico de log durante a execução do fluxo. Os logs estão visíveis na plataforma C TWO para auditoria e solução de problemas.
Adicionar marcas ao item de fila	Adiciona uma ou mais marcas a um item de fila para categorização e filtragem. As marcas ajudam a organizar e pesquisar itens de trabalho entre filas.
Atribuir Formulário	Atribui um formulário de interação de robô a um usuário específico, tornando-o responsável por revisar e concluir a solicitação humana no loop.
Cancelar a atribuição de formulário	Remove a atribuição de usuário atual de um formulário de interação de robô, tornando-a disponível para outros usuários reivindicarem.
Criar estado do item de fila	Cria um novo estado personalizado em uma fila específica. Os estados personalizados permitem que você defina estágios de fluxo de trabalho além dos estados padrão (Pendentes, Concluídos, Encaminhados), adaptando a fila ao processo de negócios.
Criar Formulário	Cria um novo formulário de interação de robô que permite que um trabalhador digital solicite assistência humana. O formulário é apresentado aos usuários atribuídos na plataforma C TWO, permitindo cenários humanos no loop em que a experiência humana é necessária para lidar com exceções ou decisões complexas.
Criar item de fila	Cria um novo item de trabalho em uma fila universal especificada. Use essa ação para adicionar itens para processamento por trabalhadores digitais, incluindo cargas de dados, marcas e anexos de arquivo opcionais.
Definir dados de item de fila	Atualiza o conteúdo de dados de um item de fila. Use essa ação para modificar o conteúdo de um item de trabalho durante o processamento, por exemplo, para armazenar resultados intermediários.
Definir o estado de execução de fluxo como com falha	Marca uma sessão C TWO como falha, sinalizando que ocorreu um erro durante a execução do fluxo. Use essa ação em escopos de tratamento de erros para relatar falhas de volta ao C TWO com detalhes sobre o que deu errado.
Definir o estado de execução do fluxo como concluído	Marca uma sessão C TWO como concluída, sinalizando que o fluxo terminou seu trabalho com êxito. Coloque essa ação no final do fluxo para relatar ao C TWO que a automação concluiu sem erros.
Definir o estado do item da fila	Altera o estado de um item de fila (por exemplo, de Pendente para Concluído ou para um estado personalizado). Use essa ação para avançar itens por meio do pipeline de fluxo de trabalho.
Definir o tempo limite da sessão	Atualiza o valor do tempo limite para uma sessão C TWO ativa. Use essa ação para estender ou reduzir o tempo de execução permitido para uma sessão em execução quando o tempo limite original precisar de ajuste.
Desbloquear item de fila	Desbloqueia um item de fila bloqueado anteriormente e o retorna ao estado disponível. Use essa ação quando o processamento for interrompido e o item deve ser liberado para outros trabalhadores.
Deve parar a sessão	Verifica se c two solicitou uma parada normal (suave) para a sessão determinada. Use essa ação dentro de loops para verificar periodicamente se a sessão deve terminar antecipadamente, permitindo que o fluxo limpe os recursos antes de parar.
Formulário completo	Marca um formulário de interação de robô como concluído, sinalizando que o usuário humano forneceu a entrada solicitada e que o trabalho digital pode retomar o processamento.
Item de Fila de Bloqueio	Bloqueia um item de fila para impedir que outros trabalhadores o processem simultaneamente. Use essa ação antes de processar um item de trabalho para garantir o acesso exclusivo.
Item de Fila de Repetição	Tente novamente um item de fila específico, definindo seus dados de volta para seu valor original e criando uma nova Tentativa.
Obter anexo de item de fila	Recupera um anexo de arquivo específico de um item de fila como dados codificados em base64. Use essa ação para baixar arquivos que foram anexados a itens de trabalho durante a criação ou processamento.
Obter filas	Recupera filas universais com base em critérios de filtro. Use essa ação para listar filas disponíveis, verificar a configuração ou pesquisar detalhes da fila. Essa operação também alimenta listas suspensas dinâmicas em outras ações.
Obter formulário por Id	Recupera um formulário de interação de robô específico por seu identificador exclusivo. Use essa ação para buscar os detalhes, os campos e o status atual de um formulário humano no loop criado por um trabalho digital.
Obter Formulários	Recupera uma lista de formulários de interação de robôs com filtragem opcional. Use essa ação para consultar solicitações humanas pendentes no loop, verificar seu status ou localizar formulários atribuídos a usuários específicos.
Obter itens de fila	Recupera itens de fila com base em critérios de filtro especificados, como estado, marcas, datas e nomes de fila. Use essa ação para pesquisar e monitorar itens de trabalho em suas filas universais.
Remover marcas do item de fila	Remove uma ou mais marcas de um item de fila. Use essa ação para atualizar a categorização de itens de trabalho durante o processamento.

Adiar item de fila

ID da operação:

DeferItem

Adia um item de fila para que ele não seja processado até a data/hora especificada. Use essa ação quando um item não puder ser processado agora, mas deverá ser repetido mais tarde.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	string	A ID do item de fila a ser adiada.
Adiado até	deferredUntil		date-time	A data/hora a ser adiada até (formato ISO 8601).

Retornos

response

string

Adicionar log ao item de fila

ID da operação:

AddItemLog

Adiciona uma mensagem de log a um item de fila para rastreamento e trilha de auditoria. Use essa ação para registrar etapas de processamento, avisos ou erros em um item de trabalho específico.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	string	A ID do item de fila para o qual fazer logon.
Nível de log	level		string	O nível de gravidade da entrada de log.
Mensagem	message		string	O conteúdo da mensagem de log.

Adicionar log à sessão

ID da operação:

AddLogToSession

Grava uma entrada de log em uma sessão C TWO. Use essa ação para acompanhar o progresso, as decisões de registro ou as informações de diagnóstico de log durante a execução do fluxo. Os logs estão visíveis na plataforma C TWO para auditoria e solução de problemas.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da sessão	sessionId	True	string	A ID da sessão C TWO em que a entrada de log será registrada. O padrão é a ID da sessão da saída do gatilho.
nível	level	True	string	O nível de gravidade da entrada de log.
mensagem	message	True	string	O conteúdo da mensagem de log a ser registrado.

Adicionar marcas ao item de fila

ID da operação:

AddItemTag

Adiciona uma ou mais marcas a um item de fila para categorização e filtragem. As marcas ajudam a organizar e pesquisar itens de trabalho entre filas.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	string	A ID do item de fila ao qual adicionar marcas.
Tags	tags		string	Lista separada por vírgulas de marcas a serem adicionadas.

Atribuir Formulário

ID da operação:

AssignForm

Atribui um formulário de interação de robô a um usuário específico, tornando-o responsável por revisar e concluir a solicitação humana no loop.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID de formulário	formId	True	string	Humano na ID do formulário de loop a ser atribuído.
userId	userId		integer	A ID do usuário à qual atribuir o formulário.

Cancelar a atribuição de formulário

ID da operação:

UnassignForm

Remove a atribuição de usuário atual de um formulário de interação de robô, tornando-a disponível para outros usuários reivindicarem.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID de formulário	formId	True	string	Humano na ID do formulário loop para cancelar a atribuição.

Criar estado do item de fila

ID da operação:

CreateItemState

Cria um novo estado personalizado em uma fila específica. Os estados personalizados permitem que você defina estágios de fluxo de trabalho além dos estados padrão (Pendentes, Concluídos, Encaminhados), adaptando a fila ao processo de negócios.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Nome	name		string	O nome do novo estado.
Cálculo de tempo de resposta	responseTimeCalculationBasis	True	string	Determina como os SLAs de tempo de resposta são calculados para itens que entram nesse estado.
Tipo de estado	state	True	string	O tipo de estado (pendente, concluído ou referenciado).
ID da Fila	queueId	True	integer	A ID da fila em que esse estado será criado.
Description	description		string	Uma descrição do que esse estado representa em seu fluxo de trabalho.
Tempo salvo por item	timeSavedPerItem		integer	Tempo salvo por item nesse estado (segundos), usado para relatórios ROI.
Valor gerado por item	valueGeneratedPerItem		integer	Valor gerado por item nesse estado, usado para relatórios ROI.
Incluir em relatórios	includeInReports		boolean	Se deve incluir esse estado em análises e relatórios.

Criar Formulário

ID da operação:

CreateForm

Cria um novo formulário de interação de robô que permite que um trabalhador digital solicite assistência humana. O formulário é apresentado aos usuários atribuídos na plataforma C TWO, permitindo cenários humanos no loop em que a experiência humana é necessária para lidar com exceções ou decisões complexas.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Campos	fields		string	Cadeia de caracteres formatada em JSON definindo os campos de formulário que o usuário humano precisa preencher.
title	title		string	O título exibido ao usuário humano quando ele abre o formulário.
prazo	deadline		date-time	O prazo pelo qual o humano deve responder ao formulário (formato ISO 8601).
Introdução	intro		string	Texto introdutório mostrado ao usuário humano explicando qual ação é necessária.
ID do item	itemId		integer	A ID do item de fila associada a esse formulário, vinculando a interação humana a um item de trabalho específico.
workflowTaskId	workflowTaskId		integer	A tarefa C TWO que criou esse formulário.

Retornos

Nome	Caminho	Tipo	Description
id	id	integer	id

Criar item de fila

ID da operação:

CreateItem

Cria um novo item de trabalho em uma fila universal especificada. Use essa ação para adicionar itens para processamento por trabalhadores digitais, incluindo cargas de dados, marcas e anexos de arquivo opcionais.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Chave de Item	itemKey	True	string	Uma chave de negócios exclusiva para identificar esse item de fila (por exemplo, número da fatura, ID do caso).
Estado do item de fila	queueItemState	True	string	O estado inicial do item de fila (por exemplo, Pendente).
Referência de fila	reference	True	string	A referência da fila em que o item será criado.
Adiado até	deferredUntil		date-time	Adie o processamento até esta data/hora (formato ISO 8601).
Dados do item	itemData		object	O conteúdo de dados do item de fila no formato JSON.
Tags	tags		string	Marcas para o item de fila (separado por vírgula).
fileName	fileName		string	O nome do arquivo de anexo.
fileData	fileData		string	Os dados do arquivo codificado em base64.
ID da sessão	sessionId		string	A ID da sessão associada a este item.
Dispositivo	device		string	O dispositivo que criou este item.
User	user		string	O usuário que criou este item.
Provedor de Automação	automationProvider		string	O provedor de automação para este item.

Retornos

Nome	Caminho	Tipo	Description
id	id	integer	id
itemKey	itemKey	string	itemKey
Tentativas	attempts	integer	Tentativas
queueId	queueId	integer	queueId
id	state.id	integer	id
nome	state.name	string	nome
estado	state.state	string	estado
tags	tags	array of string	tags
criado	created	string	criado
createdByVendorSessionId	createdByVendorSessionId	integer	createdByVendorSessionId
Concluiu	concluded	string	Concluiu
diferido	deferred	string	diferido
testar	test	boolean	testar
bloqueado	locked	boolean	bloqueado

Definir dados de item de fila

ID da operação:

SetItemData

Atualiza o conteúdo de dados de um item de fila. Use essa ação para modificar o conteúdo de um item de trabalho durante o processamento, por exemplo, para armazenar resultados intermediários.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	string	A ID do item de fila a ser atualizado.
Dados	data		object	O novo conteúdo de dados para o item de fila, como um objeto JSON.
Criado	created		date-time	O carimbo de data/hora de criação para esses dados.

Definir o estado de execução de fluxo como com falha

ID da operação:

SetSessionFailed

Marca uma sessão C TWO como falha, sinalizando que ocorreu um erro durante a execução do fluxo. Use essa ação em escopos de tratamento de erros para relatar falhas de volta ao C TWO com detalhes sobre o que deu errado.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da sessão	sessionId	True	string	Falha na ID da sessão C TWO para marcar. O padrão é a ID da sessão da saída do gatilho.
details	details	True	string	Uma descrição do erro ou exceção que causou falha na sessão.

Definir o estado de execução do fluxo como concluído

ID da operação:

SetSessionCompleted

Marca uma sessão C TWO como concluída, sinalizando que o fluxo terminou seu trabalho com êxito. Coloque essa ação no final do fluxo para relatar ao C TWO que a automação concluiu sem erros.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da sessão	sessionId	True	string	A ID da sessão C TWO para marcar como concluída com êxito. O padrão é a ID da sessão da saída do gatilho.

Retornos

response

object

Definir o estado do item da fila

ID da operação:

SetItemState

Altera o estado de um item de fila (por exemplo, de Pendente para Concluído ou para um estado personalizado). Use essa ação para avançar itens por meio do pipeline de fluxo de trabalho.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	string	A ID do item de fila a ser atualizado.
State	state		string	O novo estado do item de fila.

Definir o tempo limite da sessão

ID da operação:

SetTimeout

Atualiza o valor do tempo limite para uma sessão C TWO ativa. Use essa ação para estender ou reduzir o tempo de execução permitido para uma sessão em execução quando o tempo limite original precisar de ajuste.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da sessão	sessionId	True	string	A ID da sessão C TWO para a qual atualizar o tempo limite. O padrão é a ID da sessão da saída do gatilho.
Intervalo	timeout	True	integer	O novo valor de tempo limite em segundos a ser aplicado à sessão.

Retornos

response

string

Desbloquear item de fila

ID da operação:

UnlockItem

Desbloqueia um item de fila bloqueado anteriormente e o retorna ao estado disponível. Use essa ação quando o processamento for interrompido e o item deve ser liberado para outros trabalhadores.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	string	A ID do item de fila a ser desbloqueado.

Deve parar a sessão

ID da operação:

IsStopRequested

Verifica se c two solicitou uma parada normal (suave) para a sessão determinada. Use essa ação dentro de loops para verificar periodicamente se a sessão deve terminar antecipadamente, permitindo que o fluxo limpe os recursos antes de parar.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da sessão	sessionId	True	string	A ID da sessão C TWO para verificar se há uma solicitação de parada. O padrão é a ID da sessão da saída do gatilho.

Retornos

Nome	Caminho	Tipo	Description
isStopRequested	isStopRequested	boolean	isStopRequested

Formulário completo

ID da operação:

CompleteForm

Marca um formulário de interação de robô como concluído, sinalizando que o usuário humano forneceu a entrada solicitada e que o trabalho digital pode retomar o processamento.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID de formulário	formId	True	string	Humano na ID do formulário de loop para marcar como concluído.
completedAt	completedAt		date-time	O carimbo de data/hora quando o formulário foi concluído (formato ISO 8601).

Item de Fila de Bloqueio

ID da operação:

LockItem

Bloqueia um item de fila para impedir que outros trabalhadores o processem simultaneamente. Use essa ação antes de processar um item de trabalho para garantir o acesso exclusivo.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId		string	A ID do item de fila a ser bloqueado. Se omitido, o próximo item disponível correspondente ao filtro será bloqueado.
Nome da fila	reference		string	A referência de fila da qual bloquear um item.
ID do Estado	stateId		string	A ID de estado para filtrar itens.
Nome do Estado	stateName		string	O nome do estado pelo qual filtrar itens.
ID da sessão	sessionId		string	A ID da sessão para esse bloqueio.

Retornos

Nome	Caminho	Tipo	Description
id	id	integer	O identificador exclusivo do item bloqueado.
itemKey	itemKey	string	A chave exclusiva do item bloqueado.
Tentativas	attempts	integer	O número de tentativas de processamento.
queueId	queueId	integer	O identificador da fila pai.
id	state.id	integer	O identificador de estado.
nome	state.name	string	O nome do estado.
estado	state.state	string	O valor de estado.
tags	tags	array of string	As marcas associadas ao item de fila.
criado	created	string	O carimbo de tempo da criação.
createdByVendorSessionId	createdByVendorSessionId	integer	A ID da sessão que criou este item.
Concluiu	concluded	string	O carimbo de data/hora da conclusão.
diferido	deferred	string	O carimbo de data/hora adiado.
testar	test	boolean	Se este é um item de teste.
bloqueado	locked	boolean	Se o item está bloqueado.

Item de Fila de Repetição

ID da operação:

RetryItem

Tente novamente um item de fila específico, definindo seus dados de volta para seu valor original e criando uma nova Tentativa.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	integer	ID de item de fila específica para tentar novamente.
ID do Estado	stateId		integer	ID do estado do item de fila pendente específica a ser definida; tem prioridade sobre o parâmetro de estado.
State	state		string	Nome de estado do item de fila pendente específico a ser definido.
ID da tarefa de fluxo de trabalho	workflowTaskId		integer	Identificador workflowTask.
ID do Aplicativo	appId		integer	Identificador de aplicativo.

Obter anexo de item de fila

ID da operação:

GetItemAttachment

Recupera um anexo de arquivo específico de um item de fila como dados codificados em base64. Use essa ação para baixar arquivos que foram anexados a itens de trabalho durante a criação ou processamento.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	string	A ID do item de fila que contém o anexo.
ID do anexo	attachmentId	True	string	A ID do anexo a ser recuperado.
Nome do Arquivo	filename		string	O nome do arquivo do anexo.

Retornos

response

string

Obter filas

ID da operação:

GetQueues

Recupera filas universais com base em critérios de filtro. Use essa ação para listar filas disponíveis, verificar a configuração ou pesquisar detalhes da fila. Essa operação também alimenta listas suspensas dinâmicas em outras ações.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da Fila	id		string	Filtrar por ID da fila.
Referência de fila	reference		string	Filtrar por referência de fila.
Nome da fila	name		string	Filtrar pelo nome da fila.
Nome do Estado	stateName		string	Filtrar por nome de estado.
Excluída	deleted		boolean	Filtrar por status excluído.
Ignorar	skip		integer	Número de registros a serem pulados para paginação.
Take	take		integer	Número de registros a serem retornados.

Retornos

Nome	Caminho	Tipo	Description
		array of object
id	id	integer	O identificador exclusivo da fila.
excluído	deleted	boolean	Se a fila é excluída.
nome	name	string	O nome da fila.
description	description	string	A descrição da fila.
visible	visible	boolean	Se a fila está visível.
includeInReports	includeInReports	boolean	Se deve ser incluído em relatórios.
criado	created	string	O carimbo de tempo da criação.
atualizado	updated	string	O carimbo de data/hora da última atualização.
deletedTime	deletedTime	string	O carimbo de data/hora de exclusão.
divisionId	divisionId	integer	O identificador de divisão.
tipo	type	integer	O tipo de fila.
referência	reference	string	A referência da fila.
states	states	array of object	Os estados disponíveis nessa fila.
id	states.id	integer	O identificador de estado.
nome	states.name	string	O nome do estado.
description	states.description	string	A descrição do estado.
tagfilter	states.tagfilter	string	O filtro de marca para esse estado.
estado	states.state	integer	O tipo de estado.
timeSavedPerItem	states.timeSavedPerItem	integer	Tempo salvo por item.
includeInReports	states.includeInReports	boolean	Se deve ser incluído em relatórios.
responseTimeCalculationBasis	states.responseTimeCalculationBasis	integer	Base de cálculo de tempo de resposta.

Obter formulário por Id

ID da operação:

GetFormById

Recupera um formulário de interação de robô específico por seu identificador exclusivo. Use essa ação para buscar os detalhes, os campos e o status atual de um formulário humano no loop criado por um trabalho digital.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID de formulário	formId	True	string	Humano na ID do formulário de loop para obter detalhes.

Retornos

Nome	Caminho	Tipo	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
criado em	createdOn	string	criado em
prazo	deadline	string	prazo
concluído	completed	string	concluído
title	title	string	title
Introdução	intro	string	introdução
Campos	fields	string	Campos

Obter Formulários

ID da operação:

GetForms

Recupera uma lista de formulários de interação de robôs com filtragem opcional. Use essa ação para consultar solicitações humanas pendentes no loop, verificar seu status ou localizar formulários atribuídos a usuários específicos.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Ignorar	skip		integer	Número de registros a serem pulados para paginação.
Take	take		integer	Número de registros a serem retornados.
Prazo Anterior	deadlineBefore		date-time	Filtre formulários com um prazo antes desta data/hora (ISO 8601).
Prazo Após	deadlineAfter		date-time	Filtre formulários com um prazo após esta data/hora (ISO 8601).
Incluir Concluído	includeCompleted		boolean	Se os formulários concluídos devem ser incluídos nos resultados.
Declaração por ID do Usuário	claimedByUserId		integer	Filtrar formulários reivindicados por uma ID de usuário específica.
Criado pela ID da tarefa de fluxo de trabalho	createdByWorkflowTaskId		integer	Filtrar formulários criados por uma ID de tarefa de fluxo de trabalho específica.

Retornos

Nome	Caminho	Tipo	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
criado em	createdOn	string	criado em
prazo	deadline	string	prazo
concluído	completed	string	concluído
undeferred	undeferred	boolean	undeferred

Obter itens de fila

ID da operação:

GetItems

Recupera itens de fila com base em critérios de filtro especificados, como estado, marcas, datas e nomes de fila. Use essa ação para pesquisar e monitorar itens de trabalho em suas filas universais.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
Chave de Item	itemKey		string	Filtrar por chave de item.
Attempts	attempts		integer	Filtrar por número de tentativas.
Adiado antes	deferredBefore		date-time	Itens de filtro adiados antes desta data.
Adiado após	deferredAfter		date-time	Itens de filtro adiados após essa data.
Criado antes	createdBefore		date-time	Itens de filtro criados antes desta data.
Criado após	createdAfter		date-time	Itens de filtro criados após essa data.
Concluído antes	concludedBefore		date-time	Itens de filtro concluídos antes desta data.
Concluído após	concludedAfter		date-time	Itens de filtro concluídos após esta data.
Estado inserido antes	stateEnteredTimeBefore		date-time	Itens de filtro que entraram no estado antes desta vez.
Estado inserido após	stateEnteredTimeAfter		date-time	Itens de filtro que entraram no estado após essa hora.
States	states		string	Filtrar por estado do item de fila.
IDs de estado do item de fila	queueItemStateIds		integer	Filtrar por IDs de estado do item de fila.
Nomes de estado do item de fila	queueItemStateNames		string	Filtrar por nomes de estado do item de fila.
Tags	tags		string	Filtrar por marcas (separado por vírgula).
IDs de fila	queueIds		integer	Filtrar por IDs de fila.
Nomes de fila	queueNames	True	string	Filtrar por nomes de fila (obrigatório).
References	references		string	Filtrar por referências de fila.
Incluir dados de item	includeItemData		boolean	Se os dados do item devem ser incluídos em resposta.
Ignorar	skip		integer	Número de registros a serem pulados para paginação.
Take	take		integer	Número de registros a serem retornados.

Retornos

Nome	Caminho	Tipo	Description
		array of object
id	id	integer	O identificador exclusivo do item de fila.
itemKey	itemKey	string	A chave exclusiva do item de fila.
Tentativas	attempts	integer	O número de tentativas de processamento.
queueId	queueId	integer	O identificador da fila pai.
id	state.id	integer	O identificador de estado.
nome	state.name	string	O nome do estado.
estado	state.state	string	O valor de estado.
tags	tags	array of string	As marcas associadas ao item de fila.
criado	created	string	O carimbo de tempo da criação.
createdByVendorSessionId	createdByVendorSessionId	integer	A ID da sessão que criou este item.
Concluiu	concluded	string	O carimbo de data/hora da conclusão.
diferido	deferred	string	O carimbo de data/hora adiado.
testar	test	boolean	Se este é um item de teste.
bloqueado	locked	boolean	Se o item está bloqueado.

Remover marcas do item de fila

ID da operação:

RemoveItemTag

Remove uma ou mais marcas de um item de fila. Use essa ação para atualizar a categorização de itens de trabalho durante o processamento.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID do item da fila	queueItemId	True	string	A ID do item de fila do qual remover marcas.
Tags	tags		string	Lista separada por vírgulas de marcas a serem removidas.

Gatilhos

Iniciar o fluxo da solicitação de sessão com o tempo limite	Pesquisa novas sessões C TWO e dispara o fluxo com uma restrição de tempo limite. Use esse gatilho quando a automação precisar ser concluída em uma janela de tempo específica. Se a sessão exceder o tempo limite, c two lidará com ela de acordo com sua política de tempo limite.
Iniciar o fluxo da solicitação de sessão sem tempo limite	Pesquisa novas sessões C TWO e dispara o fluxo quando uma sessão é criada para a tarefa selecionada. Use esse gatilho quando a automação não exigir uma restrição de tempo limite. O fluxo recebe detalhes da sessão, incluindo valores de entrada passados de C TWO.

Iniciar o fluxo da solicitação de sessão com o tempo limite

ID da operação:

StartFlowWithTimeout

Pesquisa novas sessões C TWO e dispara o fluxo com uma restrição de tempo limite. Use esse gatilho quando a automação precisar ser concluída em uma janela de tempo específica. Se a sessão exceder o tempo limite, c two lidará com ela de acordo com sua política de tempo limite.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da tarefa	taskId	True	integer	Selecione a tarefa C TWO que disparará esse fluxo. Quando uma sessão é criada para essa tarefa, o fluxo começa com o tempo limite especificado imposto.
Tempo limite de segundos	timeout	True	integer	Tempo máximo em segundos que a sessão tem permissão para ser executada antes que C TWO a marque como tempo limite.

Retornos

Nome	Caminho	Tipo	Description
sessões	sessions	array of object	Conjunto de sessões disparadas por C TWO com tempo limite
sessionID	sessions.sessionId	integer	sessionID
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
nome do fluxo de trabalho	sessions.workflowName	string	nome do fluxo de trabalho
taskName	sessions.taskName	string	taskName
criado	sessions.created	string	criado
processInputValues	sessions.processInputValues	object	processInputValues

Iniciar o fluxo da solicitação de sessão sem tempo limite

ID da operação:

StartFlowWithoutTimeout

Pesquisa novas sessões C TWO e dispara o fluxo quando uma sessão é criada para a tarefa selecionada. Use esse gatilho quando a automação não exigir uma restrição de tempo limite. O fluxo recebe detalhes da sessão, incluindo valores de entrada passados de C TWO.

Parâmetros

Nome	Chave	Obrigatório	Tipo	Description
ID da tarefa	taskId	True	integer	Selecione a tarefa C TWO que disparará esse fluxo. Quando uma nova sessão é criada para essa tarefa em C TWO, o fluxo será iniciado automaticamente sem impor um tempo limite.

Retornos

Nome	Caminho	Tipo	Description
sessões	sessions	array of object	Conjunto de sessões disparadas por C TWO sem tempo limite
sessionID	sessions.sessionId	integer	sessionID
workflowTaskId	sessions.workflowTaskId	integer	workflowTaskId
nome do fluxo de trabalho	sessions.workflowName	string	nome do fluxo de trabalho
taskName	sessions.taskName	string	taskName
criado	sessions.created	string	criado
processInputValues	sessions.processInputValues	object	processInputValues

Definições

cadeia

Esse é o tipo de dados básico 'string'.

objeto

Esse é o tipo 'object'.