# 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**.&#x20;

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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helena.app/duvidas-e-novidades/faq/como-criar-e-integrar-whatsapp-flows-a-plataforma.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
