flow_token
O flow_token é um identificador que você gera e envia junto com um WhatsApp Flow. Quando o usuário conclui o formulário, a Meta devolve esse mesmo token dentro do webhook nfm_reply. É ele que permite casar a resposta com a conversa e o passo da automação que a originou.
Atualizado em
Também chamado de: flow token, token do formulário.
Como funciona
Ao enviar uma mensagem interativa do tipo flow, você inclui um flow_token de sua escolha no payload.
O WhatsApp trata o token como opaco: não interpreta o conteúdo, apenas devolve. Quando o usuário envia o formulário, chega um webhook com type: nfm_reply contendo as respostas e o token original.
Sem o token, você recebe um formulário preenchido sem saber a qual disparo ele pertence — especialmente problemático quando o mesmo contato responde dois formulários diferentes.
Por isso o token precisa ser único por envio, e não por contato ou por formulário. Reaproveitar o mesmo valor faz respostas caírem na sessão errada.
Na prática
O token é o que torna possível pausar uma automação, esperar a resposta do formulário e retomar exatamente de onde parou.
Como o valor trafega até o dispositivo do usuário, ele não deve conter dado sensível — o correto é ser uma chave opaca que aponta para a sessão do seu lado.
Perguntas frequentes
- O flow_token pode se repetir entre envios?
- Não deve. Como o token é o que liga a resposta recebida ao disparo que a originou, reaproveitar o mesmo valor faz o sistema associar a resposta à sessão errada quando há mais de um formulário em aberto para o mesmo contato.