
# Pesquisa Web em Tempo Real

A pesquisa na web em tempo real dá ao seu bot de IA a capacidade de buscar informações durante uma conversa — tanto no seu próprio site quanto na internet aberta. Quando um cliente pergunta sobre um produto específico, disponibilidade ou preços que podem mudar com frequência, o bot pode verificar e responder com informações atualizadas.


**Em termos simples:** Em vez de depender apenas das informações estáticas que você inseriu durante a configuração, o bot pode visitar as páginas do seu site em tempo real para encontrar os detalhes mais recentes.

---

## Por que você pode precisar da Pesquisa Web

Sem a pesquisa web, seu bot só sabe o que você inseriu em suas instruções e FAQs. Isso funciona bem para informações que raramente mudam (como sua política de devolução ou horário de funcionamento). Mas, para coisas que são atualizadas com frequência, a pesquisa web mantém o bot atualizado.

**Com a pesquisa web ativada, o bot pode:**

- Pesquise em seu site por produtos específicos com base no que o cliente está procurando
- Obtenha informações atualizadas sobre preços, disponibilidade ou estoque
- Compartilhe links diretos para páginas específicas de produtos ou serviços
- Pesquise perguntas gerais na internet aberta, mesmo sobre assuntos que não estão no seu site
- Leia URLs que um cliente compartilha na conversa

**Exemplo de conversa:**

> **Cliente:** Vocês têm apartamentos de 3 quartos disponíveis em Amsterdã?
>
> **Bot:** Deixe-me verificar nossas listagens atuais para você...
>
> Temos 2 apartamentos de três quartos disponíveis em Amsterdã agora:
>
> 1. Jordaan Canal View - 3 quartos/2 banheiros, 95m2, EUR 2.450/mês
> 2. De Pijp Modern - 3 quartos/1 banheiro, 82m2, EUR 2.100/mês
>
> Gostaria de mais detalhes sobre algum deles?

Sem a pesquisa web, o bot teria que dizer algo genérico como "Temos apartamentos disponíveis em Amsterdã. Verifique nosso site para ver as listagens atuais." Com a pesquisa web, ele fornece ao cliente exatamente o que ele precisa, diretamente no chat.

---

## Como Funciona

1. O cliente pergunta sobre algo específico
2. A IA decide que realizar uma pesquisa ajudaria a responder à pergunta
3. O bot pesquisa as URLs Dinâmicas que você configurou (pesquisa no site) ou a internet aberta (pesquisa na web), usando palavras-chave da conversa
4. O conteúdo mais relevante é recuperado
5. A IA incorpora as descobertas em sua resposta

> **O bot possui duas habilidades de web.** (1) **Pesquisa no site** analisa apenas as URLs Dinâmicas que você configura aqui, e é também o que permite que o bot abra um link que um cliente cola no chat — portanto, ele precisa de **pelo menos uma** URL Dinâmica para funcionar. (2) **Pesquisa na web** realiza uma busca pública na internet aberta para perguntas gerais que não estão no seu site, e **não** precisa de URLs Dinâmicas. Ambas são controladas pelo botão **Pesquisa na web por IA**: desative-o e o bot não fará nenhuma das duas, respondendo apenas com base em suas FAQs, fontes de conhecimento e instruções. A pesquisa na web também requer um plano que inclua o recurso de pesquisa na web em tempo real.

O bot usa dois modos de pesquisa dependendo da pergunta:

- **Modo de lista** - Quando o cliente está navegando ou comparando opções, o bot verifica o conteúdo da sua página e retorna os resultados mais relevantes. Por exemplo: "Quais apartamentos vocês têm disponíveis?"
- **Modo específico** - Quando o cliente pergunta sobre um item específico, o bot encontra e compartilha um link direto para o produto ou serviço correspondente. Por exemplo: "Vocês têm o Nike Air Max 90 na cor preta?"

O bot escolhe o modo correto automaticamente com base na conversa.

O bot também lida com links que os clientes compartilham. Se um cliente colar uma URL no chat, o bot pode ler essa página e usar as informações na conversa.

---

## Como ativar a pesquisa na web

### Verifique seu plano

A pesquisa na web em tempo real está disponível em planos elegíveis ou quando ativada em sua conta. Verifique seu [nível de assinatura](../billing/subscription-tiers.md) para confirmar.

### Configuração

1. Abra o [Agente](../ai-agents/ai-agents.md) (em **AI Studio → AI Agents**). (Para um Agente ainda vinculado a uma campanha clássica, a mesma configuração também aparece na etapa **FAQs & Knowledge** dessa campanha.)
2. Clique na aba **FAQs & Knowledge** — a pesquisa na web fica lá junto com suas FAQs e fontes de conhecimento, já que todas são formas de o bot encontrar respostas.
3. Role até a seção **AI web search**.


4. Mude a chave ao lado de **Pesquisa na web por IA** para LIGADO. (Se o seu plano não incluir esse recurso, a chave estará desativada e um aviso de upgrade aparecerá — faça o upgrade em **Configurações → Faturamento** primeiro.)
5. Uma lista e um campo de entrada de texto aparecerão abaixo. Estas são suas **URLs Dinâmicas** — as páginas da web que o bot pesquisará, até **10** por Agente. Elas são **opcionais**: deixe a lista vazia e o bot ainda poderá realizar uma pesquisa pública na web. Adicionar pelo menos uma URL é o que ativa a pesquisa em suas próprias páginas e a leitura de links que os clientes colam no chat.
6. Cole uma URL no campo de entrada e clique em **+ Adicionar** (ou pressione Enter).


7. Repita para cada página que deseja adicionar. Depois de adicionar 10, o campo de entrada desaparece — remova uma primeiro se quiser adicionar uma página diferente.
8. Clique em **Save changes** na parte inferior.

### O que são URLs Dinâmicas?

URLs Dinâmicas são as páginas da web que você deseja que o bot possa pesquisar durante as conversas. Elas são diferentes das "URLs da Página de Vendas" que você pode ter adicionado durante a configuração da campanha:

| | URLs da Página de Vendas | URLs Dinâmicas |
|--|----------------|-------------|
| **Quando usadas** | Lidas uma vez durante a configuração da campanha | Pesquisadas em tempo real durante cada conversa relevante |
| **Objetivo** | Gerar instruções iniciais e perguntas frequentes para o bot | Fornecer respostas ao vivo e atualizadas |
| **Melhor para** | Conteúdo estático (página sobre, informações gerais) | Conteúdo que muda frequentemente (listagens, estoque, preços) |

### Quais páginas adicionar como URLs Dinâmicas

- Páginas de listagem ou catálogo de produtos
- Páginas de serviços
- Páginas de preços que mudam frequentemente
- Páginas de estoque ou disponibilidade
- Qualquer página com informações que são atualizadas regularmente

---

## Casos de uso comuns

| Cenário | O que o cliente pergunta |
|----------|----------------------|
| **Busca de produto** | "Vocês têm tênis de corrida azuis tamanho 42?" |
| **Verificação de disponibilidade** | "Quais apartamentos vocês têm disponíveis este mês?" |
| **Consulta de preços** | "Quanto custa o plano Profissional?" |
| **Comparação de recursos** | "Qual é a diferença entre o Básico e o Pro?" |
| **Promoções atuais** | "Vocês têm alguma promoção acontecendo?" |
| **Verificação de link** | O cliente compartilha um link de produto, o bot lê e fornece detalhes |

---

## Quando o bot pesquisa (e quando ele não pesquisa)?

**O bot VAI pesquisar quando:**

- O cliente perguntar sobre algo específico que provavelmente está no seu site
- A pergunta envolver detalhes que mudam (preços, disponibilidade, níveis de estoque)
- A resposta ainda não estiver coberta nas instruções ou FAQs do bot

**O bot NÃO vai pesquisar quando:**

- A pergunta pode ser respondida a partir das FAQs ou das Instruções de IA (não há necessidade de pesquisar)
- A pergunta não está relacionada ao conteúdo do seu site

---

## Custo de Crédito

Uma pesquisa na web é cobrada como qualquer outra chamada de ferramenta de bot, no nível de Qualidade de IA do seu Agente:

| Nível de Qualidade de IA | Créditos por pesquisa na web | Com sua própria chave Anthropic (BYOK) conectada |
|---|---|---|
| Pro | 1 crédito | 0 créditos — executado na sua chave |
| Economy (descontinuado) | 0,5 créditos | 0 créditos — executado na sua chave |
| Max | 0,25 créditos | ainda 0,25 créditos, cobrados mesmo com sua própria chave conectada, porque o Max é executado em nosso próprio modelo |
| Mini | 0,15 créditos | ainda 0,15 créditos, cobrados mesmo com sua própria chave conectada, porque o Mini é executado em nosso próprio modelo |

**Dica:** Se o bot estiver pesquisando com muita frequência pelos mesmos tipos de perguntas, considere adicionar essas respostas como FAQs. As FAQs são incluídas automaticamente e não custam créditos extras.

---

## Dicas para Melhores Resultados

1. **Adicione páginas com conteúdo estruturado.** Páginas de listagem de produtos, catálogos e tabelas de preços funcionam melhor. Evite páginas que exijam login. Páginas dinâmicas e renderizadas por JavaScript são suportadas.

2. **Use a pesquisa na web junto com as FAQs.** Para informações que raramente mudam (políticas de devolução, horário de funcionamento, informações gerais), use FAQs. Reserve a pesquisa na web para conteúdos que são atualizados com frequência.

3. **Teste no Try Out.** Faça perguntas específicas sobre o produto para garantir que o bot consiga encontrar e apresentar informações do seu site corretamente.

4. **Monitore o uso de créditos.** Se o seu bot pesquisar com frequência, considere expandir suas FAQs para cobrir perguntas comuns - isso reduz a necessidade de pesquisas na web e economiza créditos.

---

## Próximos passos

- [Gerenciando FAQs](faq-management.md) — a outra ferramenta na mesma aba para fundamentar o bot no seu conteúdo.
- [Funções Personalizadas](custom-functions.md) — as ferramentas integradas **Search Your Website**, **Check a Link** e **Search the Web** que este recurso utiliza.
- [Agentes de IA](../ai-agents/ai-agents.md) — onde a aba FAQs & Knowledge está localizada.
