Docs / Fluxos de Trabalho do Agente

Fluxos de Trabalho do Agente

Um fluxo de trabalho transforma um agente num formulário de recolha estruturado. Em vez de uma conversa livre, o agente guia o utilizador passo a passo por um conjunto de perguntas — recolhendo um nome, uma data, o carregamento de um ficheiro, ou quaisquer outros dados — e depois submete os dados preenchidos para o seu backend.

Usos típicos: pedidos de passaporte, pedidos de serviço, candidaturas a emprego, tickets de suporte, formulários de registo.

Como funciona

Quando um fluxo de trabalho está associado a um agente, o agente segue um guião: faz uma pergunta de cada vez, valida a resposta e depois passa para o passo seguinte. Quando todos os campos obrigatórios estão preenchidos, o agente chama uma função interna submit_application que cria um registo de Submissão e desencadeia a entrega para o seu webhook ou email.

Criando uma Coleção

  1. Abra a página de detalhes do agente de um agente Ativo
  2. Na lista de Conectores, encontre aqoon e clique em Conectar
  3. Digite um nome e uma descrição opcional
  4. Adicione passos (ver abaixo)
  5. Configure a entrega (webhook, email ou ambos)
  6. Mensagem de boas-vindas
  7. Clique em Criar Chave
  8. Volte à página de detalhes do agente e clique em Republicar para ativar o fluxo de trabalho
O nome da chave é obrigatório.

Adicionar ou editar um fluxo de trabalho marca o agente como tendo alterações por publicar. Tem de republicar o agente para que o fluxo de trabalho fique ativo nas conversas.

Passos do Fluxo de Trabalho

Cada passo corresponde a um campo de dados que o agente recolhe do utilizador.

Campo Criar uma coleção
Arquivo de Texto Resposta de texto curto (nome, número de identificação, cidade, etc.)
Texto Simples Texto livre de várias linhas (descrições, motivos, comentários)
Data Uma data de calendário (data de nascimento, data de marcação, etc.)
Número Um valor numérico (idade, quantidade, montante)
Markdown Uma lista fixa de opções. Defina as opções como value|Label, uma por linha (por exemplo fr|Francês).
Sim/Não Uma escolha booleana (tem um passaporte válido? etc.)
Enviar O carregamento de um documento. Especifique os tipos de ficheiro aceites (por exemplo .pdf,.jpg). O ficheiro é armazenado e o seu ID é incluído na submissão.

Cada passo tem uma chave (um identificador único utilizado nos dados submetidos, por exemplo full_name), uma pergunta (o que o agente pergunta ao utilizador), e um alternador Obrigatório. Os passos opcionais podem ser ignorados pelo utilizador.

Entrega

Quando um utilizador conclui todos os passos obrigatórios, o agente submete os dados utilizando o método de entrega que configurou:

Método Descrição
Webhooks o aqoon envia um pedido POST em JSON para o seu URL com os dados completos da submissão. Adequado para integrar com o seu próprio backend ou uma ferramenta como o Zapier ou o Make.
Notificação por E-mail o aqoon envia um email para os endereços que especificar (um por linha). Adequado para uma recolha simples em que não é necessária integração com backend.
Webhooks Ambas as opções acima.

Webhooks

O corpo do POST do webhook é um objeto JSON com a seguinte estrutura: 

{
  "reference_number": "REF-20240115-0042",
  "submitted_at": "2024-01-15T10:30:00Z",
  "applicant_name": "Aminata Diallo",
  "applicant_email": "aminata@example.com",
  "collected_data": {
    "full_name": "Aminata Diallo",
    "date_of_birth": "1990-05-20",
    "document_type": "passport"
  }
}

Mensagem de Chat

A mensagem de confirmação é o que o agente comunica ao utilizador após uma submissão bem-sucedida. Utilize o marcador de posição {reference_number} para incluir a referência da submissão: 

Obrigado! A sua candidatura foi submetida. O seu número de referência é {reference_number}. Entraremos em contacto consigo no prazo de 5 dias úteis.

Gerenciar Assinatura

Os envios concluídos de cada agente são listados na página de detalhes dele em Envios (abra o agente → Envios). Você pode filtrar por workflow ou status.

Status Significado
Enviar Acabada de receber, entrega pendente
Processando Entrega em curso
Aprovar Marcada manualmente como aprovada
Rejeitado Marcada manualmente como rejeitada

Abra uma submissão para ver todos os dados recolhidos, atualizar o seu estado e adicionar notas internas. O requerente não é notificado das alterações de estado — isso é tratado pelo seu próprio processo.

Editando uma Coleção

Na página de detalhes do agente, clique em Editar junto ao nome do fluxo de trabalho. Depois de guardar as suas alterações, volte à página de detalhes do agente e clique em Republicar para implementar o fluxo de trabalho atualizado.

Excluindo uma Coleção

Clique em Excluir na página de detalhes da coleção. Isso remove a coleção e todos os seus documentos. Esta ação não pode ser desfeita.