Função Iniciar

A função Iniciar representa o ponto de entrada de todo workflow. Ela é carregada nativamente no canvas sempre que um novo fluxo é criado e define o que faz o fluxo rodar.

Suas propriedades variam conforme o tipo de fluxo. Em um Fluxo de Atendimento Humano, ela determina qual tipo de caso aciona o processo. Em uma Automação Inteligente, define o gatilho que dispara a execução. Em um fluxo de Atendimento Digital, define se o bot responde a um canal ou é acionado manualmente. E em um fluxo de Voz, concentra as regras globais de contingência e espera da URA.

Disponível em: todos os tipos de fluxo.

Como cada tipo de fluxo é acionado

Fluxo de Atendimento Humano

Nos fluxos de atendimento humano, a função Iniciar vincula o processo a um tipo de caso. Sempre que um caso daquele tipo é criado na Unidade de Negócio configurada, o fluxo é executado.

Automações Inteligentes

Automações não são acionadas pela chegada de um caso: elas precisam de um gatilho explícito. Esse gatilho é escolhido no momento da criação do fluxo, no painel Criar Automação, entre três opções: Com Evento, Agendamento e Hook.

Na listagem de Automações Inteligentes, as colunas Tipo e Gatilho mostram, respectivamente, qual modelo foi escolhido e qual a configuração aplicada.

Propriedades comuns a todos os gatilhos

Início Com Evento

A automação é executada sempre que um evento específico ocorre na plataforma. É o modelo indicado para reagir a mudanças no ciclo de vida dos casos e dos usuários, como o abandono de um atendimento ou a atualização de um cadastro.

No painel de propriedades, a seção Gatilho exibe o Tipo como With Event e o campo Evento com o evento selecionado. O nó no canvas passa a exibir Inicia com seguido do nome do evento, por exemplo AbandonedCaseEvent.

Início por Agendamento

A automação é executada em uma programação de horários, definida por uma expressão cron. É o modelo indicado para rotinas recorrentes, como higienização de base, disparo de campanhas e fechamento de casos ociosos.

No painel de propriedades, a seção Gatilho exibe o Tipo como Scheduler e o campo Expressão cron com a programação configurada. O nó no canvas exibe Inicia com Agendamento.

Exemplo de leitura de expressão cron

A expressão 0 0 18 1/1 * ? executa a automação todos os dias às 18h00. Os campos seguem a ordem: segundos, minutos, horas, dia do mês, mês e dia da semana.

Início por Hook

A automação é executada quando um sistema externo realiza uma chamada HTTP para um endereço gerado pela plataforma. É o modelo indicado para integrações orientadas a evento, em que o fluxo precisa rodar no instante exato em que algo acontece em outro sistema, como um CRM que registra uma nova oportunidade ou um ERP que atualiza o status de um pedido.

No painel de propriedades, a seção Hook exibe a URL de acionamento gerada pela plataforma, com um botão para copiar o endereço. O nó no canvas exibe Inicia com Hook.

Autenticação

A chamada exige autenticação. É necessário possuir um usuário de integração no cVortex, gerar um token JWT válido e enviá-lo no cabeçalho de autorização da requisição. Chamadas sem token válido não executam o fluxo.

Campos

Abaixo da URL, a seção de campos define quais dados a automação recebe na chamada e como eles ficam disponíveis no contexto do fluxo. Os campos são personalizados por fluxo: você declara cada um com seu nome e tipo, conforme a necessidade da integração.

• Tipos suportados: texto, número inteiro, booleano e lista simples de objetos.

• Limite: até 100 campos por fluxo.

• Arquivos não são suportados. Quando a jornada precisa de um arquivo, ele deve ser buscado por meio da função Integração durante a execução do fluxo.

Como a execução acontece

A execução de uma automação por Hook é assíncrona. Isso é determinante para o desenho da integração do lado do sistema chamador.

1. O sistema externo realiza a chamada para a URL de acionamento, com o token JWT e os campos configurados.

2. O cVortex responde imediatamente com um identificador de execução (webhookId). A resposta confirma o recebimento, não a conclusão do fluxo.

3. A execução entra na fila de automações do tenant e é processada pela mesma engine que executa as automações por evento e por agendamento.

4. O status da execução pode ser consultado a qualquer momento por meio da API de consulta, utilizando o identificador recebido. Os estados possíveis acompanham o ciclo da fila: aguardando, em execução e concluída.

Limites e proteções

Chamadas dentro do limite, mas acima da capacidade de processamento do tenant, não são recusadas: elas aguardam na fila de execução, como ocorre com as demais automações.

Atendimento Digital (Chatbot e IA)

Nos fluxos de chatbot, a função Iniciar define como a conversa chega até o bot. A escolha é feita no momento da criação do fluxo, no painel Criar fluxo de bot, entre Com Canal e Manual.

Com Canal. O fluxo é acionado automaticamente quando uma mensagem chega em um dos canais vinculados. É o modelo usado para bots de atendimento que ficam na linha de frente.

Manual. O fluxo não responde diretamente a um canal e é acionado a partir de outro fluxo. É o modelo usado para bots auxiliares e blocos de conversa reaproveitados em diferentes jornadas.

Mensagem de contingência

A mensagem de contingência é o recurso de último caso do bot. Ela é enviada quando o cliente envia algo que o fluxo não sabe tratar, evitando que a conversa fique sem resposta. O texto padrão da plataforma é Desculpe, não entendi o que você deseja, e pode ser personalizado conforme o tom de voz da operação.

Atendimento por Voz

Nos fluxos de voz, a função Iniciar concentra as regras globais do atendimento telefônico, incluindo aceitação de chamadas transferidas, gravação, contingência e mensagens de espera.

A documentação completa dessas propriedades está na página Iniciar de Voz.

Regras e Restrições

• Nó único. Não é possível adicionar uma segunda função Iniciar nem deletar a existente.

• Gatilho definido na criação. Em Automações Inteligentes e em Atendimento Digital, o modelo de acionamento é escolhido no momento da criação do fluxo.

• Campos herdados. Nome do Workflow, Tipo e BU aparecem em todos os tipos de fluxo. O Tipo é sempre somente leitura, pois reflete a categoria escolhida na criação.

Observação Após realizar qualquer alteração nas propriedades de uma função, deve-se clicar no botão salvar alterações. Esse botão estará disponível na parte inferior do painel de propriedades, sempre que houver alguma alteração da função.

Veja também

• Funções Gerais

• Iniciar de Voz

• Integração

• Tempo de Execução dos Fluxos de Automação

• Proteções e limites do Workflow Studio