> For the complete documentation index, see [llms.txt](https://docs.helena.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helena.app/duvidas-e-novidades/faq/como-criar-e-integrar-whatsapp-flows-a-plataforma.md).

# Como Criar e Integrar WhatsApp Flows à Plataforma

O **WhatsApp Flows** é uma ferramenta poderosa para criar formulários e fluxos de dados automatizados, otimizando a coleta de informações diretamente no chat. Atualmente, o processo de implementação combina a criação da estrutura inicial na nossa plataforma com a configuração técnica detalhada no **Gerenciador do WhatsApp (Meta)**, finalizando com a sincronização **via modelos de mensagem**. 

Siga o guia abaixo para configurar, criar e conectar seu Flow de maneira eficiente e segura.

#### Passo 1: Preparação e Permissões na Meta

Antes de iniciar a criação do fluxo, é obrigatório garantir que o usuário tenha as permissões administrativas na Business Manager (BM) da Meta.

1. Acesse as **Configurações do Negócio** (BM) da Meta.
2. No menu lateral, vá em **Contas > Contas de WhatsApp.**
3. Selecione a **WABA** (WhatsApp Business Account) desejada.
4. Clique em **Atribuir Pessoas** e conceda **permissão total** (controle total) ao usuário que ficará responsável pelas publicação do Flow
5. Localize e anote o **ID da sua WABA**, disponível no campo Identificação

<figure><img src="/files/vyHVIbPmnXMkKOKlVnj9" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/TEdoUAZsFhYocPk0cMA4" alt=""><figcaption></figcaption></figure>

#### Passo 2: Solicitação e Criação do Flow (Via Plataforma)

Nesta etapa, a estrutura inicial do fluxo é gerada pelo **CS do parceiro** através da própria plataforma HelenaCRM, sem a necessidade de acessar o Gerenciador da Meta inicialmente.

* Acione o seu **CS (Customer Success)** e informe o **ID da WABA** e o **nome desejado** para o fluxo.
* O CS realizará a criação do Flow via plataforma e ele aparecerá automaticamente na sua conta da Meta com o status de **"Rascunho".**

{% hint style="warning" %}
**Integração com Ferramentas Externas**

Caso o seu Flow precise enviar ou processar dados em sistemas externos — como um Webhook do N8N, Make ou APIs próprias — informe a **URL de Destino** ao seu CS. Ele realizará o vínculo técnico necessário para que o fluxo funcione como uma "ponte", direcionando as informações coletadas para o seu integrador
{% endhint %}

<figure><img src="/files/jCKCrZJw6lZQurZVU81i" alt=""><figcaption></figcaption></figure>

#### Passo 3: Validação e Publicação

Com a integração técnica concluída, o fluxo precisa ser validado para ser utilizado.

* Clique na aba **Verificação de Integridade** e selecione o botão **"Faça a verificação de integridade".**
* Após a validação ser concluída com sucesso, clique em **Publicar** no canto superior direito.

<figure><img src="/files/UqNthXqRL4dN3r9I1t27" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Whp7qMFwQFtVlKTl6QG8" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Você pode ajustar o JSON do FLOW livremente. Lembre-se de clicar em **'Executar'** para conferir se está tudo certo antes de publicar.
{% endhint %}

#### Passo 4: Criação do Modelo de Mensagem e Sincronização

Logo após publicar o Flow, o sistema exibirá uma mensagem confirmando a publicação e oferecendo o próximo passo imediato.

<figure><img src="/files/XmtelyR9CmWmiEasO7Tm" alt=""><figcaption></figcaption></figure>

1. **Vincular Modelo:** Na mensagem de confirmação, clique no botão **Adicionar a um modelo de mensagem.**
2. **Configurar Template:**
   * **Nome:** O nome virá preenchido com o mesmo nome do Flow, mas você pode alterá-lo se desejar.
   * **Idioma:** Altere o idioma para Portuguese BR.
   * **Conteúdo:** Defina o conteúdo do seu template, incluindo cabeçalho, corpo de texto e rodapé.

<figure><img src="/files/1EdWIgBX6JucVTCGTln5" alt=""><figcaption></figcaption></figure>

3. **Enviar para Análise:** Clique em Enviar para análise após concluir as modificações.
4. **Acompanhamento:** O modelo será listado na tela de modelos, onde você poderá acompanhar o status de aprovação da Meta.

<figure><img src="/files/z3Aoc5mZUL6sf4RRxXrh" alt=""><figcaption></figcaption></figure>

5. **Sincronização Final:** Assim que o modelo for aprovado, acesse a plataforma em **Ajustes > Modelos de Mensagem** e clique em **Sincronizar** para que ele fique disponível para uso.

<figure><img src="/files/OOjFQ4zQb9M2BOPt9TZT" alt=""><figcaption></figcaption></figure>