> ## 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.

# Menções (@)

> Todas as 18+ menções disponíveis para automatizar ações dentro do prompt dos agentes

## Visão geral

As **menções** são comandos especiais escritos com `@` no prompt que permitem ao agente executar ações automaticamente durante a conversa. São o recurso mais poderoso da LíderHub — com elas, você automatiza desde alteração de status até geração de contratos.

<Frame>
  <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" />
</Frame>

## Lista completa de menções

<iframe src="https://www.loom.com/embed/123509cefc8b42719b74c19345b83324" width="100%" height="400" frameBorder="0" allowFullScreen />

Veja a lista de ações que a IA da LíderHub pode executar automaticamente, via prompt.

### 1. <Badge color="blue">@status</Badge> — Alterar status

Status é a posição da conversa na jornada deste departamento. A LíderHub é ótima para departamento comercial e pós-venda de escritórios de advocacia. Confira mais sobre [Departamento Comercial](/migracao/departamento-comercial), [Dashboard](/migracao/dashboard) e [Status](/atendimento/status).

> Assim que o lead aceitar os termos do vídeo enviado, altere o status para <Badge color="blue">@PropostaAceita</Badge>. Se ele recusar explicitamente, altere para <Badge color="blue">@PropostaRecusada</Badge>

### 2. <Badge color="blue">@tag</Badge> — Adicionar etiqueta

Adiciona uma ou mais [etiquetas](/atendimento/etiquetas) ao contato para categorização.

> Se a idade for maior que 65 anos, adicione tag <Badge color="blue">@idoso</Badge>. Se já tiver advogado, adicione tag <Badge color="blue">@TemAdvogado</Badge>

### 3. <Badge color="blue">@departamento</Badge> — Alterar departamento

Roteia a conversa para outro [departamento](/atendimento/departamento).

> Se o lead for cliente, altere departamento para <Badge color="blue">@suporte</Badge>
>
> Se for novo lead, altere departamento para <Badge color="blue">@comercial</Badge>

### 4. <Badge color="blue">@responsavel</Badge> — Definir responsável

Transfere a conversa para um humano ou outro agente. Confira mais em [Responsável](/atendimento/responsavel).

> Se o lead pedir atendimento humano, altere responsável para <Badge color="blue">@Victor</Badge>
>
> Se for qualificado com laudo, escolha <Badge color="blue">@Responsável Aleatório (3)</Badge>

<Frame caption="Na seleção de Responsável Aleatório você pode selecionar quais usuários entrariam na distribuição.">
  <img src="https://mintcdn.com/liderhub/v9nmEM--YQzhLeFk/images/responsavel-aleatorio.png?fit=max&auto=format&n=v9nmEM--YQzhLeFk&q=85&s=0e1676afc4ec06049ed0cb754f2e39ee" alt="Seleção de responsável aleatório na LíderHub" width="1024" height="598" data-path="images/responsavel-aleatorio.png" />
</Frame>

<Tip>
  Ao transferir para um humano, a IA para de responder automaticamente. Use a [sobreposição de prompt](/agentes/qualificacao) para deixar uma mensagem de transição.
</Tip>

### 5. <Badge color="blue">@template</Badge> — Enviar mídias ([Templates](/templates/roteiros-videos))

Envia um template (mensagem rápida) com texto, áudio, vídeo, PDF ou imagem.

> Se o lead for qualificado, envie <Badge color="blue">@videoproposta</Badge>
>
> Ao iniciar a conversa, envie <Badge color="blue">@bemvindo</Badge>
>
> Quando enviar o contrato, envie <Badge color="blue">@tutorialassinatura</Badge>

<Frame>
  <img src="https://mintcdn.com/liderhub/1qc4ZnBNSWzXKZCJ/images/template-mencao.png?fit=max&auto=format&n=1qc4ZnBNSWzXKZCJ&q=85&s=03098377211868951c191be06a8d7cf4" alt="Seleção de template no prompt da LíderHub" width="1024" height="479" data-path="images/template-mencao.png" />
</Frame>

### 6. <Badge color="blue">@gerarcontrato</Badge> — ZapSign

Gera automaticamente um contrato via [ZapSign](/integracoes/zapsign) e envia o link para assinatura.

> Após confirmar todos os dados, use <Badge color="blue">@gerarcontrato</Badge> e envie o link para o usuário preencher. Além disso, envie o vídeo tutorial <Badge color="blue">@tutorialassinatura</Badge>

<Warning>
  Só funciona com a integração ZapSign configurada. Veja [ZapSign](/integracoes/zapsign).
</Warning>

### 7. <Badge color="blue">@calendario</Badge> — Google Calendar

Verifica disponibilidade e agenda reuniões automaticamente via [Google Calendar](/integracoes/google-calendar).

> Consulte <Badge color="blue">@verificar disponibilidade</Badge> e com base nos horários disponíveis, ofereça 3 slots de 30min nos próximos 3 dias úteis, entre 9am e 5pm.
>
> Assim que o lead confirmar um horário, então <Badge color="blue">@criar evento</Badge>.
>
> Se quiser alterar a data do evento, então <Badge color="blue">@editar evento</Badge>.
>
> Se o lead quiser deletar o evento, então <Badge color="blue">@deletar evento</Badge>.

<Tip>
  Na LíderHub, revise o prompt do **Agenor**, que é um agente de exemplo responsável por agendamento de reuniões. Confira também o tutorial abaixo:

  <iframe src="https://www.loom.com/embed/6ac971d2a6d24042b7afca46b911d628" width="100%" height="400" frameBorder="0" allowFullScreen />
</Tip>

### 8. <Badge color="blue">@notificar</Badge> — Notificação interna

Notifica um membro da equipe sem transferir a conversa. A notificação chega no aplicativo web do usuário, e se ele tiver o [app no celular](/app-celular), também chega no celular dele.

> Se o lead tiver alto potencial, notifique <Badge color="blue">@notificarvitor</Badge>

<Info>
  Diferente de `@responsavel`, a notificação **não** transfere a conversa. O responsável atual continua o atendimento.
</Info>

### 9. <Badge color="blue">@resumo</Badge> — Gerar resumo

Gera um resumo automático da conversa como nota interna.

<Frame>
  <img src="https://mintcdn.com/liderhub/wzbCFHneRZjJhPGE/images/gerar-resumo.png?fit=max&auto=format&n=wzbCFHneRZjJhPGE&q=85&s=8cd8febb30e4f82778f7091ea80727c0" alt="Gerar resumo na LíderHub" width="1024" height="707" data-path="images/gerar-resumo.png" />
</Frame>

> Antes de transferir para humano, gere resumo com <Badge color="blue">@resumo</Badge>

Você pode adicionar instruções específicas para o resumo:

> Gere <Badge color="blue">@resumo</Badge> incluindo nome, idade, se tem laudo, renda familiar e objeções levantadas

### 10. <Badge color="blue">@think</Badge> — Raciocínio complexo

Permite que a IA "pense" mais profundamente antes de responder, útil para cálculos e decisões complexas.

> Quando o lead informar a renda familiar, use <Badge color="blue">@think</Badge> para calcular se ele se enquadra

### 11. <Badge color="blue">@biblioteca</Badge> — Base de conhecimento

Consulta a base de conhecimento (documentos PDF/TXT) para buscar informações.

> Se o lead perguntar sobre um benefício específico, consulte <Badge color="blue">@biblioteca</Badge>

<Tile href="/agentes/base-conhecimento" title="Base de Conhecimento" description="Anexe perguntas frequentes, quebra de objeção e mais para a IA consultar.">
  <img src="https://mintcdn.com/liderhub/X2vSZ9F0ApxL3CZN/images/base-conhecimento.png?fit=max&auto=format&n=X2vSZ9F0ApxL3CZN&q=85&s=967cae0d7c42c8b9526f80ab7958c443" alt="Base de Conhecimento na LíderHub" width="2020" height="1065" data-path="images/base-conhecimento.png" />
</Tile>

### 12. <Badge color="blue">@calculadora</Badge> — Cálculos matemáticos

Realiza cálculos como renda per capita, percentuais, idade etc.

> A renda per capita é definida pela renda por pessoa. Dessa forma, utilize <Badge color="blue">@calculadora</Badge> para fazer o cálculo: (Soma das #RendasVálidas de todas as pessoas da família)/(Quantidade de pessoas Válidas) → Devemos comparar este valor com R\$405,25 - Se o valor for menor, então a condição é válida, e prossiga com o processo

### 13. <Badge color="blue">@dataehora</Badge> — Buscar a data atual

Busca a data e hora atual para trazer mais contexto à IA. Útil quando o lead menciona datas relativas como "hoje", "amanhã" ou "semana que vem".

> Se o lead disser que quer a reunião para hoje execute <Badge color="blue">@dataehora</Badge> e verifique, se for sábado e domingo diga que esta reunião só fazemos durante a semana.

**Exemplo de resposta da função:**

```text theme={null}
Essa é a data e horário de agora, utilize ela como referencia para data futuras: terça-feira, 17/03/2026 11:21:24 (horário de Brasília)
```

Busca a data e hora atual para trazer mais contexto à IA.

> Se o lead disser que quer a reunião para hoje execute <Badge color="blue">@dataehora</Badge> e verifique, se for sábado e domingo diga que esta reunião só fazemos durante a semana.

### 14. <Badge color="blue">@salvarnome</Badge> — Corrigir nome do contato

Atualiza o nome do contato no sistema. O nome que chega do WhatsApp pode ser um apelido, emoji ou número.

> Se <Badge color="blue">@nome</Badge> parecer incomum (emoji, apelido, número): pergunte "Seu contato está salvo como <Badge color="blue">@nome</Badge>. Como prefere que eu te chame?" Quando responder, use <Badge color="blue">@salvarnome</Badge> para atualizar.
>
> Se <Badge color="blue">@nome</Badge> for comum (Ana, João, Pedro): pergunte "Posso te chamar de <Badge color="blue">@nome</Badge>?"

<Tip>
  Isso funciona muito bem para o caso clássico do lead cujo nome no WhatsApp é "Deus é Fiel 🙌" — você pode confirmar o nome, alterar no sistema, e a IA também vai dar continuidade com o novo nome na conversa.
</Tip>

### 15. <Badge color="blue">@ativaraudio</Badge> — Modo áudio

Ativa o envio de mensagens em áudio ([voz clonada](/agentes/voz) ou sintetizada).

> Se o lead falar que não sabe ler, então ative <Badge color="blue">@ativaraudio</Badge> para responder em áudio

### 16. <Badge color="blue">@desativaraudio</Badge> — Desativar áudio

Desativa o modo áudio, voltando a enviar mensagens em texto.

> Após responder a objeção em áudio, use <Badge color="blue">@desativaraudio</Badge>

### 17. <Badge color="blue">@desativarIA</Badge> — Desativar IA

Para de responder automaticamente na conversa.

> Se o lead perguntar se é solteira ou casada, então <Badge color="blue">@desativarIA</Badge>

### 18. <Badge color="blue">@origem</Badge> — Definir origem

Define a [origem](/atendimento/origem)/fonte do lead.

> Se o lead veio por indicação, defina origem <Badge color="blue">@indicacao</Badge>
>
> Se veio pelo Instagram, defina origem <Badge color="blue">@instagram</Badge>

### 19. <Badge color="blue">@advbox</Badge> — Consultar AdvBox

Consulta processos judiciais na [AdvBox](/integracoes/advbox) usando o CPF do cliente.

<iframe src="https://www.loom.com/embed/17b58cfb0be3433e9867bb1fc5546e4b" width="100%" height="400" frameBorder="0" allowFullScreen />

> Após o lead informar o CPF, consulte <Badge color="blue">@advbox</Badge> para verificar processos

Na LíderHub, confira o template de agente chamado **Andamentilson** — há um exemplo de prompt com <Badge color="blue">@advbox</Badge>.

<Callout>
  Hoje não é possível criar contatos ou processos na AdvBox via prompt. Se você acha isso interessante, por favor solicite no formulário [Feedback de Melhorias sobre Menções (@)](#deixe-uma-sugestão).
</Callout>

### 20. <Badge color="blue">@variável</Badge> — Salvar variáveis

Permite que a IA preencha [variáveis](/atendimento/variaveis) personalizadas de cada lead automaticamente. Extremamente relevante quando você precisa checar dados na conversa (e-mail, CPF, processo, ID...) ou extrair informações estruturadas do lead.

> Assim que o lead informar a renda mensal, salve em <Badge color="blue">@renda</Badge> apenas o número em reais da renda total mensal.

<Callout>
  Hoje não é possível alterar o tipo de conteúdo salvo, isto é, restringir em formato de número, data... Funciona apenas com texto. Via prompt você pode orientar a IA de como ela deve extrair o conteúdo.
</Callout>

### 21. <Badge color="blue">@personalizado</Badge> — Ação personalizada

Cada [Custom Tool](/integracoes/personalizada) que você criar vira uma menção com o nome configurado (ex: <Badge color="blue">@consultarcrm</Badge>). A IA aciona a chamada à API externa quando você usa essa menção no prompt.

<Tile href="/integracoes/personalizada" title="Integrações personalizadas" description="Configure Custom Tools e crie suas próprias menções @ação para chamar APIs externas." />

## Exemplo completo de prompt com menções

Confira exemplos práticos de prompts completos em [Exemplos de Prompt](/agentes/exemplos-prompt).

## Lógica por trás da menção

Cada menção é um **código estruturado** no prompt. Se você copiar e colar o texto do prompt em outro lugar, pode parecer confuso — isso é normal.

Visualmente, você vê: <Badge color="blue">@Qualificado</Badge>

Mas o texto real por trás é:

```json theme={null}
{
  "type": "status",
  "label": "Qualificado",
  "uuid": "b211caa2-b88e-42e0-b930-38404f5cf7ab",
  "redeference_id": "ref-5x9f7lvc"
}
```

<Callout>
  Por isso, ao editar o prompt, sempre use a interface da LíderHub para inserir menções - cuidado se você copiar e colar código manualmente.

  Esses snippets JSON entram na **contagem de caracteres** do prompt. Confira os limites de referência por modelo em <Tooltip headline="Contagem de caracteres" tip="Como funciona o contador de caracteres do prompt e os limites por modelo." cta="Ver mais" href="/agentes/configuracoes-agente#contagem-de-caracteres">Contagem de caracteres</Tooltip>.

  Se você quer editar seu prompt com IA, verifique nossa [IA para editar prompt](/agentes/criar-agentes#editar-agentes-de-ia).
</Callout>

## Menções inválidas <Badge color="red">@status</Badge>

Se aparecer alguma menção em **vermelho** no prompt, ou um alerta na lista de agentes, significa que há menções inválidas — a menção referencia um item que **não existe** no seu workspace (status, template, membro, etc.).

<Frame>
  <div style={{ display: 'flex', gap: '8px' }}>
    <img src="https://mintcdn.com/liderhub/v9nmEM--YQzhLeFk/images/mencoes-invalidas-lista.png?fit=max&auto=format&n=v9nmEM--YQzhLeFk&q=85&s=1acb8c9941c14eaaed352010ad000e40" alt="Alerta de menções inválidas na lista de agentes" style={{ width: '50%', objectFit: 'cover', height: '150px', borderRadius: '8px' }} width="665" height="226" data-path="images/mencoes-invalidas-lista.png" />

    <img src="https://mintcdn.com/liderhub/v9nmEM--YQzhLeFk/images/mencoes-invalidas-prompt.png?fit=max&auto=format&n=v9nmEM--YQzhLeFk&q=85&s=7441cd6b87882bf5b5c5363b463a1188" alt="Menções inválidas no prompt do agente" style={{ width: '50%', objectFit: 'cover', height: '150px', borderRadius: '8px' }} width="1214" height="378" data-path="images/mencoes-invalidas-prompt.png" />
  </div>
</Frame>

Para corrigir, clique na menção vermelha e selecione o item correto do seu workspace, ou crie o item que está faltando.

<Warning>
  Agentes com menções inválidas podem apresentar comportamento inesperado. Sempre corrija antes de ativar.
</Warning>

## Deixe uma sugestão

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

  <iframe src="https://tally.so/embed/682q2k?feature=Men%C3%A7%C3%B5es%20(%40)&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="Posso criar minhas próprias menções?">
    Sim. Use as Custom Tools para criar menções personalizadas que chamam APIs externas.
  </Accordion>

  <Accordion title="Quantas menções posso usar em um único prompt?">
    Não há limite. Use quantas menções forem necessárias para automatizar seu fluxo.
  </Accordion>

  <Accordion title="A menção @calculadora é precisa?">
    Sim, para cálculos simples. Para cálculos complexos, combine com @think para raciocínio mais detalhado.
  </Accordion>
</AccordionGroup>