[Extensão] Como usar a extensão WhatsApp Flows no Blip

1. Introdução

2. Funcionalidades

3. Instalação e configuração

4. Criar um flow

5. Validar o JSON

6. Configurar o endpoint de dados

7. Pré-visualizar e testar o flow

8. Publicar o flow

9. Enviar o flow ao cliente pelo Builder

10. Boas práticas

11. Suporte

Descrição breve: Crie, valide e publique formulários e telas interativas dentro do WhatsApp direto do Blip, sem redirecionar o cliente para páginas externas.

Introdução

A extensão WhatsApp Flows permite criar, editar, testar e publicar telas interativas que abrem dentro da conversa no WhatsApp. O cliente preenche formulários, escolhe opções em menus e conclui a jornada sem sair do chat e sem ser levado a uma página externa.

Por exemplo, você monta um formulário de agendamento que abre no WhatsApp: o cliente seleciona data e horário, confirma, e os dados voltam para o fluxo do bot no Builder. Todo o ciclo, da edição do JSON do flow à validação, pré-visualização, teste e publicação, acontece no portal da extensão.

Funcionalidades

• Criação de flows do zero e edição do JSON no editor integrado

• Validação de schema enquanto você edita, com um painel que lista os erros encontrados

• Pré-visualização do flow antes da publicação

• Teste do flow direto no WhatsApp, enviando uma mensagem para um número

• Configuração do endpoint de dados do flow, para troca dinâmica de dados com o seu servidor

• Chaves de criptografia (pública, privada e senha) geradas automaticamente para proteger a troca de dados com o WhatsApp

• Controle de status do flow (Draft, Published e Deprecated), com publicação, depreciação e exclusão

Suportada no canal WhatsApp.

Instalação e configuração

A extensão depende do número de WhatsApp conectado ao bot, porque o envio dos flows passa pela API da Meta. Instale-a no Roteador que tem o canal WhatsApp ativo e use apenas um bot por número.

Atenção: se o bot não tiver o canal WhatsApp ativo, a extensão exibe o aviso "Publique seu bot no WhatsApp para utilizar essa extensão" e não carrega a lista de flows.

1. Acesse a WhatsApp Flows na Blip Store ou pesquise por WhatsApp Flows na Blip Store.

2. Selecione a extensão e clique em Iniciar teste grátis.

3. Escolha o Roteador que tem o canal WhatsApp ativo e conclua a instalação.

4. Abra a extensão pelo menu do bot. A extensão mostra a lista de flows do bot.

5. Opcional: clique em Visualizar chaves para ver a chave pública, a chave privada e a senha. A extensão gera esse par de chaves na instalação e registra a chave pública no WhatsApp automaticamente. Você precisa delas quando o flow troca dados com um endpoint externo.

Criar um flow

1. Clique em Criar novo fluxo e depois em Criar do zero. A extensão cria um flow com status Draft e abre o editor.

2. Renomeie o flow no campo de nome no topo do editor.

3. Escreva ou cole o JSON do flow no editor. As alterações são salvas automaticamente. Enquanto o flow está em Draft, você pode editá-lo à vontade.

Para modelos de telas prontos, como formulários, avaliações de NPS e login, consulte a documentação de exemplos da Meta.

Validar o JSON

A extensão valida o schema do flow enquanto você edita. O painel ao lado do editor lista os erros encontrados ou confirma "Nenhum erro de schema encontrado", junto com o ID e o status do flow. Corrija todos os erros antes de publicar.

Configurar o endpoint de dados

Se o flow troca dados dinâmicos com o seu servidor, clique em Trocar endpoint no menu de opções do editor e informe a URL do endpoint. A extensão usa as chaves geradas na instalação para proteger essa troca de dados com o WhatsApp. Veja a referência do JSON do flow da Meta para os campos aceitos.

Pré-visualizar e testar o flow

Clique em Pré-visualizar para abrir o flow e conferir telas, textos, campos e navegação antes de publicar.

Para testar direto no WhatsApp, abra o menu de opções do editor e clique em Testar fluxo no WhatsApp. Informe o número de telefone, o texto do cabeçalho, do corpo e do botão, e envie a mensagem de teste. A janela de conversa com esse número precisa estar aberta para receber. Enquanto o flow está em Draft, o WhatsApp identifica a mensagem como um ambiente de simulação, e a personalização das mensagens só vale depois da publicação.

Publicar o flow

1. Abra o menu de opções do editor e clique em Publicar fluxo.

2. Aguarde o status mudar para Published.

Atenção: depois de publicado, o flow não pode ser editado nem excluído. Para mudar um flow publicado, crie um novo com o JSON atualizado. Um flow publicado só pode ser marcado como Deprecated pela opção Deprecar fluxo; um flow em Draft pode ser removido pela opção Deletar fluxo.

Enviar o flow ao cliente pelo Builder

Depois de publicar, envie o flow ao cliente a partir de um bloco no Builder do mesmo bot.

1. Copie o ID do flow na lista da extensão ou no editor.

2. No Builder, clique em +, crie um novo bloco e dê um nome claro, como "Enviar WhatsApp Flow".

3. Abra o bloco e adicione um conteúdo do tipo WhatsApp Flow.

4. Edite o conteúdo dinâmico. No corpo, escreva a mensagem que acompanha o flow. Use texto fixo sem chaves ou uma variável entre chaves, como {{variavel}}.

5. No campo FlowID, cole o ID do flow, sem chaves.

6. No campo Flow CTA, informe o título do botão que o cliente vê para abrir o flow.

7. No campo Mode, informe published para flows publicados ou draft para testes, sem chaves.

8. Salve os campos.

9. Nas Ações do bloco, configure as requisições que preparam o contexto do flow (Reset context e Create Flow context), usando a chave (Key) do bot. Essas requisições garantem que o flow abra com o contexto correto e guardam as variáveis do flow para uso posterior.

10. Habilite o contexto do Roteador e publique o bot no Builder.

Para validar a jornada completa, envie uma mensagem ao número de WhatsApp do bot que aciona o bloco, abra o flow, preencha os campos e confirme se o retorno chega ao Builder com as variáveis preenchidas.

Boas práticas

• Teste o flow em um bot de homologação antes de publicar em produção.

• Solicite apenas os dados necessários no flow e informe ao cliente por que você pede cada informação.

• Ao coletar dados no WhatsApp, mantenha conformidade com a LGPD e com as políticas da Meta.

Suporte

Precisa de ajuda com um flow específico? Dentro do editor, clique em Entrar em contato com a Wiv para falar com o time de especialistas. Para dúvidas ou problemas com a extensão, escreva para support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃