workflows

Como transformar mensagens e formulários em tarefas

Use um contrato de entrada para extrair ações, evitar tarefas duplicadas, minimizar dados e encaminhar solicitações incertas à confirmação humana.

Para transformar mensagens e respostas de formulários em tarefas, primeiro limite quais fontes são autorizadas, decida se existe uma solicitação acionável, extraia somente os campos mínimos, compare a candidata com o trabalho existente e só então crie, atualize ou encaminhe para confirmação humana. Campos ausentes permanecem desconhecidos. Uma mensagem não pode inventar a própria prioridade, autoridade, responsável ou prazo.

A saída útil é uma tarefa candidata, não uma decisão concluída. O fluxo pode organizar trabalho interno, mas não responde ao remetente, promete uma data, atribui trabalho com consequência a outra pessoa nem executa a solicitação.

Este guia entrega um Contrato de entrada mensagem→tarefa copiável, regras de classificação, controle de duplicidade em duas camadas, exemplo fictício e testes sem dados pessoais reais ou mensagens externas. É um modelo operacional educativo, não aconselhamento jurídico, certificado de conformidade ou garantia de captura correta de todas as solicitações.

Defina a fronteira antes de conectar uma caixa de entrada

Comece com uma fonte estreita: um formulário aprovado, uma caixa organizacional, um canal de chat autorizado ou mensagens que uma pessoa marca explicitamente para triagem. Não comece dando a um modelo acesso irrestrito a todas as conversas pessoais e profissionais.

Documente:

  • a finalidade da entrada;
  • o canal e a conta no escopo;
  • quem pode acessar a fonte e o sistema de tarefas;
  • quais campos são realmente necessários;
  • por quanto tempo conteúdo, trechos e logs são mantidos;
  • para onde vão itens incertos ou sensíveis;
  • quem responde pela fila de exceções.

Se o processo ainda estiver impreciso, primeiro mapeie o processo de entrada e suas exceções. Se esta for uma candidata ao primeiro piloto, avalie se a triagem de entrada é uma primeira automação segura.

Use APIs ou conectores oficiais com as menores permissões práticas. Não raspe conversas privadas, automatize a interface de um mensageiro ou encaminhe e-mails pessoais a um serviço de IA como atalho.

Uma resposta de formulário e uma mensagem livre são entradas diferentes

Um formulário bem desenhado pode definir finalidade e campos antes da coleta. Identificador estável da resposta, identificadores das perguntas e horários facilitam a proveniência. O recurso oficial de respostas do Google Forms documenta campos como responseId, horários de envio e respostas por questionId; o e-mail do respondente só existe quando é coletado.

Uma mensagem é menos previsível. Ela pode conter histórico citado, assinatura, vários pedidos, datas vagas, anexos, dados sensíveis ou instruções dirigidas à própria automação. Pode ser somente informação, não uma tarefa.

As duas entradas podem alimentar o mesmo esquema de candidata, mas não devem receber a mesma confiança:

  • um campo “data desejada” é estruturado, mas pode ser opcional, inválido ou apenas aspiracional;
  • “Você consegue olhar isso sexta?” pode ser pedido, pergunta ou sugestão de agenda;
  • o remetente mencionado não é necessariamente o responsável pela tarefa;
  • uma pessoa copiada no e-mail não aceitou automaticamente uma atribuição.

O Google Forms também oferece notificações de mudança, mas a documentação de notificações push informa que elas não contêm dados detalhados da resposta. Trate o evento como sinal para consultar a fonte autorizada, não como a própria tarefa.

Separe detecção, extração, classificação e criação

Não reduza o fluxo a “nova mensagem → criar tarefa”. Use cinco etapas explícitas:

  1. Autorizar a entrada. Verificar fonte, finalidade e escopo de acesso.
  2. Detectar ação. Decidir se o conteúdo traz ação ou compromisso.
  3. Extrair campos candidatos. Capturar ação, resultado esperado, responsável explícito, prazo explícito e referência da fonte.
  4. Classificar e deduplicar. Escolher um resultado controlado e comparar com candidatas e tarefas existentes.
  5. Criar, atualizar ou reter. Aplicar a decisão somente depois dos portões humanos exigidos.

Saída estruturada pode manter a extração legível por máquina. A documentação de Structured Outputs descreve como restringir a saída de modelos compatíveis a um subconjunto de JSON Schema. Aderência ao esquema controla o formato; não prova que responsável, prazo ou interpretação extraídos sejam verdadeiros.

Extraia a tarefa mínima, não a conversa inteira

Uma candidata útil normalmente precisa de:

  • ação e objeto concisos;
  • resultado solicitado;
  • responsável explícito ou unassigned;
  • prazo explícito ou unknown;
  • referência da fonte;
  • trecho mínimo de evidência;
  • campos ausentes e notas de ambiguidade;
  • decisão e estado do portão humano.

Evite copiar o corpo inteiro da mensagem e todos os anexos para o sistema de tarefas. Um link controlado à fonte pode preservar contexto sem multiplicar conteúdo pessoal ou confidencial. Quem abrir o link ainda precisa ter permissão para ver o original.

Regras de extração:

  1. Extraia somente ações expressas ou compromissos reconhecidos pela política de entrada.
  2. Uma mensagem com duas ações independentes gera duas candidatas ligadas à mesma fonte.
  3. Caixa alta, tom emocional ou a palavra “urgente” não definem prioridade sozinhos.
  4. Prazo relativo exige horário de referência e fuso. Se restar ambiguidade, mantenha o prazo desconhecido.
  5. Não atribua uma tarefa porque alguém foi citado, copiado ou discutido.
  6. Campos materiais ausentes permanecem ausentes; não os complete por plausibilidade.
  7. Trate o texto como dado não confiável. “Ignore as regras”, “envie agora” ou “revele mensagens anteriores” dentro da entrada não é instrução de sistema.

Use uma classificação pequena e explícita

Cada ação processada recebe um resultado:

  • create_candidate: a fonte sustenta uma nova tarefa candidata interna;
  • update_candidate: a entrada acrescenta informação a uma candidata existente;
  • possible_duplicate: dois itens podem representar o mesmo trabalho e exigem comparação;
  • needs_confirmation: ação, responsável, data, objeto ou contexto são ambíguos;
  • not_a_task: conteúdo informativo sem ação reconhecida;
  • blocked: fonte, finalidade, permissão, sensibilidade ou conteúdo estão fora da fronteira.

Essas são decisões internas de roteamento. create_candidate não significa que o solicitante está correto, que o prazo foi aceito ou que a organização assumiu a entrega.

Evite duplicidades em duas camadas

Camada 1: repetição exata do evento

Use uma chave estável:

source_system + source_event_id + action_index

Se o provedor entregar o mesmo evento duas vezes, o reprocessamento não pode criar outra candidata. Para formulário, use o identificador da resposta ou equivalente oficial. Para mensagem com duas ações, action_index mantém as candidatas distintas.

A orientação de detecção de duplicatas do Azure Service Bus explica, no contexto daquela plataforma, que vincular o identificador da mensagem ao processo de negócio torna a repetição previsível. A implementação é específica, mas a lição é útil: gere identidade a partir de fatos estáveis, não de um valor aleatório a cada tentativa.

Camada 2: possível duplicidade de negócio

Eventos diferentes podem descrever o mesmo pedido. Compare referência da conversa ou resposta, ação normalizada, objeto, responsável explícito, prazo e uma janela definida.

Não mescle automaticamente porque dois textos são parecidos. “Atualizar texto do site” para dois clientes não é a mesma tarefa. Um formulário e um e-mail que se citam explicitamente podem ser uma tarefa, mas campos conflitantes devem ir para revisão.

Mantenha os termos separados:

  • correlação liga eventos relacionados;
  • deduplicação decide se eventos ou candidatas repetem o mesmo trabalho;
  • idempotência torna seguro repetir o processamento.

Se a criação da tarefa sofrer timeout, não presuma falha e tente de novo cegamente. Reconcilie o destino primeiro. Veja como tratar eventos duplicados e processamento incerto com segurança.

Use confirmação para ambiguidade e aprovação para consequência

Encaminhe para confirmação quando:

  • não estiver claro se existe tarefa;
  • uma mensagem permitir várias interpretações;
  • responsável, prazo, objeto ou resultado estiverem ambíguos;
  • o campo se basear apenas em inferência do modelo;
  • duas candidatas parecerem duplicadas;
  • mensagem e formulário ou tarefa atual entrarem em conflito.

Exija uma fronteira de aprovação mais forte antes de atribuição com consequência, acesso a dado sensível, compromisso externo ou qualquer ação além da criação de rascunho interno. O NIST AI RMF Core orienta documentar escopo, papéis e supervisão humano-IA conforme contexto e risco.

Para o desenho executável, use aprovação humana antes de ações com consequência. Se ninguém revisar, o item permanece bloqueado. Este fluxo não pergunta automaticamente ao remetente.

Trate e-mails recorrentes como uma série, não como tarefas independentes

Faturas mensais, relatórios semanais e pedidos periódicos podem repetir assunto e remetente sem representar o mesmo trabalho. O fluxo precisa distinguir três situações:

Sinal observado Decisão inicial Motivo
mesmo identificador do evento recebido outra vez não criar outra candidata repetição técnica do mesmo evento
nova mensagem da mesma série e novo período de referência criar candidata ligada à série é uma nova ocorrência do trabalho recorrente
lembrete sobre uma ocorrência ainda aberta atualizar ou encaminhar como possível duplicidade pode acrescentar contexto sem criar outro trabalho
assunto parecido, mas período ou objeto ausente pedir confirmação sem evidência suficiente para separar ocorrência, lembrete e duplicata
mensagem informa que a rotina terminou ou foi cancelada interromper próximas candidatas e encaminhar para revisão recorrência não deve sobreviver ao estado da fonte

Não deduza recorrência apenas de palavras como “mensal” ou de uma linha de assunto repetida. Registre uma identidade de série separada da identidade de cada ocorrência:

recurrence:
  series_key: approved-source + normalized-process + business-object
  occurrence_key: series_key + reference-period
  reference_period: explicit-period-or-unknown
  expected_cadence: documented-rule-or-unknown
  current_state: expected | received | candidate_created | reconciled | stopped
  stop_reason: explicit-cancellation-or-none

expected_cadence é uma regra documentada pela empresa, não uma previsão criada pela IA. Se o período estiver ausente, conflitante ou inferido apenas pelo texto livre, mantenha reference_period: unknown e encaminhe para confirmação. O sistema também deve consultar ocorrências abertas antes de criar outra candidata.

Matriz ocorrência × estado

Use a matriz abaixo como teste de decisão antes de automatizar uma caixa real:

Ocorrência esperada Mensagem recebida Trabalho aberto Saída segura
sim sim, período explícito não criar candidata daquela ocorrência
sim sim, período explícito sim, mesmo período atualizar ou marcar possível duplicidade
sim não não sinalizar ausência; não inventar tarefa concluída nem mensagem recebida
não sim não processar como entrada comum; não criar uma série silenciosamente
parada sim qualquer bloquear e revisar a origem antes de reativar

Uma automação de agenda pode iniciar uma checagem, mas não deve fabricar o evento de negócio. A documentação do Google Tasks descreve tarefas recorrentes criadas pelo usuário, enquanto o Microsoft Support descreve sinalização de mensagens para acompanhamento. Esses recursos ajudam uma pessoa a organizar trabalho; não provam que um e-mail recebido seja acionável, que a periodicidade esteja correta ou que uma nova ocorrência deva ser criada automaticamente.

Para um piloto, escolha uma única série com período explícito, sem anexo sensível e com dono humano da reconciliação. Meça candidatas criadas, duplicatas evitadas, ocorrências ausentes, itens enviados à confirmação e tempo de resolução da fila. Pare o piloto se uma ocorrência for perdida, criada em duplicidade ou mantida ativa depois de cancelada.

Contrato de entrada mensagem→tarefa copiável

Copie o contrato para a documentação operacional e adapte primeiro com dados fictícios.

source:
  channel: form | email | approved_chat
  source_system: approved-system-name
  source_event_id: stable-provider-event-id
  thread_or_response_id: stable-thread-or-response-id
  received_at: RFC3339 timestamp
  purpose: declared-intake-purpose
  permission_scope: documented-reference
  source_link: internal-reference-with-access-control
  content_retention: defined-policy-reference

candidate_task:
  candidate_id: generated-stable-id
  title: concise-action-with-object
  requested_outcome: explicit-result-or-unknown
  owner: explicit-person-or-unassigned
  due_at: explicit-date-or-unknown
  priority: rule-based-value-or-unset
  source_reference: source-event-id
  evidence_excerpt: minimum-necessary-text
  data_classification: public | internal | confidential | sensitive-review
  confidence_by_field:
    action: high | medium | low
    owner: high | medium | low | unknown
    due_at: high | medium | low | unknown
  missing_fields: []
  ambiguity_notes: []
  decision: create_candidate | update_candidate | possible_duplicate | needs_confirmation | not_a_task | blocked
  human_gate: none | confirm | approve

Registre o roteamento em um ledger minimizado:

event_id candidate_id decisão chave de duplicidade tarefa relacionada campos incertos revisor horário resultado

Não coloque corpo completo, anexos, segredos ou dados pessoais desnecessários no ledger. Contrato e taxonomia são modelos editoriais da Pulse, não padrões do Google, Microsoft, OpenAI, NIST ou autoridade de proteção de dados.

Exemplo fictício: formulário e e-mail descrevem um pedido

form_response:
  response_id: FORM-EXAMPLE-1042
  submitted_at: 2026-09-28T13:10:00Z
  request_type: update website copy
  requested_outcome: replace outdated service description
  desired_date: 2026-10-03
  requester: Example Studio contact

email_message:
  event_id: MAIL-EXAMPLE-7781
  thread_id: THREAD-EXAMPLE-92
  received_at: 2026-09-28T13:14:00Z
  excerpt: I also sent the website update form. Please use the new service description by October 3.

Resultado esperado:

candidate_task:
  candidate_id: TASK-CANDIDATE-1042-1
  title: Replace outdated service description on website
  requested_outcome: Website displays the approved new service description
  owner: unassigned
  due_at: 2026-10-03
  source_references:
    - FORM-EXAMPLE-1042
    - MAIL-EXAMPLE-7781
  decision: update_candidate
  duplicate_reason: same requester, object, outcome and explicit cross-reference
  human_gate: confirm
  missing_fields:
    - approved_copy_source
    - owner

O e-mail não cria segunda tarefa porque cita o formulário e corresponde ao objeto e resultado. Ainda é preciso confirmar: faltam a fonte do texto aprovado e o responsável. Nada autoriza publicação, atribuição ou resposta.

Minimize dados e torne a finalidade visível

Antes de ler envios ou mensagens reais, identifique autoridade organizacional ou base aplicável, finalidade, retenção, operadores, acesso e salvaguardas. Consentimento pode ser relevante em alguns contextos, mas não é a única base possível nem uma resposta universal.

A página da ANPD sobre direitos dos titulares destaca informações sobre finalidade, duração, compartilhamento e responsáveis, além da revisão de decisões unicamente automatizadas que afetem interesses. Em contextos do GDPR, os princípios oficiais da Comissão Europeia incluem limitação de finalidade, minimização, exatidão, limitação de armazenamento e segurança. Essas fontes não produzem uma conclusão jurídica única para todo fluxo.

Antes de usar modelo ou integração de terceiro, verifique:

  • se dados reais são necessários;
  • se campos podem ser removidos, redigidos ou substituídos;
  • retenção e exclusão;
  • uso para treinamento pelo fornecedor;
  • região de processamento e armazenamento quando relevante;
  • suboperadores e pessoas com acesso;
  • contrato ou DPA aplicável;
  • caminho para direitos, correção e incidente.

Mantenha o primeiro piloto fictício ou efetivamente redigido. Não processe automaticamente anexos essenciais na primeira versão.

Teste antes de conectar uma fonte real

Use fixtures fictícias e verifique ao menos:

  1. formulário claro com uma ação cria uma candidata;
  2. mensagem informativa vira not_a_task;
  3. mensagem ambígua vira needs_confirmation;
  4. duas ações viram duas candidatas ligadas;
  5. mesmo evento entregue duas vezes cria uma candidata;
  6. formulário e e-mail com referência cruzada ficam como uma possível tarefa;
  7. texto parecido para clientes diferentes não é mesclado;
  8. “sexta” sem contexto/fuso suficiente fica desconhecida;
  9. pessoa copiada ou mencionada não é atribuída;
  10. “urgente” não muda prioridade silenciosamente;
  11. edição do formulário preserva histórico e é reavaliada;
  12. formulário sem coleta de e-mail funciona;
  13. conteúdo sensível é bloqueado e minimamente registrado;
  14. prompt injection é tratada como entrada, não instrução;
  15. anexo essencial não processado bloqueia criação;
  16. falha ao consultar tarefas existentes fecha o fluxo;
  17. timeout depois da criação leva à reconciliação, não retry cego;
  18. rejeição da possível duplicidade mantém candidatas separadas;
  19. confirmação da duplicidade preserva as duas fontes;
  20. incerteza do classificador entra na fila humana;
  21. falta de finalidade ou permissão bloqueia;
  22. fixtures EN/PT produzem o mesmo resultado material;
  23. nenhuma etapa envia, responde, atribui definitivamente ou executa trabalho externo;
  24. o ledger não contém conversa completa, segredo ou dado desnecessário.
  25. o mesmo evento recorrente reentregue não cria outra ocorrência;
  26. um novo período explícito cria uma ocorrência ligada à mesma série;
  27. um lembrete do mesmo período não cria trabalho duplicado;
  28. período ausente ou conflitante vai para confirmação;
  29. cancelamento interrompe novas candidatas da série;
  30. ausência de mensagem não é registrada como mensagem recebida nem tarefa concluída.

Sucesso significa que evento exato não cria duas tarefas, mescla semântica não ocorre sem evidência ou revisão, nenhum campo material é inventado, incerteza fica visível e nenhuma mensagem real é enviada.

Quando não automatizar esta entrada

Mantenha manual ou procure revisão especializada quando:

  • fonte, finalidade ou acesso não forem autorizados;
  • conversas pessoais e profissionais estiverem misturadas;
  • não houver fonte de verdade das tarefas existentes;
  • pedidos envolverem dinheiro, contrato, acesso, exclusão ou decisão sobre pessoa;
  • houver dados sensíveis ou regulados;
  • anexos essenciais não puderem ser processados com segurança;
  • ninguém puder revisar possíveis duplicidades ou exceções;
  • a fila humana não comportar o volume esperado;
  • criar a tarefa disparar resposta, cobrança, acesso ou outro efeito externo;
  • falhas puderem perder solicitações silenciosamente sem reconciliação.

Se tarefas aprovadas alimentarem um processo comercial, mantenha-o separado e controlado. Veja o fluxo de propostas e follow-up para controles de versão, permissão, parada e envio externo.

Antes de criar registros de clientes a partir dessas entradas, use o pacote de decisão Planilha ou CRM para definir sistema canônico, registro mínimo e controles de migração.

Quando a entrada aprovada representar um horário marcado, e não uma tarefa, continue pelo modelo de estados para agendamentos e lembretes para controlar confirmação, reagendamento, cancelamento, horário local e mensagens obsoletas.

Fontes e limites editoriais

A documentação oficial citada sustenta capacidades específicas: identificadores de resposta, notificações, esquemas estruturados, APIs de tarefas e detecção de duplicidade de plataforma. A Microsoft documenta uma ação do conector do Planner que cria uma tarefa e um endpoint do Microsoft Graph To Do para criar uma tarefa em uma lista. Essas capacidades de produto não validam o contrato Pulse, não provam a qualidade do fluxo de entrada nem garantem extração correta.

Resultados comerciais como as páginas da Zapier sobre e-mail→tarefa e formulário→tarefa, além do guia de e-mail→tarefa da Text2Task, mostram como fornecedores descrevem essas ofertas. Eles são usados somente para mapear o cenário comercial; não comprovam eficácia, exatidão, segurança ou adequação. Classificação, esquema, deduplicação em duas camadas e portões de revisão são modelos editoriais que exigem validação independente técnica, de privacidade, risco e conteúdo antes do uso real.

Esta atualização de 18 de outubro de 2026 acrescentou o tratamento de séries recorrentes, identidade por ocorrência, matriz de estados e seis testes específicos. Ela recebeu validação independente antes da publicação. Uso de conectores, coleta de dados reais, acesso a mensagens e ações externas continuam sendo gates separados.