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:
- Autorizar a entrada. Verificar fonte, finalidade e escopo de acesso.
- Detectar ação. Decidir se o conteúdo traz ação ou compromisso.
- Extrair campos candidatos. Capturar ação, resultado esperado, responsável explícito, prazo explícito e referência da fonte.
- Classificar e deduplicar. Escolher um resultado controlado e comparar com candidatas e tarefas existentes.
- 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:
- Extraia somente ações expressas ou compromissos reconhecidos pela política de entrada.
- Uma mensagem com duas ações independentes gera duas candidatas ligadas à mesma fonte.
- Caixa alta, tom emocional ou a palavra “urgente” não definem prioridade sozinhos.
- Prazo relativo exige horário de referência e fuso. Se restar ambiguidade, mantenha o prazo desconhecido.
- Não atribua uma tarefa porque alguém foi citado, copiado ou discutido.
- Campos materiais ausentes permanecem ausentes; não os complete por plausibilidade.
- 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:
- formulário claro com uma ação cria uma candidata;
- mensagem informativa vira
not_a_task; - mensagem ambígua vira
needs_confirmation; - duas ações viram duas candidatas ligadas;
- mesmo evento entregue duas vezes cria uma candidata;
- formulário e e-mail com referência cruzada ficam como uma possível tarefa;
- texto parecido para clientes diferentes não é mesclado;
- “sexta” sem contexto/fuso suficiente fica desconhecida;
- pessoa copiada ou mencionada não é atribuída;
- “urgente” não muda prioridade silenciosamente;
- edição do formulário preserva histórico e é reavaliada;
- formulário sem coleta de e-mail funciona;
- conteúdo sensível é bloqueado e minimamente registrado;
- prompt injection é tratada como entrada, não instrução;
- anexo essencial não processado bloqueia criação;
- falha ao consultar tarefas existentes fecha o fluxo;
- timeout depois da criação leva à reconciliação, não retry cego;
- rejeição da possível duplicidade mantém candidatas separadas;
- confirmação da duplicidade preserva as duas fontes;
- incerteza do classificador entra na fila humana;
- falta de finalidade ou permissão bloqueia;
- fixtures EN/PT produzem o mesmo resultado material;
- nenhuma etapa envia, responde, atribui definitivamente ou executa trabalho externo;
- o ledger não contém conversa completa, segredo ou dado desnecessário.
- o mesmo evento recorrente reentregue não cria outra ocorrência;
- um novo período explícito cria uma ocorrência ligada à mesma série;
- um lembrete do mesmo período não cria trabalho duplicado;
- período ausente ou conflitante vai para confirmação;
- cancelamento interrompe novas candidatas da série;
- 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.