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

# Configuração

> A partir deste painel você pode gerenciar os contatos visíveis para os agentes, controlar o uso de modelos de mensagens HSM, personalizar as propriedades do HubSpot exibidas no chat e definir as regras de atribuição de conversas.

<Tabs>
  <Tab title="Agentes">
    # Visibilidade de contatos para agentes

    Na aba de agentes você pode configurar quais contatos cada agente pode visualizar na plataforma.

    <img src="https://mintcdn.com/trebleai/N7qFKPzh9cWmkY9Y/images/Screenshot2025-05-21at7.05.05AM.png?fit=max&auto=format&n=N7qFKPzh9cWmkY9Y&q=85&s=863e15716e6828f0a16c149342763df5" alt="Screenshot 2025-05-21 at 7.05.05 AM.png" width="2940" height="1662" data-path="images/Screenshot2025-05-21at7.05.05AM.png" />

    ### Por que é útil?

    Esta configuração permite adaptar o acesso aos contatos de acordo com a estrutura e operação da sua equipe. É especialmente útil se:

    * Cada agente gerencia sua própria carteira.
    * Você precisa limitar o acesso por campanha ou segmento.
    * Você quer manter a confidencialidade das informações.

    ### Passo a passo para configurar a visibilidade de contatos

    <Steps>
      <Step title="Acesse a configuração de agentes">
        Vá para **Configuração > Agentes** no menu lateral da plataforma.
      </Step>

      <Step title="Selecione a opção de lista de contatos">
        Escolha como você quer que seus agentes visualizem a lista de contatos da empresa. Você pode escolher qualquer uma das seguintes opções:
      </Step>
    </Steps>

    <CardGroup cols={2}>
      <Card title="Opção 1: Lista completa de contatos" icon="users">
        Todos os agentes veem a base de contatos da conta, independentemente da propriedade no CRM.
        **Recomendado para equipes que trabalham colaborativamente na mesma carteira.**
      </Card>

      <Card title="Opção 2: Apenas contatos atribuídos" icon="user-check">
        Cada agente vê apenas os contatos que tem atribuídos.
        **Útil para operações segmentadas por agente, campanha ou região.**
      </Card>
    </CardGroup>

    <Steps>
      <Step title="E pronto!" stepNumber={3}>
        Uma vez que você selecione uma opção, todos os contatos serão atualizados.
      </Step>
    </Steps>

    <Tip>
      Lembre-se de que você pode ajustar esta configuração a qualquer momento para adaptá-la às mudanças na sua equipe ou estratégia.
    </Tip>
  </Tab>

  <Tab title="HSM">
    # Visibilidade de modelos HSM

    Aqui você pode definir quais equipes podem acessar e utilizar cada modelo HSM disponível na plataforma, ajudando a manter a organização e o controle sobre as mensagens que são enviadas.

    <img src="https://mintcdn.com/trebleai/N7qFKPzh9cWmkY9Y/images/Screenshot2025-05-21at7.18.23AM.png?fit=max&auto=format&n=N7qFKPzh9cWmkY9Y&q=85&s=f2dc0b5e3de57d93e384a484313ab87b" alt="Screenshot 2025-05-21 at 7.18.23 AM.png" width="2940" height="1660" data-path="images/Screenshot2025-05-21at7.18.23AM.png" />

    ### Por que é útil?

    Esta funcionalidade permite manter a operação organizada quando se trabalha com múltiplas equipes (vendas, suporte, cobrança, etc.). Atribuir permissões por equipe ajuda a:

    * Evitar o uso incorreto de modelos.
    * Mostrar apenas as mensagens relevantes para cada equipe.
    * Facilitar a administração e o controle de mensagens enviadas.

    <Note>
      Dica: Se você tem modelos duplicados ou em desuso, considere fazer uma limpeza antes de ajustar as permissões.
    </Note>

    ### Passo a passo para gerenciar a visibilidade de modelos

    <Steps>
      <Step title="Acesse a configuração de HSM">
        Vá para **Configuração > HSM** para ver todos os modelos disponíveis e modificar suas permissões de uso.

        **Na tabela de modelos você verá:**

        * **Modelo HSM:** Nome e fragmento da mensagem.
        * **Categoria:** Classificação atribuída (por exemplo, "Marketing" ou "Suporte").
        * **Permissões:** Equipes com acesso ao modelo.
        * **Data da última modificação:** Última vez que o modelo foi editado
      </Step>

      <Step title="Selecione as equipes que poderão usar o modelo">
        Clique na coluna **Permissões** do modelo que deseja modificar e marque ou desmarque as equipes conforme apropriado. Você também pode selecionar **Todas as equipes** para habilitar o uso global do modelo.
      </Step>

      <Step title="Salve as alterações">
        Uma vez que você tenha selecionado as equipes, clique em **Salvar alterações** para aplicar a configuração.
      </Step>
    </Steps>

    <Warning>
      Se um modelo aparece como "Nenhuma das equipes", não estará disponível para nenhum agente.
    </Warning>

    Assim você pode manter o controle sobre quais equipes podem usar cada modelo e evitar confusões na operação diária.
  </Tab>

  <Tab title="HubSpot">
    # Personalização de propriedades de contato do HubSpot (beta)

    Controle quais propriedades do HubSpot são exibidas no painel lateral do chat dos agentes, e defina se eles podem ou não editá-las.

    <img src="https://mintcdn.com/trebleai/N7qFKPzh9cWmkY9Y/images/Screenshot2025-05-21at7.08.03AM.png?fit=max&auto=format&n=N7qFKPzh9cWmkY9Y&q=85&s=6659ef33697ddf8e47297fe12e86f5d1" alt="Screenshot 2025-05-21 at 7.08.03 AM.png" width="2940" height="1664" data-path="images/Screenshot2025-05-21at7.08.03AM.png" />

    ### Por que é útil?

    Este painel foi projetado para oferecer **contexto rápido** sobre o contato e permitir **atualizar informações sem sair do chat**.

    É especialmente útil se:

    * Seus agentes precisam consultar dados-chave do CRM enquanto conversam.
    * Você quer manter as informações atualizadas sem abrir o HubSpot.
    * Você busca melhorar a eficiência operacional e a qualidade dos dados.

    <Note>
      Esta funcionalidade está em fase **beta**. Atualmente nem todas as propriedades são compatíveis.
    </Note>

    ### Passo a passo para personalizar o painel de contato

    <Steps>
      <Step title="Acesse a configuração do HubSpot">
        Vá para **Configuração > HubSpot** para personalizar quais propriedades serão exibidas no painel de contato.
      </Step>

      <Step title="Busque a propriedade que deseja exibir">
        Use o buscador para encontrar a propriedade específica que você quer adicionar ao painel.
      </Step>

      <Step title="Ative a propriedade">
        Marque a caixa correspondente para que a propriedade selecionada seja exibida no painel de contato.
      </Step>

      <Step title="Defina se a propriedade é editável">
        Use o switch na coluna "Propriedade editável?" para permitir ou não sua edição pelo agente.
      </Step>

      <Step title="Reordene as propriedades">
        Arraste e solte as propriedades na ordem que preferir. A visualização à direita mostrará como ficará no chat.
      </Step>

      <Step title="Salve as alterações">
        Uma vez que você tenha personalizado o painel ao seu gosto, certifique-se de salvar as alterações para que sejam aplicadas.
      </Step>
    </Steps>

    Esta personalização ajuda você a mostrar apenas as informações relevantes para seus agentes e manter o fluxo de trabalho ágil.

    <Warning>
      Algumas propriedades como as do tipo **data** não estão disponíveis. Se você não encontrar uma propriedade, provavelmente não está suportada pelo painel atual.
    </Warning>
  </Tab>

  <Tab title="Atribuição">
    # Configuração de atribuição de chats

    Defina como os chats são atribuídos aos agentes e quantas conversas eles podem gerenciar ao mesmo tempo.

    <img src="https://mintcdn.com/trebleai/N7qFKPzh9cWmkY9Y/images/Screenshot2025-05-21at1.19.31PM.png?fit=max&auto=format&n=N7qFKPzh9cWmkY9Y&q=85&s=64f6c084f603df112467a8ad38eb9c4e" alt="Screenshot 2025-05-21 at 1.19.31 PM.png" width="2874" height="1820" data-path="images/Screenshot2025-05-21at1.19.31PM.png" />

    ### Por que é útil?

    Uma configuração clara de atribuição:

    * Evita que os chats fiquem sem atendimento.
    * Reduz a sobrecarga nos agentes.
    * Alinha a operação com a lógica de atribuição definida no HubSpot (se aplicável).

    ### Configuração de atribuição: dois elementos-chave

    A atribuição de chats é composta por **dois elementos principais** que você pode configurar de acordo com as necessidades da sua operação:

    1. **Método de atribuição**
    2. **Máximo de chats por agente**

    A seguir explicamos cada elemento:

    ***

    #### 1. Método de atribuição

    **O que é?**\
    O método de atribuição define como se decide a qual agente é atribuído cada novo chat.

    **Existem dois métodos de atribuição de chats:** um método primário (disponível para clientes com integração do HubSpot ou Salesforce) e um método secundário (próprio do Treble).

    <Accordion title="Instruções se você é usuário do HubSpot ou Salesforce" icon="route">
      <Info>
        Você pode ativar ou desativar o método primário de acordo com suas necessidades; se desativá-lo, apenas o método secundário será usado para atribuir os chats.
      </Info>

      <img src="https://mintcdn.com/trebleai/N7qFKPzh9cWmkY9Y/images/Screenshot2025-05-26at1.37.59PM.png?fit=max&auto=format&n=N7qFKPzh9cWmkY9Y&q=85&s=59bb6ca51d70a092a4b06a9c2fb51dfe" alt="Screenshot 2025-05-26 at 1.37.59 PM.png" width="2940" height="1658" data-path="images/Screenshot2025-05-26at1.37.59PM.png" />

      #### Método primário (integração com HubSpot ou Salesforce)

      Se você tem integração, pode escolher que o chat seja automaticamente atribuído ao agente proprietário definido no seu CRM. Existem três formas de fazer isso e você pode escolhê-las clicando no botão **Alterar método**:

      <CardGroup cols={3}>
        <Card title="Atribuir imediatamente ao proprietário" icon="user-check">
          O chat é atribuído imediatamente ao agente proprietário, esteja ele conectado ou não. É a opção mais rápida e direta.
        </Card>

        <Card title="Aguardar um tempo limite" icon="clock">
          Aguarda-se um tempo definido para que o agente proprietário esteja disponível. Se não estiver, passado esse tempo aplica-se o método alternativo.
        </Card>

        <Card title="Apenas se estiver conectado" icon="user">
          O chat só é atribuído se o agente proprietário estiver conectado; se não, fica pendente até que se conecte.
        </Card>
      </CardGroup>

      #### O que acontece se o método primário não pode ser aplicado?

      Se o agente proprietário não estiver disponível (por exemplo, não está ativo, não existe, ou se supera o tempo de espera), o sistema pode deixar o chat na fila de espera ou passar automaticamente ao método secundário para assegurar que o chat seja atendido.

      #### Método secundário (fallback automático)

      Quando o método primário não é possível, o Treble busca um agente alternativo **filtrando os agentes disponíveis por tag e depois aplicando um dos seguintes algoritmos.**

      <CardGroup cols={2}>
        <Card title="Atribuir ao agente com menos chats" icon="users">
          O chat é atribuído ao agente disponível que tenha menos chats ativos naquele momento, ajudando a balancear a carga de trabalho. Apenas agentes com a tag correspondente são considerados.
        </Card>

        <Card title="Atribuir de forma aleatória" icon="shuffle">
          O chat é atribuído aleatoriamente entre os agentes disponíveis com a tag adequada, sempre respeitando as segmentações configuradas.
        </Card>
      </CardGroup>

      <Note>
        Quando não se encontra nenhum agente dentro da tag selecionada, o sistema buscará dentro da tag padrão da empresa.
      </Note>
    </Accordion>

    <Accordion title="Instruções se você não usa integrações" icon="xmark">
      Se você não usa nenhuma integração, encontrará disponível o método de atribuição do Treble. Para escolher a alternativa que melhor se adapta à sua operação, apenas clique no botão **Alterar método** e escolha uma opção.

      <img src="https://mintcdn.com/trebleai/N7qFKPzh9cWmkY9Y/images/Screenshot2025-05-26at1.36.46PM.png?fit=max&auto=format&n=N7qFKPzh9cWmkY9Y&q=85&s=7aba579e40c5cb58acb5666dfabfcb9c" alt="Screenshot 2025-05-26 at 1.36.46 PM.png" width="2936" height="1660" data-path="images/Screenshot2025-05-26at1.36.46PM.png" />

      Neste método de atribuição do Treble busca-se um agente disponível **filtrando-os por tag e depois aplicando um dos seguintes algoritmos.**

      <CardGroup cols={2}>
        <Card title="Atribuir ao agente com menos chats" icon="users">
          O chat é atribuído ao agente disponível que tenha menos chats ativos naquele momento, ajudando a balancear a carga de trabalho. Apenas agentes com a tag correspondente são considerados.
        </Card>

        <Card title="Atribuir de forma aleatória" icon="shuffle">
          O chat é atribuído aleatoriamente entre os agentes disponíveis com a tag adequada, sempre respeitando as segmentações configuradas.
        </Card>
      </CardGroup>

      <Note>
        Quando não se encontra nenhum agente dentro da tag selecionada, o sistema buscará dentro da tag padrão da empresa.
      </Note>
    </Accordion>

    Isso garante que nenhum chat fique sem atendimento, mesmo se o proprietário original não puder recebê-lo.

    ***

    #### 2. Máximo de chats por agente

    **O que é?**\
    Permite definir quantos chats cada agente pode gerenciar ao mesmo tempo.

    **Opções:**

    <CardGroup cols={2}>
      <Card title="Conversas sem limite" icon="infinity">
        Os agentes receberão todas as novas conversas que chegarem, sem restrição de quantidade.
      </Card>

      <Card title="Conversas limitadas" icon="user-minus">
        Você pode definir um número máximo de chats por agente, ideal para evitar sobrecarga e melhorar o atendimento.
      </Card>
    </CardGroup>

    Selecione a opção que melhor se adapta à sua operação e ajuste o número com os controles disponíveis.

    ***

    Se você configurar bem a atribuição, sua equipe poderá atender os chats de forma mais eficiente e equilibrada, assegurando que nenhum cliente fique sem resposta.

    ## Perguntas frequentes

    <AccordionGroup>
      <Accordion title="O que acontece se o agente proprietário no HubSpot não estiver disponível?">
        Depende do método escolhido. Pode-se aguardar um tempo, usar o método secundário, ou levá-lo a uma fila onde estará pendente de atribuição.
      </Accordion>

      <Accordion title="Como o Treble define qual agente tem menos chats?">
        Contam-se apenas os chats ativos em tempo real, respeitando as tags configuradas.
      </Accordion>

      <Accordion title="Posso usar estes métodos sem o HubSpot?">
        Sim. O método secundário está disponível para todas as contas.
      </Accordion>

      <Accordion title="Podem ser atribuídos chats a agentes offline?">
        Sim, se você escolher o método "atribuir imediatamente" ou "atribuir mesmo que não esteja conectado".
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>
