← Notas

O formulário preenchido de uma vez só é o caso difícil

A documentação do Dialogflow CX declara que, quando vários valores chegam num turno só, normalmente um único parâmetro é preenchido — o que explica por que o visitante bem-comportado é justamente o que quebra o fluxo.

Fluxos de coleta são desenhados para o usuário que responde uma pergunta de cada vez. O usuário que resolve tudo de uma vez — despeja nome, contato e necessidade numa mensagem só — é o caso que quebra.

A documentação de parâmetros do Dialogflow CX enuncia isso sem rodeio: "If the end-user provides multiple parameter values in a single conversation turn during form filling, usually only one form parameter is set". Não é bug de uma implementação; é o comportamento esperado do preenchimento de formulário quando vários valores chegam juntos.

O efeito na conversa é ruim de um jeito específico. O visitante fez mais do que foi pedido, e o sistema responde perguntando de novo o que ele acabou de informar. Do lado dele não há como interpretar isso senão como desatenção.

O tratamento existe e é conhecido: extrair todos os valores presentes na mensagem antes de decidir qual pergunta fazer, e checar quais campos já estão preenchidos antes de cada pergunta. A mesma documentação registra o mecanismo vizinho — "any form parameter with the same name as a session parameter is automatically set to the session parameter value" —, o que mostra que o dado já capturado não deve ser pedido outra vez.

O caso vale como teste de aceitação obrigatório: mandar tudo na primeira mensagem e verificar se o fluxo reconhece o que recebeu.