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

# ADVBox

> Como integrar a ADVBox para consultar status de processos judiciais automaticamente

## Visão geral

A integração com a **ADVBox** permite que seus agentes de IA consultem automaticamente o status de processos judiciais dos seus clientes, respondendo perguntas como "Como está o andamento do meu processo?".

## Configuração

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

<Steps>
  <Step title="Copiar Chave API ADVBox e colar na LíderHub">
    Na ADVBox, acesse **Integrações > API**. Copie a chave e a API.

    <Frame caption="Configurações (1) > Integrações e API (2) > Liderhub (3) > Copiar token (4)">
      <img src="https://mintcdn.com/liderhub/aARKMYylrcyg8cvf/images/advbox-copiar-token.png?fit=max&auto=format&n=aARKMYylrcyg8cvf&q=85&s=4a5470db1f21627f3e754de4d8058977" alt="Tela da ADVBox: acessar Configurações, Integrações e API, e copiar token Liderhub" width="1024" height="610" data-path="images/advbox-copiar-token.png" />
    </Frame>

    Na LíderHub: acesse [Configurações > Integrações](https://chat.liderhub.ai/settings/integrations), clique em **ADVBox**, depois em **Conectar API** **(5)**. Cole a chave API no campo **(6)** e clique em **Conectar** **(7)**.

    <Frame caption="Conectar API (5) > Chave da API (6) > Conectar (7)">
      <img src="https://mintcdn.com/liderhub/aARKMYylrcyg8cvf/images/advbox-liderhub-conectar-api.png?fit=max&auto=format&n=aARKMYylrcyg8cvf&q=85&s=cdcf65de2d216af661754840034cec50" alt="Tela da LíderHub: integração ADVBox, aba Conectar API, campo Chave da API e botão Conectar" width="975" height="1024" data-path="images/advbox-liderhub-conectar-api.png" />
    </Frame>
  </Step>

  <Step title="Escrever definição de status">
    Nas configurações ADVBox na LíderHub, acesse **Descrever Status** **(8)**. Para cada status identificado na ADVBox, escreva uma descrição em **Significado** **(9)** — os agentes da LíderHub usam essa descrição para explicar a etapa ao cliente quando consultado.

    <Frame caption="Descrever Status (8) > Significado (9)">
      <img src="https://mintcdn.com/liderhub/aARKMYylrcyg8cvf/images/advbox-descrever-status.png?fit=max&auto=format&n=aARKMYylrcyg8cvf&q=85&s=207bf45f49c6291587eeca9a352d993a" alt="Tela Descrever Status na LíderHub: etapas do Advbox e campo Significado para cada status" width="974" height="1024" data-path="images/advbox-descrever-status.png" />
    </Frame>
  </Step>

  <Step title="Use no prompt do agente">
    Adicione a menção <Badge color="blue">@advbox</Badge> no prompt, com base nas [menções do prompt](/agentes/mencoes#18-advbox-consultar-advbox):

    ```text theme={null}
    Se o cliente perguntar sobre o andamento do processo:
    1. Peça o CPF: "Para consultar, preciso do seu CPF."
    2. Consulte @advbox com o CPF informado
    3. Informe o status do processo de forma clara e simples
    ```
  </Step>
</Steps>

## Como funciona

Quando a IA recebe o CPF do cliente, ela consulta a ADVBox e retorna:

* Lista de processos vinculados ao CPF
* Status/etapa atual de cada processo
* Informações sobre andamento

## Boas práticas

<Tip>
  Configure as etapas dos processos na ADVBox com descrições claras e em linguagem simples. A IA usa essas descrições para explicar o status ao cliente.
</Tip>

Exemplo de resposta da IA:

```text theme={null}
"Encontrei seu processo. Atualmente ele está na etapa de 
'Aguardando decisão judicial'. Isso significa que o juiz 
está analisando o caso e em breve teremos uma resposta."
```

## Deixe uma sugestão

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

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

## Dúvidas Frequentes

<AccordionGroup>
  <Accordion title="O cliente precisa informar o CPF para consultar?">
    Sim. A IA precisa do CPF para buscar os processos na ADVBox.
  </Accordion>

  <Accordion title="As etapas do processo aparecem para o cliente?">
    A IA traduz as etapas em linguagem simples para o cliente. Configure as descrições na ADVBox de forma clara.
  </Accordion>
</AccordionGroup>