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

# Bloco Objeto CRM

> Leia uma propriedade de um contato, negócio, empresa ou ticket do HubSpot e salve-a em uma variável para usá-la dentro da conversa.

# Objeto CRM

O bloco **Objeto CRM** faz o contrário do bloco de Ação no CRM: em vez de escrever no HubSpot, ele **lê** um dado do HubSpot e o salva em uma variável do Treble. A partir daí, você pode usá-lo em qualquer parte da conversa.

Com isso você pode, por exemplo, cumprimentar o cliente mencionando o valor da sua última cotação, ou enviá-lo por um caminho diferente conforme o estágio em que o negócio dele está.

<Info>
  No menu de blocos, este bloco aparece como **Atribuir variáveis**, com a descrição "Associa objetos a partir de contatos". Uma vez que você o adiciona à conversa, o bloco se chama **Objeto CRM**. São o mesmo bloco.
</Info>

<Info>
  As propriedades do **contato** já estão disponíveis automaticamente como variáveis `hubspot_...` em toda a conversa. Este bloco é sobretudo útil para ler propriedades de **negócios, empresas e tickets**, que não são carregadas sozinhas. Confira <a class="article-link" href="/pt/docs/integrations/hubspot/features/variables"><p>Variáveis do HubSpot no Treble</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>
</Info>

## Adicione o bloco à sua conversa

1. Faça login em <a class="article-link" href="https://app.treble.ai"><p>app.treble.ai</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>
2. Vá para **Criar Conversa**
3. Clique no botão <Icon icon="square-plus" iconType="solid" /> para exibir o menu de blocos
4. Procure o bloco **Atribuir variáveis** e clique nele para adicioná-lo
5. Conecte-o no ponto do fluxo onde você precisa do dado, **antes** do bloco que vai usá-lo
6. Clique duas vezes no bloco para abrir sua configuração

<Warning>
  O bloco tem que vir **antes** do bloco onde você usa a variável. Se você o colocar depois, a variável estará vazia quando a mensagem for enviada.
</Warning>

<div class="hr" />

## Configure o bloco

<img src="https://mintcdn.com/trebleai/dcOwRe0FLklqGTic/images/hubspot-objeto-crm-configuracion.png?fit=max&auto=format&n=dcOwRe0FLklqGTic&q=85&s=1c88b812d1d967cb219a7d5e3b62284a" alt="Configuração do bloco Objeto CRM com objeto, hierarquia, propriedade e nome da variável" width="2386" height="1358" data-path="images/hubspot-objeto-crm-configuracion.png" />

### 1. Selecione um objeto e sua hierarquia

Assim como no bloco de Ação no CRM, você escolhe de qual objeto quer ler: **contato, negócio, empresa ou ticket**.

Se você escolher algo diferente do contato, precisa dizer ao Treble **qual** dos objetos associados usar, por meio da hierarquia:

| Opção               | O que faz                                                               |
| ------------------- | ----------------------------------------------------------------------- |
| **Primeiro criado** | O mais antigo dos associados ao contato                                 |
| **Último criado**   | O mais recente dos associados ao contato                                |
| **Personalizado**   | Aquele cuja propriedade seja exatamente igual ao valor que você indicar |

A hierarquia funciona exatamente igual à do bloco de Ação no CRM, incluindo o diagrama de comportamento. Se você tiver dúvidas sobre qual escolher, confira <a class="article-link" href="/pt/docs/integrations/hubspot/blocks/crm-action"><p>Bloco de Ação no CRM</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>

### 2. Defina a propriedade que será colocada na conversa

Selecione a propriedade do objeto cujo valor você quer trazer para a conversa. Por exemplo, `Amount` para o valor de um negócio, `Estágio do negócio`, ou a prioridade de um ticket.

### 3. Dê um nome à variável

Em **Nome da variável** você escreve como o dado vai se chamar dentro do Treble. Esse é o nome que você vai usar entre chaves mais adiante.

Por exemplo, se você colocar `quantia`, nos blocos seguintes poderá escrever `{{quantia}}`.

<Tip>
  Use nomes em minúsculas e sem espaços ou acentos, como `valor_cotacao` ou `prioridade_ticket`. Assim são mais fáceis de lembrar e de escrever.
</Tip>

<div class="hr" />

## Como o bloco aparece na sua conversa

Uma vez configurado, o bloco mostra um resumo do que faz diretamente no canvas: o objeto, a hierarquia, a propriedade que lê e a variável onde a salva.

<img src="https://mintcdn.com/trebleai/dcOwRe0FLklqGTic/images/hubspot-objeto-crm-nodo.png?fit=max&auto=format&n=dcOwRe0FLklqGTic&q=85&s=2a38016775bbabf6b678bd59efc6bba3" alt="Bloco Objeto CRM no canvas mostrando objeto, hierarquia, propriedade e a variável resultante" width="1074" height="892" data-path="images/hubspot-objeto-crm-nodo.png" />

A variável aparece já escrita entre chaves, pronta para usar. Clique no ícone de copiar que está à sua direita e cole-a no bloco onde precisar dela. Assim você evita erros de escrita.

<div class="hr" />

## O que você pode fazer com a variável

Uma vez salva, a variável se comporta como qualquer outra variável do Treble:

* **Mostrá-la em uma mensagem:** "Sua cotação de `{{quantia}}` continua válida."
* **Avaliá-la em um bloco condicional:** enviar o cliente por um caminho ou outro conforme o estágio do negócio dele. Confira <a class="article-link" href="/pt/docs/integrations/hubspot/blocks/conditional"><p>Bloco Condicional</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>
* **Reutilizá-la em um bloco de Ação no CRM:** ler um dado de um objeto e escrevê-lo em outro.
* **Passá-la para um agente de IA** como contexto da conversa.

<div class="hr" />

## Casos de uso

### Retomar uma cotação sem perguntar sobre ela

Você lê o valor e o estágio do **último negócio criado** do contato, e abre a conversa com esses dados. O cliente sente que você está falando do caso dele, não de um modelo.

### Rotear o suporte conforme a prioridade do ticket

Você lê a prioridade do ticket associado ao contato e, com um bloco condicional, envia os casos de prioridade alta direto para um agente humano e os demais para o agente de IA.

### Personalizar a oferta conforme a empresa

Você lê o tamanho ou o setor da **empresa** associada ao contato e usa essa informação para decidir qual plano mostrar a ele.

<div class="hr" />

## Se algo não funcionar

### A variável chega vazia

1. **O contato tem esse objeto associado?** Se o contato não tem nenhum negócio associado no HubSpot, não há nada para ler.
2. **A hierarquia deixou tudo de fora?** Com "Personalizado", se nenhum objeto cumprir a condição exata, a variável fica vazia.
3. **O bloco está antes do que usa a variável?** É a causa mais comum.
4. **A propriedade tem valor no HubSpot?** Abra-a no HubSpot e confirme.

### Escrevi errado o nome da variável

Use o botão de copiar do bloco no canvas em vez de escrevê-la à mão. Copie exatamente o nome, com as chaves incluídas.

### Não encontro a propriedade que quero ler

Atualize as propriedades com o botão de sincronizar. Confira <a class="article-link" href="/pt/docs/integrations/hubspot/features/properties"><p>Propriedades do HubSpot no Treble</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a>
