---
title: "Como configurar a IA: o guia definitivo"
description: "O Fuely AI é o agente de IA do Chatfuel que ajuda negócios de serviços a responder na hora, agendar compromissos, qualificar leads e encaminhar conversas."
canonical_url: https://chatfuel.com/pt/docs/ai-features/how-to-set-up-ai-the-definitive-guide
markdown_url: https://chatfuel.com/pt/docs/ai-features/how-to-set-up-ai-the-definitive-guide.md
last_updated: 2026-09-08
lang: pt
site: https://chatfuel.com/docs
llms_txt: https://chatfuel.com/llms.txt
---

# Como configurar a IA: o guia definitivo

O Fuely AI é o agente de IA do Chatfuel que ajuda negócios de serviços a responder na hora, agendar compromissos, qualificar leads e encaminhar conversas.

## 1. O que é o Fuely AI (e por que ele importa) [#1-o-que-é-o-fuely-ai-e-por-que-ele-importa]

O Fuely AI é o agente de IA do Chatfuel, projetado para ajudar negócios de serviços a responder na hora, [agendar compromissos](https://chatfuel.com/pt/docs/calendar/calendar), [qualificar leads](https://chatfuel.com/pt/docs/leads/leads) e encaminhar conversas para o lugar certo. Em vez de perder mensagens de clientes ou depender de respostas manuais lentas, o Fuely AI atua como um assistente inteligente que engaja os potenciais clientes no momento em que eles entram em contato.

A IA trabalha a partir de dados estruturados do negócio — informações da empresa, catálogo de serviços ou produtos, entradas do FAQ — mais as instruções que você escreve definindo como ela deve se comportar. Para prestadores de serviços de pequeno e médio porte, isso significa menos oportunidades perdidas, agendamentos mais rápidos e leads de melhor qualidade, que chegam pré-qualificados antes mesmo de uma pessoa entrar na conversa.

Imagine um salão de beleza local que normalmente tem dificuldade para dar conta das mensagens do WhatsApp. Com o Fuely AI, todo novo cliente que escreve recebe na hora uma saudação amigável, pode consultar a tabela de preços do salão e escolher um horário entre as vagas disponíveis. Se o cliente tem um pedido especial — como precisar de um profissional com uma especialidade específica — a IA coleta os detalhes e [passa a conversa para um membro da equipe](https://chatfuel.com/pt/docs/ai-features/how-to-stop-ai-during-active-conversations) sem atrito. O resultado é uma jornada do cliente mais fluida, menos carga de trabalho para a equipe e mais agendamentos confirmados, sem as idas e vindas demoradas.

## 2. Duas formas equivalentes de fazer tudo neste guia [#2-duas-formas-equivalentes-de-fazer-tudo-neste-guia]

Você pode concluir cada etapa abaixo de duas formas: no painel, ou pedindo ao [AI Co-Worker](https://chatfuel.com/pt/docs/ai-features/what-the-ai-co-worker-can-do-for-you) no chat. As duas fazem a mesma coisa — use a que preferir. O Co-Worker pode preencher sua Knowledge Base, montar seu catálogo, escrever instruções, definir regras de transferência e configurar qualquer automação. Por exemplo:

* *"Configure meu assistente de IA para o meu salão do zero."*
* *"Adicione meus serviços e FAQs, e transfira os chats para a minha equipe quando alguém pedir um humano."*

Conectar um canal é uma das poucas etapas que o AI Co-Worker não consegue concluir por você — a autorização acontece na sua própria conta da Meta ou do TikTok. O Co-Worker pode levar você direto à página certa: basta pedir. As conversas de teste também são por sua conta — o Co-Worker pode abrir o Test chat para você, mas quem faz o papel do cliente é você.

## 3. Como o Fuely AI funciona: canais, Knowledge Base e Automations [#3-como-o-fuely-ai-funciona-canais-knowledge-base-e-automations]

Antes de partir para a configuração, vale entender os blocos fundamentais do Fuely AI. Pense nele como um funcionário que atua com base em conhecimento, instruções e regras específicos.

### Canais [#canais]

O Fuely AI conversa com os clientes no [WhatsApp](https://chatfuel.com/pt/docs/whatsapp/how-to-activate-ai-in-whatsapp), [Instagram](https://chatfuel.com/pt/docs/instagram/how-to-activate-ai-in-instagram), [Facebook](https://chatfuel.com/pt/docs/facebook/how-to-activate-ai-in-facebook), TikTok e no seu [widget de chat do site](https://chatfuel.com/pt/docs/website/set-up-chat-widget-for-website). Você pode configurar tudo antes de um canal ser conectado — a configuração fica salva como rascunho e entra no ar no momento em que o canal é conectado.

### Knowledge Base [#knowledge-base]

A [Knowledge Base](https://chatfuel.com/pt/docs/ai-features/how-to-set-up-knowledge-base) é onde a IA aprende sobre o seu negócio. Ela tem três seções principais:

* **About Company** — o perfil do seu negócio (nome, contatos, horários, endereço, formas de pagamento, site, descrição curta).
* **Catalog** — uma lista focada de serviços ou produtos, cada um com nome, preço e chave de disponibilidade.
* **FAQ** — pares rápidos de pergunta e resposta para as dúvidas mais comuns dos clientes.

### Automations [#automations]

As [Automations](https://chatfuel.com/pt/docs/ai-features/automations) controlam onde a IA fala e como ela se comporta em cada lugar. Em **Fuely AI** → **Automations** você encontra o **Main bot** no topo — suas configurações são os padrões para tudo, e sua chave é o interruptor geral de toda a IA — e, abaixo dele, uma automação para cada origem de tráfego, agrupadas por canal: DMs do Instagram, comentários em posts e reels, respostas a stories, Facebook Messenger e comentários em posts, anúncios do WhatsApp, comentários do TikTok, o widget do site e assim por diante.

A automação de cada origem começa desligada (só o Main bot vem ligado por padrão), então ativar a IA em um canal significa ligar a automação daquela origem. Em origens de comentários, anúncios, stories e links, você também pode adicionar [custom automations](https://chatfuel.com/pt/docs/ai-features/how-to-create-a-custom-automation) — regras com nome que reagem apenas a [posts, anúncios ou palavras-chave específicos](https://chatfuel.com/pt/docs/ai-features/how-to-set-up-automation-for-specific-posts-or-ads). Quando várias regras poderiam responder à mesma mensagem, [uma ordem de prioridade decide qual responde](https://chatfuel.com/pt/docs/ai-features/which-automation-replies-to-a-message-or-comment).

Toda automação tem o mesmo conjunto de configurações — message delays, [follow-ups](https://chatfuel.com/pt/docs/ai-features/how-to-set-up-follow-ups), booking rules, catalog images e mais — e cada configuração é herdada do Main bot ou substituída localmente. Configure uma vez no Main bot e substitua apenas onde uma origem precisar de um comportamento diferente.

Uma regra simples: &#x2A;*a Knowledge Base é o que a IA sabe; as Automations são onde e como ela se comporta.**

### Additional instructions (o "cérebro" da IA) [#additional-instructions-o-cérebro-da-ia]

Toda automação tem uma configuração **Incoming messages**: se a IA responde ali, e as **Additional instructions** — o prompt que define como ela fala. Escreva as instruções no **Main bot** para aplicá-las em todos os lugares, ou em uma automação específica para moldar apenas aquela origem. É aqui que você define o papel da IA, os passos que ela deve seguir, o formato de saída e exemplos de resposta.

> **Observação:** Se você usava o Fuely AI antes: os campos separados de Profile (nome do agente, idioma do chat, saudação personalizada, mensagem de fallback, tamanho das mensagens, frequência de emojis) não existem mais. Tudo isso agora é escrito como instruções simples em **Additional instructions*&#x2A; — por exemplo, &#x2A;"Seu nome é Sofia. Fale português. Mantenha as mensagens com no máximo 2 linhas e use no máximo um emoji por mensagem."*

### Transferência para humanos [#transferência-para-humanos]

Se um cliente pede explicitamente uma pessoa real, ou se um pedido está fora do catálogo, o Fuely AI encaminha a conversa para a sua equipe. Isso é controlado pela configuração **Switch to human** de cada automação. Separadamente, a configuração **When AI replies** decide se a IA responde ou não — sempre, ou apenas fora do seu horário de trabalho.

Em resumo, o Fuely AI funciona combinando dados estruturados do negócio, instruções claras e automações por origem, para que o seu assistente saiba quando responder, quando agendar e quando transferir.

## 4. Checklist de início rápido [#4-checklist-de-início-rápido]

Antes de configurar o Fuely AI em detalhes, aqui está um checklist simples para colocar seu primeiro assistente no ar:

* [ ] Conecte seu canal — WhatsApp, Instagram, Facebook, TikTok ou o widget do site.
* [ ] Preencha "About Company" — adicione nome do negócio, e-mail, telefone, horários, endereço, formas de pagamento e site.
* [ ] Monte seu Catalog — adicione seus principais serviços ou produtos (nome + preço + disponibilidade). Mantenha menos de \~50 itens para a IA continuar focada.
* [ ] Escreva de 10 a 25 entradas de FAQ — capture as perguntas mais comuns dos clientes. Mantenha as respostas curtas (1 a 3 linhas cada).
* [ ] Escreva as **Additional instructions** no Main bot — defina os passos da tarefa do assistente, o formato de saída e exemplos de resposta. Use um estilo amigável (mensagens curtas, opções numeradas, confirmações claras).
* [ ] Ative as automações das origens que você quer que a IA cubra — toda origem começa desligada.
* [ ] Configure as regras de **Switch to human** — decida quando a IA deve escalar: pedido de humano, casos sensíveis ou complexos.
* [ ] Teste no Test chat — rode de 3 a 5 cenários típicos: agendar um serviço, perguntar uma FAQ, pedir um humano.
* [ ] Entre no ar e monitore — acompanhe as primeiras conversas. Adicione novas FAQs e refine as instruções ao longo do caminho.

## 5. Configuração passo a passo [#5-configuração-passo-a-passo]

Agora que você tem a visão geral, vamos percorrer a configuração em detalhes. Cada parte da Knowledge Base tem um papel específico, e mantê-las limpas garante que o Fuely AI funcione de forma confiável.

### 5.1 About Company [#51-about-company]

O perfil oficial do seu negócio. É daqui que a IA tira as informações essenciais da empresa.

**O que incluir:**

* Nome da empresa
* E-mail e telefone
* Horário de funcionamento
* Endereço
* Site
* Formas de pagamento
* Descrição curta "Sobre"

**Boas práticas:**

* Mantenha esta seção factual e concisa.
* Não a sobrecarregue com serviços, FAQs ou textos de venda — isso pertence ao Catalog ou ao FAQ.
* Lembre-se: About Company = quem você é, não tudo o que você faz.

### 5.2 Catalog [#52-catalog]

Uma lista estruturada dos seus serviços ou produtos. Cada item tem nome, preço, [imagens](https://chatfuel.com/pt/docs/catalog/how-to-attach-photos-to-services-or-products) e disponibilidade.

**O que incluir:**

* Serviços principais (por exemplo, "Corte de cabelo – R$ 30")
* Pacotes ou promoções (opcional)
* Apenas o que você realmente quer que os clientes agendem ou perguntem

**Boas práticas:**

* Mantenha o foco: menos de \~50 itens para clareza.
* Um serviço = um item (evite duplicatas).
* Nunca cole seu catálogo nas Additional instructions ou em About Company — isso desperdiça espaço de tokens e quebra o contexto da IA.

### 5.3 FAQ [#53-faq]

A seção de "respostas prontas" para as suas perguntas mais comuns.

**O que incluir:**

* Detalhes de envio/entrega
* Preços ou sinais (se ainda não estiverem no Catalog)
* Regras de agendamento e cancelamento
* Detalhes de localização e estacionamento

**Boas práticas:**

* Mantenha as respostas curtas (1 a 3 linhas).
* Formule as perguntas exatamente como os clientes perguntam.
* Não adicione explicações longas; deixe a IA expandir se for preciso.
* Nunca copie o FAQ para as Additional instructions ou About Company — a duplicação deixa o assistente inconsistente.

### 5.4 Additional instructions [#54-additional-instructions]

O conjunto principal de instruções que diz à IA como se comportar. É aqui que você define o papel, as tarefas, o estilo de saída e exemplos de resposta.

**Onde escrevê-las:**

1. Vá em **Fuely AI** → **Automations**.
2. Abra o **Main bot** (para moldar a IA em todos os lugares) ou uma automação específica (para moldar uma origem).
3. Abra a configuração **Incoming messages** e preencha **Additional instructions**.

**O que incluir:**

* Papel: "Você é um assistente de WhatsApp para um \[tipo de negócio]."
* Tarefa: fluxo passo a passo (cumprimentar → coletar informações → oferecer opções → confirmar).
* Formato de saída: adequado ao WhatsApp (curto, opções numeradas, emojis opcionais).
* Exemplo de saída: uma mensagem de chat real de exemplo, para a IA reproduzir o estilo.

**Boas práticas:**

* Mantenha as instruções focadas em comportamento e formato, não em dados brutos.
* Não cole o Catalog ou o FAQ aqui (eles já estão na Knowledge Base).
* Use a estrutura Papel → Tarefa → Formato de saída → Exemplo de saída para maior clareza.
* Escreva primeiro no Main bot; substitua em uma automação específica só quando aquela origem realmente precisar de um comportamento diferente.

**Juntos, About Company, Catalog, FAQ e Additional instructions formam o contexto completo da IA:**

* About Company = sua identidade
* Catalog = o que você oferece
* FAQ = respostas rápidas
* Additional instructions = como a IA fala e age

## 6. Escrevendo prompts que funcionam [#6-escrevendo-prompts-que-funcionam]

As Additional instructions são o cérebro do assistente. Um prompt descuidado deixa sua IA vaga, repetitiva ou prolixa demais. Um prompt claro a deixa precisa, previsível e alinhada ao seu negócio.

### 6.1 Prompts ruins vs. bons [#61-prompts-ruins-vs-bons]

**Prompt ruim:**

```
Answer customer questions and be nice.
```

Problemas:

* Vago demais → a IA pode explicar em excesso.
* Sem estrutura → respostas inconsistentes.
* Sem estilo → não soa como WhatsApp.

**Prompt bom:**

```
### Task
1. Greet the customer warmly.
2. Ask what service they want.
3. Ask when customer wants to come.
4. Confirm the booking.

### Output Format
- Short WhatsApp-style messages (max 2 lines each).
- Always offer numbered options.
- Always confirm before finishing.

#### Example Output
- Welcome to our salon!
- Which service would you like to book today? 💇 Haircut, 💅 Manicure
  or 💆 Spa?
- When do you want to come?
- Got it — you'd like [service] on [date and time]. Do I understand correctly
  that everything is fine, and I can invite the manager to confirm the meeting?
```

Por que funciona: passos claros, estilo WhatsApp, mensagem de exemplo.

### 6.2 Fluxos em várias etapas e exemplos one-shot [#62-fluxos-em-várias-etapas-e-exemplos-one-shot]

Para fluxos que exigem raciocínio (como qualificação de leads), divida-os em etapas. Sempre mostre o estilo de resposta esperado com um exemplo de saída.

**Exemplo: captação de leads em imobiliária**

```
### Role
You are a WhatsApp assistant for a real estate agency.

### Task
1. Greet the lead.
2. Ask which property they're interested in.
3. Ask for budget range.
4. Ask when they'd like to schedule a viewing.
5. Confirm and offer to connect with an agent.

### Output Format
- Each step = one short WhatsApp message.
- Use numbered options when possible.
- Confirm details in the end.

#### Example Output
- 👋 Hi, thanks for reaching out to City Realty!
  Which property are you interested in?
  1) Apartment on Main Street
  2) House in Green Valley
  3) New downtown condos

- (After reply) Great! What's your budget range?
```

### 6.3 Estrutura de prompt [#63-estrutura-de-prompt]

Aqui está um modelo reutilizável para qualquer negócio:

```
### Task
1. Greet the customer.
2. Collect needed details (service/product, time, preferences).
3. Ask when customer wants to come.
4. Confirm and offer to connect with a manager.

### Output Format
- WhatsApp-style messages (max 2 lines).
- Numbered options for easy replies.
- End every message with the next step.

#### Example Output
- 👋 Hi! Thanks for contacting <Business Name>.
  How can I help today?
  1) 📅 Book a service
  2) 💳 Prices
  3) 👩‍💼 Talk to a team member
```

O principal a lembrar:

* **Prompts ruins = vagos e prolixos.**
* **Prompts bons = passos da tarefa, regras de saída, exemplo de saída.**

Isso garante que o Fuely AI se comporte de forma consistente em todos os chats.

## 7. Transferência para humanos: Switch to human [#7-transferência-para-humanos-switch-to-human]

A IA é poderosa, mas nunca deve tentar resolver tudo. O Fuely AI dá a você controle fino sobre quando escalar uma conversa e para quem ela deve ir. Isso é gerenciado na configuração **Switch to human** de cada automação — defina no Main bot para um comportamento único em todos os lugares, ou substitua por origem.

### 7.1 Regras (quando escalar) [#71-regras-quando-escalar]

Você pode definir até 20 regras — as condições que acionam uma transferência. As mais comuns incluem:

* O cliente pede explicitamente uma pessoa real ("Preciso falar com alguém", "Posso falar com um gerente?").
* O pedido do cliente está fora do escopo da IA (reembolsos, questões jurídicas/médicas/financeiras).
* O cliente envia respostas confusas várias vezes seguidas.

### 7.2 Para onde vão os chats transferidos [#72-para-onde-vão-os-chats-transferidos]

Por padrão, os chats transferidos vão para a caixa de entrada compartilhada da sua equipe, onde qualquer pessoa da [equipe](https://chatfuel.com/pt/docs/account/how-to-add-teammates) pode assumi-los. Cada regra pode, em vez disso, encaminhar o chat a uma pessoa específica — por exemplo, dúvidas de vendas para o Vendedor A, reclamações para o Suporte. Veja [como configurar regras de atribuição de chats](https://chatfuel.com/pt/docs/ai-features/how-to-set-up-chat-assignment-rules).

**Boa prática:** para assuntos urgentes, atribua um responsável na regra, para que o chat tenha um dono claro em vez de esperar na caixa de entrada compartilhada.

### 7.3 Decidindo se a IA responde ou não [#73-decidindo-se-a-ia-responde-ou-não]

Separada das regras de transferência, a configuração **When AI replies** controla se a IA responde, para começo de conversa. Ela tem duas opções:

* **Always** — a IA responde a toda mensagem (padrão).
* **Outside working hours** — a IA responde apenas quando o seu negócio está fechado, [com base no seu horário de funcionamento](https://chatfuel.com/pt/docs/ai-features/how-to-configure-working-hours); durante o expediente, sua equipe cuida dos chats.

Não existe a opção "nunca responder". Se você quer que um canal seja atendido inteiramente pela sua equipe, desligue a automação daquele canal em **Fuely AI** → **Automations** — uma automação desligada fica em silêncio, e suas configurações ficam guardadas para quando você ligá-la de novo.

### 7.4 Onde entra a escrita de prompts [#74-onde-entra-a-escrita-de-prompts]

* **Não escreva prompts dentro das regras de Switch to human.** Elas servem exclusivamente para a lógica de escalonamento. Os prompts (Papel, Tarefa, Formato de saída, Exemplo de saída) pertencem às Additional instructions.
* **Por quê:** misturar prompts em Switch to human gera confusão. A IA vai tratá-los como condições de escalonamento, e não como diretrizes de comportamento.

Pense assim:

* **Additional instructions** = como a IA deve falar.
* **Switch to human** = quando a IA deve parar de falar.

### 7.5 Resumo das boas práticas [#75-resumo-das-boas-práticas]

* Mantenha os gatilhos de escalonamento específicos ("Quero falar com uma pessoa").
* Atribua as regras urgentes ao membro certo da equipe; deixe a caixa compartilhada pegar o resto.
* Escreva prompts apenas nas Additional instructions, não aqui.

Com regras e responsáveis definidos corretamente, sua IA sabe exatamente quando atender um cliente e quando transferir com elegância.

## 8. Testes e iteração: deixando seu assistente mais inteligente [#8-testes-e-iteração-deixando-seu-assistente-mais-inteligente]

Lançar o assistente não é o fim — é o começo de um ciclo de testes, aprendizado e melhoria. O Fuely AI torna isso simples com o **Test chat** e as conversas reais.

### 8.1 Use o Test chat antes de entrar no ar [#81-use-o-test-chat-antes-de-entrar-no-ar]

Toda automação tem um **Test chat** — uma barra lateral que [simula uma conversa exatamente com as configurações daquela automação](https://chatfuel.com/pt/docs/ai-features/how-to-test-your-automation). Abra a automação que você quer conferir (as DMs de um canal, uma regra de comentários para um post específico ou o Main bot) e escreva como se fosse o cliente. É a forma mais segura de verificar se:

* As mensagens estão curtas e claras (estilo WhatsApp).
* As respostas do FAQ e do Catalog aparecem corretamente.
* As regras de transferência disparam quando deveriam.
* A origem que você está testando se comporta como você configurou — incluindo as configurações que você substituiu ali.

### 8.2 Fluxos principais para testar [#82-fluxos-principais-para-testar]

1. **Agendar um serviço/produto** — A IA consegue guiar o usuário passo a passo? Ela confirma antes de encerrar?
2. **Responder uma FAQ** — A resposta corresponde ao que você escreveu? Está curta (1 a 3 linhas) ou longa demais?
3. **Pedido de humano** — "Quero falar com uma pessoa de verdade" aciona o escalonamento?
4. **Casos extremos** — Erros de digitação ("cortr" em vez de "corte"), entrada incompleta ("terça" sem horário), respostas vagas repetidas.

### 8.3 Ciclo de iteração [#83-ciclo-de-iteração]

1. **Teste** com o Test chat e conversas reais.
2. **Identifique problemas:**
   * A IA diz "não tenho certeza" → adicione ao FAQ.
   * A IA entra em loop → simplifique os passos da tarefa nas Additional instructions.
   * A IA dá respostas longas demais → aperte o Formato de saída.
3. **Atualize a Knowledge Base** (About, Catalog, FAQ).
4. **Refine as instruções** (adicione passos claros, exemplos).
5. **Teste de novo.**

Esse ciclo é contínuo: cada conversa real com um cliente é material de treinamento gratuito para melhorar o seu assistente.

### 8.4 Boas práticas [#84-boas-práticas]

* **Comece pequeno:** lance com seus 5 principais serviços + 10 FAQs. Adicione mais só depois que o básico funcionar.
* **Mantenha as mensagens humanas:** se parece e-mail, reescreva.
* **Revise as transferências semanalmente:** garanta que o escalonamento aconteça nos momentos certos.
* **Atualize mensalmente:** horários, preços, serviços, FAQs.

Com testes rápidos e iteração, você garante que o Fuely AI pareça menos um "bot" e mais um assistente real da equipe — rápido, confiável e amigável.

## 9. Modelos por setor [#9-modelos-por-setor]

Estes prompts prontos para uso dão a você uma vantagem inicial. Basta colá-los em **Additional instructions** (na configuração Incoming messages do Main bot, ou na automação que você está ajustando) e adaptar os detalhes ao seu negócio.

### 9.1 Assistente de agendamento para salão / beleza [#91-assistente-de-agendamento-para-salão--beleza]

```
### Task
1. Greet the customer.
2. Ask what service they want (haircut, manicure, spa).
3. Ask when they would like to come.
4. Confirm and offer to connect with a manager.

### Output Format
- Short WhatsApp messages (max 2 lines).
- Use numbered options for service selection.
- Always confirm before escalating.

#### Example Output
👋 Hi Anna! Thanks for reaching out to Glamour Salon.
Which service would you like today?
1) 💇 Haircut
2) 💅 Manicure
3) 💆 Spa

(After reply) Great! When would you like to come?
(After reply) Perfect, I'll connect you with our manager to confirm your booking ✅
```

### 9.2 Assistente para clínica / saúde [#92-assistente-para-clínica--saúde]

```
### Task
1. Collect the patient's name.
2. Ask which doctor or specialty they want.
3. Ask when they'd like to visit.
4. Confirm and connect with a manager.

### Output Format
- Each step = one short WhatsApp message.
- Numbered options for specialties.
- Always confirm before escalating.

#### Example Output
👋 Welcome to City Health Clinic. May I have your full name, please?
(After reply) Thank you, [Name]. Which service do you need?
1) 🦷 Dentist
2) 👩‍⚕️ General Practitioner
3) 👶 Pediatrician

(After reply) When would you like to come in?
(After reply) Got it ✅ I'll connect you with our team to confirm your appointment.
```

### 9.3 Assistente de leads para imobiliária [#93-assistente-de-leads-para-imobiliária]

```
### Task
1. Greet the customer.
2. Ask which property they're interested in.
3. Ask for their budget.
4. Ask when they'd like to view it.
5. Confirm and connect with a manager.

### Output Format
- Short WhatsApp-style steps.
- Numbered options for properties.
- Confirm before escalating.

#### Example Output
👋 Hi! Thanks for contacting City Realty. Which property would you like to see?
1) Apartment in La Candelaria ($500)
2) House in Altavista ($120,000)
3) Studio in Sabana Grande ($350)

(After reply) Great! What's your budget range?
(After reply) When would you like to schedule a viewing?
(After reply) Perfect ✅ I'll connect you with our manager to confirm.
```

### 9.4 Assistente para academia / fitness [#94-assistente-para-academia--fitness]

```
### Task
1. Greet the customer.
2. Ask what class or training they're interested in.
3. Ask when they'd like to come.
4. Confirm and connect with a manager.

### Output Format
- Short WhatsApp replies.
- Numbered options for classes.
- Always confirm before escalating.

#### Example Output
💪 Welcome to PowerFit Studio!
Which option interests you today?
1) 📅 Group classes
2) 🏋️ Personal training
3) 🎟 Free trial

(After reply) Great! When would you like to come?
(After reply) Got it ✅ I'll connect you with our team to confirm your spot.
```

### 9.5 Assistente de entregas / despacho [#95-assistente-de-entregas--despacho]

```
### Task
1. Ask for the pickup address.
2. Ask for the drop-off address.
3. Ask when the delivery is needed.
4. Confirm and connect with a manager.

### Output Format
- Each step = one short WhatsApp message.
- Confirm before escalating.

#### Example Output
🚚 Hi! Thanks for choosing FastGo Delivery.
Please share your pickup address.

(After reply) Got it ✅ Now, what's the drop-off address?
(After reply) When do you need the delivery?
(After reply) Perfect, I'll connect you with our dispatcher to confirm.
```

Assim, o Fuely AI coleta todos os detalhes essenciais (serviço/produto + horário), mas nunca finge conhecer agendas ou disponibilidade. O gerente humano sempre faz a confirmação final.

## 10. Manutenção: mantendo seu assistente atualizado [#10-manutenção-mantendo-seu-assistente-atualizado]

Lançar o Fuely AI é só o começo. Para continuar eficaz, o assistente precisa de atualizações regulares. Um negócio que atualiza horários, preços e respostas mensalmente passa confiança. Um negócio que deixa informações desatualizadas frustra os clientes rapidamente.

### 10.1 O que atualizar regularmente [#101-o-que-atualizar-regularmente]

1. **Catalog** — adicione ou remova serviços/produtos conforme o seu negócio muda. Atualize os preços se mudarem — a IA nunca deve inventá-los.
2. **FAQ** — adicione novas perguntas que surgirem nos chats. Remova respostas irrelevantes ou desatualizadas. Mantenha as respostas curtas (1 a 3 linhas).
3. **Additional instructions** — revise seu Papel → Tarefa → Formato de saída → Exemplo de saída. Ajuste tom, fluxo ou passos de escalonamento se for preciso.
4. **Automations** — pause regras personalizadas de campanhas encerradas, adicione regras para novos posts ou anúncios, ative novas origens conforme expande para mais canais.

### 10.2 Usando conversas reais para melhorar [#102-usando-conversas-reais-para-melhorar]

* Revise os chats semanalmente.
* Identifique onde a IA diz "não tenho certeza" → adicione essa pergunta ao FAQ.
* Perceba idas e vindas longas antes da transferência → simplifique a Tarefa nas suas instruções.
* Veja erros de digitação recorrentes (por exemplo, "cortr") → adicione sinônimos ou formulações alternativas nas perguntas do FAQ.

### 10.3 Ritmo de iteração [#103-ritmo-de-iteração]

* **Semanalmente:** revise as conversas em busca de lacunas. Ajuste FAQs, instruções ou regras de escalonamento.
* **Mensalmente:** atualize o Catalog. Adicione novos serviços ou remova os inativos.
* **Trimestralmente:** revise toda a estrutura de instruções. Verifique a consistência do tom de voz. Rode cenários de teste no Test chat.

### 10.4 Boas práticas [#104-boas-práticas]

* **Comece enxuto:** 10 a 20 entradas de FAQ, 5 a 15 itens no Catalog. Expanda gradualmente.
* **Evite duplicação:** nunca cole o FAQ ou o Catalog nas Additional instructions ou em About Company.
* **Mantenha o tamanho de WhatsApp:** reescreva explicações longas em mensagens curtas e amigáveis.
* **Ensine por exemplo:** se você quer um estilo específico, adicione um Exemplo de saída.

### 10.5 Mentalidade de manutenção [#105-mentalidade-de-manutenção]

Pense no Fuely AI como um novo membro da equipe:

* Ele fica melhor quanto mais orientação você dá.
* Ele precisa de informações atualizadas para continuar útil.
* Ele não consegue adivinhar — então mantenha a Knowledge Base limpa e atualizada.

## 11. Solução de problemas: erros comuns e como corrigi-los [#11-solução-de-problemas-erros-comuns-e-como-corrigi-los]

Mesmo um assistente bem construído pode ter problemas. Aqui estão os mais comuns que você vai encontrar, por que acontecem e como resolvê-los.

| Problema                                                     | Causa provável                                                           | Como corrigir                                                                                                |
| ------------------------------------------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| A IA não responde em um canal ou origem                      | A automação daquela origem está desligada — toda origem começa desligada | Ative a automação da origem em Fuely AI → Automations                                                        |
| A IA não responde em lugar nenhum                            | O Main bot está desligado — ele é a chave geral de toda a IA             | Ligue o Main bot de novo                                                                                     |
| A IA fica em silêncio de dia, mas responde à noite           | **When AI replies** está definido como **Outside working hours**         | Mude para **Always** (ou mantenha — pode ser exatamente o que você quer)                                     |
| Resposta errada em um post ou anúncio específico             | Uma custom automation tem prioridade sobre a que você esperava           | Verifique a ordem de prioridade e ajuste a segmentação e as palavras-chave das regras                        |
| A IA entra em loop ou repete perguntas                       | As Additional instructions estão pouco claras ou longas demais           | Reescreva a Tarefa em passos curtos e numerados; adicione um Exemplo de saída                                |
| A IA diz "não tenho certeza" com muita frequência            | Falta uma entrada no FAQ ou item no Catalog                              | Adicione a pergunta/resposta ou o serviço que falta à Knowledge Base                                         |
| A IA responde com parágrafos longos                          | Não há Formato de saída nas instruções                                   | Adicione "Short WhatsApp-style messages, max 2 lines" ao Formato de saída                                    |
| A IA promete horários indisponíveis                          | As instruções incluem disponibilidade indevidamente                      | Remova os horários das instruções → em vez disso, pergunte "Quando você gostaria de vir?"                    |
| A IA inventa preços ou descontos                             | As informações de preço não estão no Catalog nem no FAQ                  | Adicione os preços corretos ao Catalog; nunca dependa da memória da IA                                       |
| O escalonamento não acontece quando o usuário pede um humano | Nenhuma regra de Switch to human definida                                | Adicione regras na configuração **Switch to human** com palavras-chave como "humano", "atendente", "gerente" |
| Transferências ficam sem dono na caixa compartilhada         | As regras não atribuem um membro específico da equipe                    | Atribua as regras urgentes a uma pessoa para que cada chat tenha um dono                                     |
| A IA mistura Catalog/FAQ com as instruções                   | Informações duplicadas coladas nas Additional instructions ou em About   | Remova Catalog/FAQ das instruções; mantenha-os apenas na Knowledge Base                                      |
| A IA ignora erros de digitação do cliente                    | O FAQ tem apenas uma formulação                                          | Adicione formulações alternativas ou sinônimos nas perguntas do FAQ                                          |
| A IA está formal ou robótica demais                          | O tom de voz não está definido nas instruções                            | Adicione um guia de estilo ao Formato de saída (por exemplo, "amigável, caloroso, mensagens curtas")         |
| A IA confirma agendamentos em vez do gerente                 | As instruções não especificam o escalonamento                            | Reescreva a Tarefa: coletar detalhes → perguntar o horário preferido → confirmar → escalar                   |

### 11.1 Fluxo geral de depuração [#111-fluxo-geral-de-depuração]

Quando algo parece errado:

1. **Verifique a automação** — a automação da origem está ligada? O Main bot está ligado? **When AI replies** está definido como você espera? Outra regra está tendo prioridade sobre esta?
2. **Verifique a Knowledge Base** (Catalog, FAQ, About).
3. **Verifique as Additional instructions** (passos claros + estilo de saída?).
4. **Verifique Switch to human** (regras + responsáveis).
5. **Teste no Test chat** para reproduzir o problema, corrija e teste de novo até o fluxo parecer natural.

Com essas correções, a maioria dos problemas se resolve em minutos.

## 12. Checklists [#12-checklists]

### 12.1 Checklist de lançamento [#121-checklist-de-lançamento]

Antes de entrar no ar, confirme que você fez o seguinte:

* [ ] Conectou seu canal (WhatsApp, Instagram, Facebook, TikTok ou site)
* [ ] Preencheu About Company com horários, endereço e contatos corretos
* [ ] Montou um Catalog (≤50 itens, preços corretos)
* [ ] Adicionou de 10 a 25 entradas de FAQ (respostas claras e curtas)
* [ ] Escreveu as Additional instructions com Papel → Tarefa → Formato de saída → Exemplo de saída
* [ ] Ativou as automações de todas as origens que você quer que a IA cubra
* [ ] Configurou as regras de Switch to human e atribuiu responsáveis onde necessário
* [ ] Escolheu a opção certa de **When AI replies** (Always, ou Outside working hours com o horário de funcionamento preenchido)
* [ ] Testou os fluxos no Test chat: agendamento, FAQ, fora do horário, transferência
* [ ] Redigiu as mensagens de fora do horário e de escalonamento

### 12.2 Checklist de atualização [#122-checklist-de-atualização]

Faça isso mensal ou trimestralmente:

* [ ] Atualize o horário de funcionamento (feriados, mudanças sazonais)
* [ ] Renove o Catalog (novos serviços, itens removidos, preços atualizados)
* [ ] Adicione novas FAQs com base nos chats recentes
* [ ] Remova FAQs irrelevantes ou desatualizadas
* [ ] Revise as Additional instructions quanto a clareza e consistência de tom
* [ ] Verifique as regras de Switch to human: ainda estão corretas? Atribuídas às pessoas certas?
* [ ] Revise quais automações estão ativas: pause campanhas encerradas, cubra novos posts e anúncios
* [ ] Teste o Test chat de novo com 3 a 5 fluxos
* [ ] Revise o feedback dos clientes e ajuste as mensagens de acordo

Com esses checklists, sua equipe pode lançar rapidamente, manter a consistência e sustentar um assistente de IA profissional sem confusão.
