
# Funis de Vendas

A plataforma se conecta aos seus funis de vendas existentes para que, quando alguém preencher um formulário de inscrição na sua página de destino, essa pessoa seja adicionada automaticamente como contato e receba uma mensagem personalizada - tudo sem que você precise fazer nada manualmente.

**Em termos simples:** Alguém se cadastra no seu site e, em poucos minutos, recebe uma mensagem de WhatsApp do seu bot de IA iniciando uma conversa real.


---

## O que uma integração de funil faz

Quando você conecta sua página de destino à plataforma, cada novo lead é automaticamente:

1. **Adicionado como contato** no aplicativo
2. **Adicionado a uma lista de contatos específica** que sua Transmissão monitora
3. **Engajado pelo seu bot de IA** com uma mensagem de abertura personalizada
4. **Acompanhado automaticamente** caso não respondam

Isso transforma uma página de inscrição passiva em uma conversa de vendas ativa - gerenciada inteiramente pelo seu bot de IA.

**Exemplo: Como funciona na prática**

```
Someone fills out your landing page form
       |
       v
Your automation tool (Pabbly, Zapier, or Make) sends
the lead's info to the platform
       |
       v
The platform creates the contact and adds them to your list
       |
       v
Your Broadcast sends a personalized WhatsApp message
       |
       v
The lead replies, and your AI bot continues the conversation
```

---

## O que sua página de inscrição precisa coletar

Sua página de destino (criada com ClickFunnels, Leadpages, Systeme.io, WordPress ou qualquer outra ferramenta) precisa coletar pelo menos estes dois campos:

### Campos obrigatórios

| Campo | Por que é necessário |
|-------|-----------------|
| **Número de Telefone** | A plataforma envia mensagens via WhatsApp ou SMS, portanto, um número de telefone é essencial. Deve incluir o código do país (por exemplo, +55 para o Brasil). |
| **Primeiro Nome** | Usado para personalizar a mensagem de abertura. Mensagens com o nome da pessoa obtêm taxas de resposta significativamente maiores. |

### Opcional, mas recomendado

| Campo | Por que ajuda |
|-------|-------------|
| **E-mail** | Permite o acompanhamento multicanal e ajuda a evitar contatos duplicados |
| **Sobrenome** | Personalização mais profissional |
| **Campos Personalizados** | Qualquer dado relevante para sua oferta (nome da empresa, área de interesse, etc.) |

**Dica:** Mantenha seu formulário curto. Número de telefone e primeiro nome são o mínimo. Cada campo extra que você adiciona reduz a taxa de conclusão do formulário. Você sempre pode coletar informações adicionais durante a própria conversa.

---

## Configurando seu Agente para Funis

Um funil precisa de duas coisas: um **Agente de IA** que conheça sua oferta e responda a cada lead da mesma maneira, e uma **Transmissão** que envia a primeira mensagem para os leads que seu funil coleta. Crie o Agente primeiro — a Transmissão aponta para ele.

### Configuração passo a passo

1. **Comece pelo seu agente**
   - Já tem um para esta oferta? Em **AI Studio**, clique em **AI Agents** e clique no nome dele. (No celular, toque primeiro no ícone de menu **☰**.)
   - Começando do zero? Clique em **New agent** e aponte-o para o seu site — ele lerá suas páginas e escreverá as instruções para você — ou escolha **Start blank**. Veja [Criando um Agente](../ai-agents/ai-agents.md#creating-an-agent).
   - Dê a ele um nome descritivo, por exemplo "Funil de Webinar - Março 2026".


2. **Configure o bot**
   - Na etapa **Instruções de IA**, escreva instruções adaptadas à oferta do seu funil
   - Adicione informações da empresa, perguntas frequentes e recursos específicos da oferta na etapa **FAQs e Conhecimento**
   - Defina o objetivo da conversa (por exemplo, "Agendar uma consulta gratuita")
   - Consulte o guia [Configurando seu Bot de IA](../ai-automation/ai-bot-setup.md) para obter instruções detalhadas


3. **Ative o agente**
   - De volta à página de Agentes de IA, use o botão **Activate agent** da linha para que seu status seja **Active**. A partir daí, ele responderá a qualquer pessoa que entrar em contato com você nos canais pelos quais é responsável.
   - Quais são esses canais é decidido pelos [Pontos de Entrada](../ai-agents/entry-points.md) — seja pela própria etapa de **Entry Points** do agente ou pelo painel **Who answers new conversations** no topo da página de Agentes de IA.

4. **Crie a Transmissão que envia a primeira mensagem**
   - Abra [Broadcasts](../broadcasts/broadcasts.md) e crie uma. Sua etapa de **Message** contém a mensagem de abertura que seus leads recebem — inclua o primeiro nome do contato, seja breve, esta é sua primeira impressão.
   - Na etapa **Replies**, escolha o agente que você acabou de criar. É isso que conecta o envio ao cérebro.
   - No WhatsApp, a mensagem de abertura deve ser enviada ao WhatsApp para aprovação antes de poder ser enviada; veja [Modelos de WhatsApp](../templates/whatsapp-templates.md).


5. **Anote o ID da sua Lista**
   - A automação do seu funil precisa do ID da lista na qual ele deve adicionar leads. Em **CRM**, abra **Contacts** → **Lists**, abra a lista para a qual sua Transmissão envia e copie o ID dela a partir de lá.


6. **Habilite acompanhamentos** (recomendado)
   - Ative os acompanhamentos automáticos na etapa **Follow-ups** do agente para que os leads que não responderem sejam reengajados
   - Veja o guia [Sistema de Acompanhamento](../ai-automation/follow-ups.md) para detalhes


---

## Conectando seu funil ao aplicativo

A plataforma funciona com todas as principais plataformas de automação. Veja como conectar o formulário da sua página de destino.

### Opção 1: Usando o Pabbly Connect

O Pabbly é econômico e lida bem com funis de alto volume.

**Etapas:**

1. **Configure um gatilho de webhook** - Isso é disparado quando alguém envia seu formulário de opt-in
2. **Adicione um atraso de 15-20 minutos** (opcional, mas recomendado) - Dá ao lead tempo para enviar uma mensagem primeiro, criando uma conversa mais natural
3. **Verifique se o contato já existe** - Chame a API para evitar a criação de duplicatas
4. **Crie o contato e adicione-o à sua lista em uma única chamada** - Envie as informações dele para a plataforma com o ID da Lista da sua Transmissão incluído (`listId`). Uma única solicitação cria o contato e o adiciona à lista, e adicioná-lo à lista é o que dispara a mensagem de abertura. (Veja [Integração Direta via API](#direct-api-integration) abaixo.)

### Opção 2: Usando o Zapier

**Etapas:**

1. **Gatilho:** Novo envio de formulário da sua página de destino
2. **Ação 1:** o aplicativo - Encontrar Contato (verifique se ele já existe)
3. **Filtro:** Continue apenas se o contato NÃO foi encontrado
4. **Ação 2:** o aplicativo - Criar Contato, incluindo o ID da Lista da sua Transmissão para que o contato seja criado diretamente na lista. Se você preferir a API bruta, um único POST "Webhooks by Zapier" para `/v1/contacts` com `listId` faz a mesma coisa - nenhuma etapa separada de "Adicionar à Lista" é necessária.

### Opção 3: Usando o Make (anteriormente Integromat)

**Etapas:**

1. **Gatilho de Webhook** do seu funil
2. **Verifique** se o contato já existe via API
3. **Crie** o contato caso ele seja novo, passando o ID da Lista do seu Broadcast (`listId`) na mesma requisição - isso cria o contato e o adiciona à lista em uma única chamada. Um único módulo HTTP POST para `/v1/contacts` resolve ambos.

---

## Integração Direta via API

Se você tem um desenvolvedor ou gerencia o backend do seu próprio site, você pode se conectar à API da plataforma diretamente, sem a necessidade de uma ferramenta de middleware.

### Crie o contato e adicione-o à sua lista - em uma única chamada

Você **não** precisa de duas requisições separadas. O endpoint de Criar Contato aceita um `listId`, portanto, uma única chamada cria o contato **e** o coloca na lista do seu Broadcast - e adicionar o contato a essa lista é exatamente o que dispara a mensagem de abertura.

```
POST https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "lastName": "Smith",
  "email": "john@example.com",
  "listId": "YOUR_LIST_ID"
}
```

Para adicionar o contato a várias listas de uma vez, use `listIds` (um array) em vez disso - ele tem precedência sobre `listId`:

```
{
  "phoneNumber": "+1234567890",
  "firstName": "John",
  "listIds": ["list123", "list456"]
}
```

> **Use nomes de campos em camelCase** (`phoneNumber`, `firstName`, `lastName`) - não `phone_number` / `first_name`. Qualquer campo que a plataforma não reconheça é armazenado como um [campo personalizado](../get-started/custom-contact-fields.md) no contato; portanto, um `phone_number` escrito incorretamente deixaria o contato sem número de telefone e a solicitação seria rejeitada.

### Adicionando um contato existente a uma lista (opcional)

Se o contato já existir e você precisar apenas adicioná-lo a uma lista, use o endpoint de adicionar à lista com o ID do contato:

```
POST https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY
Content-Type: application/json

{
  "contactId": "abc123",
  "listId": "YOUR_LIST_ID"
}
```

Veja a [referência completa da API de Contatos](../api/contacts.md) para todos os campos disponíveis.

**Onde encontrar sua chave de API:** Vá para **Configurações** (ícone de engrenagem, perto da parte inferior da barra lateral esquerda) → **Integrações** → **Chave de API**.

**Importante:** Sempre inclua o código do país no número de telefone (por exemplo, `+1` para os EUA, `+44` para o Reino Unido, `+31` para a Holanda).

---

## Como novos membros da lista acionam a mensagem de abertura

É isso que conecta tudo, uma vez que seu Broadcast esteja ativo com a opção **Enviar para novos membros da lista** ativada:

1. Um novo contato é adicionado à lista que seu Broadcast monitora (via automação, importação manual ou manualmente)
2. O Broadcast detecta o novo contato
3. A mensagem de abertura é enviada:
   - **1-3 contatos** são enviados imediatamente (este é o cenário normal de funil - uma pessoa se inscreve por vez)
   - **4+ contatos de uma vez** são automaticamente colocados em fila e enviados a uma taxa segura para proteger sua reputação de remetente
4. Quando o contato responde, o agente na etapa de **Respostas** do Broadcast assume a conversa

---

## O Fluxo Completo do Funil (Ponta a Ponta)

Aqui está tudo o que acontece quando um lead entra no seu funil:

1. **O lead preenche seu formulário de opt-in** na sua landing page
2. **Sua ferramenta de automação** (Pabbly, Zapier, Make) recebe os dados do formulário
3. **Atraso opcional de 15-20 minutos** para ver se o lead envia uma mensagem primeiro
4. **A automação verifica** se o contato já existe no aplicativo
5. **O contato é criado na sua lista** via uma única chamada de API (o ID da Lista do Broadcast é incluído na requisição de criação, portanto, a criação e a adição à lista ocorrem juntas)
6. **O Broadcast envia** a mensagem de modelo de WhatsApp de abertura
7. **O lead lê a mensagem** e responde
8. **Seu bot de IA** inicia uma conversa personalizada
9. **O bot trabalha em prol do seu objetivo** (agendar reunião, qualificar lead, compartilhar oferta)
10. **Se o lead ficar em silêncio**, acompanhamentos automáticos o reengajam
11. **Se o bot precisar de ajuda**, ele alerta um membro da equipe para assumir

---

## Melhores práticas

1. **Adicione um pequeno atraso antes de criar o contato.** Um atraso de 15 a 20 minutos dá tempo para os leads enviarem uma mensagem primeiro. Se eles fizerem isso, eles entram no fluxo de entrada (uma conversa mais natural). Se não, o modelo de saída é enviado.

2. **Ative o Envio para novos membros da lista para funis contínuos.** Na etapa de **Público** do Broadcast, essa configuração mantém o Broadcast monitorando a lista após o lançamento, para que cada novo lead que se inscrever receba a mensagem de abertura automaticamente. Leads que enviam mensagem primeiro são tratados pelo mesmo agente através de seus Pontos de Entrada, para que ambas as direções terminem em uma única configuração.

3. **Personalize a mensagem inicial.** Sempre inclua o primeiro nome do contato no modelo de WhatsApp. Mensagens iniciais genéricas obtêm taxas de resposta muito menores.

4. **Mantenha a mensagem inicial curta.** Duas a três frases é o ideal. Faça uma pergunta para convidar a uma resposta. Por exemplo: "Olá {first_name}! Obrigado por se inscrever para nossa consulta gratuita. Qual é o maior desafio que você está enfrentando com [tópico] agora?"

5. **Habilite acompanhamentos.** Leads de funil estão interessados, mas ocupados. Um acompanhamento 24 a 72 horas depois geralmente os traz de volta.

6. **Teste o fluxo completo antes de lançar.** Envie um opt-in de teste na sua landing page, verifique se o contato foi criado no aplicativo e confirme se a mensagem inicial chegou.

7. **Monitore suas taxas de conversão.** Acompanhe quantos leads do funil respondem à mensagem de abertura e quantos convertem para o seu objetivo (agendamento, venda, etc.) a partir das estatísticas do Broadcast. Ajuste suas instruções de IA e a mensagem de abertura com base no que você aprender.

8. **Evite duplicatas.** Sempre verifique se um contato existe antes de criá-lo. Contatos duplicados levam a conversas confusas e desperdício de créditos.

9. **Obtenha o consentimento adequado.** Certifique-se de que sua página de opt-in declare claramente que o lead receberá mensagens de WhatsApp. Inclua uma caixa de seleção de consentimento, se exigido em sua região.

---

## Próximos passos

- [Migrando de Campanhas para Broadcasts e Agentes](../moving-from-campaigns.md) - onde todas as configurações antigas de campanha residem agora.
- [Sistema de Acompanhamento](../ai-automation/follow-ups.md) - reengaje leads de funil que ficaram em silêncio.
- [Broadcasts](../broadcasts/broadcasts.md) - o guia completo para configurar o lado do envio.
- [Referência da API de Contatos](../api/contacts.md) - todos os campos que o endpoint de Criar Contato aceita.
