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

# Testar e Ativar Agentes

> Quando e como ativar agentes de IA, palavras-chave, responsável padrão e desfibrilador

## Visão geral

Os agentes de IA da LíderHub respondem automaticamente às mensagens dos seus clientes no WhatsApp. Existem várias formas de ativar um agente em uma conversa: como responsável padrão, via palavras-chave, menções ou ações em massa.

## Formas de ativar um agente

### 1. Responsável padrão da conexão

Toda nova conversa recebida naquele número de WhatsApp será atribuída ao agente definido como responsável padrão. [Ver mais](/whatsapp/conectar#configurações-da-conexão).

<Frame caption="A foto acima mostra configurações da conexão, e sempre que uma conversa for iniciada neste WhatsApp, o agente 'Acidente 1 Amanda' vai responder automaticamente.">
  <img src="https://mintcdn.com/liderhub/mMi6av5hQKUNG_BI/images/config-conexao.png?fit=max&auto=format&n=mMi6av5hQKUNG_BI&q=85&s=f8b1533a647fb8e4124262d5883cf44a" alt="Configurações da conexão na LíderHub" width="1850" height="893" data-path="images/config-conexao.png" />
</Frame>

<Steps>
  <Step title="Acesse a conexão">
    Vá em **Conexões** e clique no número conectado.
  </Step>

  <Step title="Defina o responsável padrão">
    No campo **Responsável padrão**, selecione o agente de IA desejado (normalmente o agente de triagem ou recepção).
  </Step>

  <Step title="Salve">
    Clique em salvar. A partir de agora, toda nova conversa será atendida por esse agente.
  </Step>
</Steps>

### 2. Palavras-chave

<Frame>
  <video src="https://mintcdn.com/liderhub/rnBA_FwLGpAWYwr1/images/video-keyword.webm?fit=max&auto=format&n=rnBA_FwLGpAWYwr1&q=85&s=71a66168e0cc263e27136d4474f4299e" autoPlay loop muted={true} playsInline style={{ width: '100%' }} data-path="images/video-keyword.webm" />
</Frame>

Cada agente pode ter palavras-chave associadas. Quando o lead envia uma mensagem contendo uma dessas palavras, o agente correspondente é ativado.

<Warning>
  Atenção, você **NÃO** precisa colocar palavras-chave em todos os agentes, apenas nos agentes que vão iniciar a conversa. Um agente pode repassar para outro agente de IA. Confira mais em [Prompt](/agentes/prompt-instrucoes).
</Warning>

<Warning>
  A **transferência entre agentes NÃO é feita por palavra-chave**. A troca de um agente para outro deve ser feita **exclusivamente via prompt**, usando a menção <Badge color="blue">@responsavel</Badge> (ou <Badge color="blue">@próximoagente</Badge>, conforme o nome do agente). A palavra-chave serve apenas para **ativar o agente no início** da conversa. Se no meio da conversa o lead mencionar uma keyword de outro agente, isso **não** ativa o outro agente na hora. A única forma de um agente passar a conversa para outro é mediante a menção <Badge color="blue">@próximoagente</Badge> no prompt. Confira [Sobreposição de Prompt](/agentes/sobreposicao-prompt) para boas práticas de transferência entre agentes.
</Warning>

<Frame>
  <img src="https://mintcdn.com/liderhub/TEbXkvjgVcmJWt0p/images/palavras-chave-agente.png?fit=max&auto=format&n=TEbXkvjgVcmJWt0p&q=85&s=80ca92c0c902f18faf65facb515d3887" alt="Palavras-chave configuradas no agente de IA" width="1757" height="489" data-path="images/palavras-chave-agente.png" />
</Frame>

#### Como configurar palavra-chave

Acesse a página do agente, e na seção **Configurações do Agente** adicione a palavra-chave desejada (1). Clique em **Salvar Edição** (2).

<Frame>
  <img src="https://mintcdn.com/liderhub/TEbXkvjgVcmJWt0p/images/keyword-agente.png?fit=max&auto=format&n=TEbXkvjgVcmJWt0p&q=85&s=9364e9bcc0168c7a3842c1b87b04a1a4" alt="Configuração de palavra-chave no agente de IA" width="1788" height="1018" data-path="images/keyword-agente.png" />
</Frame>

<Tip>
  Palavras-chave são muito úteis para campanhas de tráfego pago. Configure uma palavra-chave diferente para cada campanha e o agente correto será ativado automaticamente.
</Tip>

### 3. Menção no prompt de outro agente

Um agente pode transferir a conversa para outro usando a menção `@agente` no prompt.

<Tile href="/agentes/mencoes" title="Menções (@)" description="Como usar menções para transferir conversas entre agentes de IA automaticamente.">
  <img src="https://mintcdn.com/liderhub/TEbXkvjgVcmJWt0p/images/mencoes-prompt.png?fit=max&auto=format&n=TEbXkvjgVcmJWt0p&q=85&s=d74ffdd8ed0f0c5a3990b2bdeafd0d64" alt="Menções no prompt na LíderHub" width="1751" height="658" data-path="images/mencoes-prompt.png" />
</Tile>

### 4. Ações em massa

Selecione várias conversas e altere o responsável para um agente de IA. Útil para reativar a IA em conversas que ficaram paradas.

<Tile href="/atendimento/filtros-acoes-massa" title="Filtros e ações em massa" description="Como filtrar conversas e aplicar ações em massa na LíderHub.">
  <img src="https://mintcdn.com/liderhub/X2vSZ9F0ApxL3CZN/images/acoes-massa.png?fit=max&auto=format&n=X2vSZ9F0ApxL3CZN&q=85&s=1cad9a31824ea47b559098ff06ccf8ab" alt="Ações em massa na LíderHub" width="590" height="404" data-path="images/acoes-massa.png" />
</Tile>

### 5. Manualmente

Abra a conversa, vá nas propriedades e altere o **Responsável** para o agente desejado.

<Tile href="/atendimento/responsavel" title="Responsável" description="Entenda como funciona a propriedade de responsável e como transferir conversas entre IA e humanos.">
  <img src="https://mintcdn.com/liderhub/X2vSZ9F0ApxL3CZN/images/agente-atendimento.png?fit=max&auto=format&n=X2vSZ9F0ApxL3CZN&q=85&s=caf8a8d9742651b5794c8a3a0cfd678a" alt="Responsável da conversa na LíderHub" width="1477" height="964" data-path="images/agente-atendimento.png" />
</Tile>

## Resetar agente

Para testar seu agente novamente (inclusive palavras-chave), envie `/restart` para o WhatsApp conectado. Isso vai resetar a experiência da IA na conversa, permitindo que você teste o fluxo desde o início.

<Frame>
  <video src="https://mintcdn.com/liderhub/rnBA_FwLGpAWYwr1/images/video-restart.webm?fit=max&auto=format&n=rnBA_FwLGpAWYwr1&q=85&s=80d59c9c7aa7bee2d71e0e2b3e96a4dd" autoPlay loop muted={true} playsInline style={{ width: '100%' }} data-path="images/video-restart.webm" />
</Frame>

<Note>
  Você deve enviar `/restart` **PARA** seu WhatsApp conectado.
</Note>

<Steps>
  <Step title="Configure uma palavra-chave ou agente padrão">
    Configure uma [palavra-chave (keyword)](#2-palavras-chave) ou um [agente padrão na sua conexão](#1-responsável-padrão-da-conexão).
  </Step>

  <Step title="Envie /restart">
    Logo depois que enviar `/restart`, envie a keyword (ex: **BPC**) do seu WhatsApp pessoal para o WhatsApp que está conectado à LíderHub.
  </Step>

  <Step title="Converse com o agente">
    Converse com o agente e teste o fluxo completo.
  </Step>

  <Step title="Reinicie o ciclo">
    Se quiser reiniciar o ciclo, envie `/restart` novamente.
  </Step>
</Steps>

## Deixe uma sugestão

<Accordion title="Feedback de Melhorias sobre Ativar o Agente">
  Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).

  <iframe src="https://tally.so/embed/682q2k?feature=Ativar%20o%20Agente&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="A IA responde a todas as mensagens automaticamente?">
    Sim, desde que o responsável da conversa seja um agente de IA. Se for um humano, a IA não responde.
  </Accordion>

  <Accordion title="Posso ter mais de um agente ativo no mesmo número?">
    Sim. Use palavras-chave para rotear ou configure um agente de triagem que encaminha para os demais.
  </Accordion>
</AccordionGroup>