> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maketalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrar com Caixa de Entrada

> Conecte seu agente Flow Builder a uma caixa de entrada para começar a atender

## Visão geral da integração

Para que seu agente do Flow Builder comece a atender clientes, ele precisa ser vinculado a uma **caixa de entrada** (inbox). A vinculação é feita diretamente nas configurações da caixa de entrada no Make Talk.

```
[WhatsApp/Instagram/Webchat] → [Caixa de Entrada] → [Agente Flow Builder] → Cliente atendido
```

***

## Pré-requisitos

Antes de integrar, certifique-se de ter:

<Check>
  Uma caixa de entrada configurada no Make Talk (WhatsApp, Instagram, etc.)
</Check>

<Check>
  Um agente criado no Flow Builder com fluxo configurado e status **Publicado**
</Check>

<Check>
  Permissão de administrador na conta
</Check>

<Warning>
  Agentes com status "Rascunho" não aparecem para seleção. Publique seu agente no Flow Builder antes de tentar vinculá-lo.
</Warning>

***

## Passo a passo da integração

<Steps>
  <Step title="Acesse as Configurações">
    No painel do Make Talk, clique em **Configurações** no menu lateral esquerdo.

    <Frame caption="Menu de Configurações no Make Talk">
      <img src="https://mintcdn.com/maketalk-7da59a87/N5-Q22gbtnd5e37o/images/administradores/flow-builder/menu-configuracoes.png?fit=max&auto=format&n=N5-Q22gbtnd5e37o&q=85&s=40e19c2c04861457007777a754f29ebd" alt="Menu de configurações" width="936" height="742" data-path="images/administradores/flow-builder/menu-configuracoes.png" />
    </Frame>
  </Step>

  <Step title="Selecione Caixas de Entrada">
    Na lista de configurações, clique em **Caixas de Entrada**.
  </Step>

  <Step title="Escolha a caixa de entrada">
    Clique na caixa de entrada onde deseja habilitar o agente de IA (por exemplo, seu WhatsApp ou Instagram).

    <Frame caption="Lista de caixas de entrada disponíveis">
      <img src="https://mintcdn.com/maketalk-7da59a87/N5-Q22gbtnd5e37o/images/administradores/flow-builder/lista-inboxes.png?fit=max&auto=format&n=N5-Q22gbtnd5e37o&q=85&s=a59aa1e8a543719ae98a6da13f1e7eab" alt="Lista de caixas de entrada" width="3042" height="1684" data-path="images/administradores/flow-builder/lista-inboxes.png" />
    </Frame>
  </Step>

  <Step title="Acesse a aba 'Configurações do bot'">
    Dentro das configurações da caixa de entrada, clique na aba **Configurações do bot**.

    <Frame caption="Aba Configurações do bot na caixa de entrada">
      <img src="https://mintcdn.com/maketalk-7da59a87/N5-Q22gbtnd5e37o/images/administradores/flow-builder/aba-config-bot.png?fit=max&auto=format&n=N5-Q22gbtnd5e37o&q=85&s=9af9a9a85ee8c10a42eb7483f65adf74" alt="Aba configurações do bot" width="2766" height="1666" data-path="images/administradores/flow-builder/aba-config-bot.png" />
    </Frame>
  </Step>

  <Step title="Selecione AI Flow Builder">
    Você verá três opções de automação:

    | Opção               | Descrição                                          |
    | ------------------- | -------------------------------------------------- |
    | **Nenhum**          | Sem automação - apenas atendimento humano          |
    | **Webhook**         | Bot tradicional via webhook (integrações externas) |
    | **AI Flow Builder** | Agente de IA criado no Flow Builder                |

    Selecione **AI Flow Builder**.
  </Step>

  <Step title="Escolha o agente">
    Um dropdown aparecerá com a lista de agentes disponíveis. Selecione o agente que você criou no Flow Builder.

    <Note>
      Apenas agentes com status **Publicado** aparecem na lista. Se seu agente não aparecer, volte ao Flow Builder e publique-o.
    </Note>
  </Step>

  <Step title="Salve a configuração">
    Clique em **Atualizar** para salvar. O agente começará a atender automaticamente as novas conversas nesta caixa de entrada.

    <Warning>
      Se a caixa de entrada já tiver outro tipo de automação ativa (webhook ou outro agente), ela será substituída pela nova configuração.
    </Warning>
  </Step>
</Steps>

***

## Opções de automação

### Nenhum (sem automação)

Todas as mensagens vão diretamente para a fila de atendimento humano. Use esta opção quando:

* Você quer desativar temporariamente o agente de IA
* A caixa de entrada é para atendimento exclusivamente humano

### Webhook (bot tradicional)

Usa um bot externo via webhook. Esta opção existe para compatibilidade com integrações antigas ou bots customizados externos.

### AI Flow Builder

O agente de IA criado no Flow Builder responde automaticamente. Esta é a opção recomendada para usar a IA da Make Talk.

***

## Comportamento do agente

### Como a IA interage com atendentes humanos

O Flow Builder trabalha em conjunto com sua equipe:

```
Nova mensagem → IA atende automaticamente
                      ↓
        Se configurado no fluxo → Transfere para humano
                      ↓
        Humano assume a conversa
```

**Pontos importantes:**

* A IA responde todas as novas mensagens automaticamente
* Transferências (handoff) acontecem conforme configurado no fluxo
* Quando um humano assume, a IA para de responder naquela conversa
* A IA continua ativa para novas conversas

### Quando o agente responde

| Situação              | Comportamento                         |
| --------------------- | ------------------------------------- |
| Nova conversa         | IA responde automaticamente           |
| Cliente responde      | IA continua atendendo                 |
| Humano envia mensagem | IA para de responder (humano assumiu) |
| Conversa reaberta     | IA volta a responder                  |

### Comportamento em caso de falha

Se o agente de IA encontrar um erro e não conseguir responder, o comportamento padrão é **abrir a conversa automaticamente** para que um atendente humano assuma.

<Info>
  Se você prefere que a conversa permaneça como <strong>pendente</strong> em caso de falha do agente (evitando que o cliente veja a conversa sem resposta), solicite ao suporte a ativação dessa opção na sua conta. Com essa configuração ativa, falhas do agente não alteram o status da conversa.
</Info>

***

## Múltiplas caixas de entrada

### Um agente para várias inboxes

Você pode vincular o mesmo agente a múltiplas caixas de entrada:

```
                    ┌─ WhatsApp Vendas ─┐
                    │                   │
[Agente Vendas] ────┼─ Instagram Loja ──┤── Mesmo atendimento
                    │                   │
                    └─ Webchat Site ────┘
```

**Vantagens:**

* Consistência no atendimento
* Manutenção centralizada
* Base de conhecimento compartilhada

Para vincular o mesmo agente a várias inboxes, repita o processo de integração para cada caixa de entrada.

### Agentes diferentes por inbox

Cada caixa de entrada pode ter seu próprio agente:

```
WhatsApp Vendas    → Agente Vendas (foco em conversão)
WhatsApp Suporte   → Agente Suporte (foco em resolução)
Instagram          → Agente Social (foco em engajamento)
```

**Vantagens:**

* Atendimento especializado
* Métricas separadas
* Fluxos customizados por canal

***

## Testando a integração

Após vincular, teste a integração:

<Steps>
  <Step title="Envie mensagem de teste">
    Use um número/conta diferente e envie uma mensagem para o canal.
  </Step>

  <Step title="Verifique a resposta">
    O agente deve responder de acordo com o fluxo configurado.
  </Step>

  <Step title="Teste o fluxo completo">
    Simule uma conversa completa:

    * Perguntas que ativam diferentes rotas
    * Qualificação de lead
    * Coleta de dados
    * Transferência para humano
  </Step>

  <Step title="Verifique no Make Talk">
    Abra a plataforma Make Talk e confirme:

    * Conversa aparece na caixa de entrada
    * Mensagens do agente estão registradas
    * Etiquetas foram aplicadas corretamente
  </Step>
</Steps>

<Tip>
  Use o Playground do Flow Builder primeiro para testar o fluxo antes de conectar a uma inbox real.
</Tip>

***

## Desconectando o agente

Para desativar o agente de uma caixa de entrada:

<Steps>
  <Step title="Acesse Configurações → Caixas de Entrada">
    Navegue até a caixa de entrada desejada.
  </Step>

  <Step title="Vá em Configurações do bot">
    Clique na aba **Configurações do bot**.
  </Step>

  <Step title="Selecione 'Nenhum'">
    Marque a opção **Nenhum** para desativar a automação.
  </Step>

  <Step title="Ou clique em Desconectar">
    Alternativamente, clique no botão **Desconectar** para remover a vinculação atual.
  </Step>
</Steps>

***

## Solução de problemas

<AccordionGroup>
  <Accordion title="O agente não está respondendo">
    Verifique:

    * O agente está com status **Publicado** no Flow Builder?
    * A vinculação foi salva na aba "Configurações do bot"?
    * A caixa de entrada está conectada ao canal (WhatsApp online, etc.)?
    * O horário de funcionamento está configurado corretamente?
  </Accordion>

  <Accordion title="Meu agente não aparece na lista">
    O agente pode estar com status **Rascunho**. Acesse o Flow Builder, abra o agente e clique em **Publicar** para torná-lo disponível.
  </Accordion>

  <Accordion title="Respostas estão lentas">
    Possíveis causas:

    * Alta demanda no momento
    * Fluxo muito complexo
    * Base de conhecimento muito grande

    Solução: Simplifique o fluxo ou contate suporte.
  </Accordion>

  <Accordion title="Mensagens não aparecem no Make Talk">
    Verifique:

    * Conexão do canal está ativa
    * Não há erros na integração WhatsApp/Instagram
    * Webhook está configurado corretamente
  </Accordion>

  <Accordion title="Etiquetas não estão sendo aplicadas">
    Verifique:

    * Etiquetas existem na conta Make Talk
    * Configuração do bloco de Handoff inclui etiquetas
    * O fluxo está passando pelo bloco correto
  </Accordion>
</AccordionGroup>

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Base de Conhecimento" icon="database" href="/administradores/flow-builder/base-conhecimento-agente">
    Conecte uma KB para respostas mais precisas.
  </Card>

  <Card title="Caixas de Entrada" icon="inbox" href="/administradores/caixas-entrada">
    Saiba mais sobre configuração de inboxes.
  </Card>

  <Card title="Blocos Disponíveis" icon="cubes" href="/administradores/flow-builder/blocos-disponiveis">
    Conheça todos os blocos do Flow Builder.
  </Card>

  <Card title="Construir um Fluxo" icon="diagram-project" href="/administradores/flow-builder/construir-fluxo">
    Aprenda a criar fluxos de atendimento.
  </Card>
</CardGroup>