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

# Contatos

> O Treble inclui um CRM leve integrado que centraliza todos os seus contatos do WhatsApp em um só lugar. Aprenda a gerenciar contatos, propriedades personalizadas, listas e ações em massa.

## O que é a seção de Contatos?

A seção de **Contatos** é o CRM leve do Treble. Aqui são centralizados automaticamente todos os números do WhatsApp com os quais sua empresa interagiu: qualquer usuário que receba uma conversa outbound ou que inicie uma conversa inbound fica registrado como contato sem nenhuma ação manual da sua parte.

Desta seção você pode:

* Ver e buscar todos os seus contatos em um só lugar.
* Criar **propriedades personalizadas** (texto, número ou data) para enriquecer os perfis.
* Organizar contatos em **listas** para segmentá-los.
* Aplicar **filtros** para encontrar exatamente o segmento que você precisa.
* Executar **ações em massa**: enviar conversas, adicionar ou remover de listas, ou excluir contatos.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-all-platform.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=ccf1010c134fa1c479c55b163f7a93a5" alt="Visão geral de Contatos no Treble" width="2348" height="1354" data-path="images/light-crm-all-platform.png" />

Na parte superior da seção você encontrará três métricas principais:

* **Total de Contatos**: o número total de contatos registrados na sua conta.
* **Contatos opt-out**: contatos que solicitaram não receber mais mensagens.
* **Novos Contatos (último mês)**: contatos criados nos últimos 30 dias, útil para medir o crescimento da sua base.

***

## Adicionar um contato

Você pode adicionar contatos de duas formas: um a um ou carregando um arquivo CSV. Clique no botão **Adicionar contato** no canto superior direito para acessar as duas opções.

### Adicionar um a um

Preencha o formulário com os dados do contato:

* **Nome Completo**: nome do contato.
* **Email**: endereço de e-mail.
* **Número de Telefone**: selecione o código do país e insira o número.
* **Propriedades adicionais**: qualquer propriedade personalizada que você tenha criado aparecerá aqui como campo adicional (por exemplo, CRM, saldo, Company URL, idade).

<img src="https://mintcdn.com/trebleai/DBZoHVPBew9UGNKw/images/light-crm-add-contacts-onebyone.png?fit=max&auto=format&n=DBZoHVPBew9UGNKw&q=85&s=8211d82df5da9d6830dfcd8aec66b241" alt="Adicionar um contato manualmente" width="2340" height="1350" data-path="images/light-crm-add-contacts-onebyone.png" />

### Adicionar por CSV

Se você precisar carregar múltiplos contatos de uma vez, use a aba **Lista de contatos** dentro do mesmo modal e clique em **Enviar arquivo**.

O arquivo CSV deve conter as colunas obrigatórias. As colunas obrigatórias são `country_code` e `cellphone`. As colunas opcionais incluem `name`, `email`, e qualquer propriedade personalizada que você tenha criado (por exemplo, `saldo`, `Company URL`, `idade`, ou o nome de uma lista como `Leads Maio`).

<img src="https://mintcdn.com/trebleai/DBZoHVPBew9UGNKw/images/light-crm-add-contancs-csv.png?fit=max&auto=format&n=DBZoHVPBew9UGNKw&q=85&s=0964c7e0f6e83e5a913e83e530354daf" alt="Adicionar contatos por CSV" width="2342" height="1350" data-path="images/light-crm-add-contancs-csv.png" />

<Tip>
  Baixe o arquivo de exemplo do modal para garantir que seu CSV tenha o formato correto antes de enviá-lo.
</Tip>

<Warning>
  Os nomes das colunas do CSV devem coincidir exatamente com os nomes internos das suas propriedades personalizadas. Se não coincidirem, o campo não será importado.
</Warning>

***

## Propriedades personalizadas

As propriedades personalizadas permitem armazenar informações adicionais em cada contato além dos campos base (nome, telefone, e-mail). Você pode criar propriedades de três tipos: **Texto**, **Número** ou **Data**.

Para criar uma propriedade, clique no botão **Propriedades** na barra de ferramentas e depois em **Criar nova propriedade**.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-create-property-0.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=9ad6187ee42fba21073ec1faa18eaddf" alt="Menu de propriedades personalizadas" width="2346" height="1354" data-path="images/light-crm-create-property-0.png" />

Atribua um nome descritivo à propriedade e selecione seu tipo:

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-create-property-1.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=a8c60c4c4d6419bf3e9e041c8cb6a7b0" alt="Criar propriedade - nome e tipo" width="2342" height="1352" data-path="images/light-crm-create-property-1.png" />

Os tipos disponíveis são:

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-create-property-2.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=613486b5fddd0e93c23dcb94294b7472" alt="Tipos de propriedade: Texto, Número, Data" width="2344" height="1354" data-path="images/light-crm-create-property-2.png" />

| Tipo       | Descrição                                                                                    |
| ---------- | -------------------------------------------------------------------------------------------- |
| **Texto**  | Armazena qualquer cadeia de texto livre. Ideal para campos como empresa, categoria ou notas. |
| **Número** | Armazena valores numéricos. Ideal para saldos, scores ou quantidades.                        |
| **Data**   | Armazena datas. Ideal para datas de última compra, renovação ou vencimento.                  |

Uma vez criada, a propriedade aparece como coluna na tabela de contatos e como campo disponível ao adicionar ou editar contatos, ao carregar CSVs e ao usar variáveis no editor de conversas.

Para ver e gerenciar todas as suas propriedades, clique em **Propriedades → Ver propriedades personalizadas**.

***

## Listas de contatos

As listas permitem segmentar seus contatos em grupos com nome para filtrá-los e enviar conversas de forma direcionada.

Para criar uma lista, clique no botão **Listas** na barra de ferramentas, escreva o nome da nova lista e clique em **Criar lista**.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-create-list.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=c1e93d01c70a8c40812c3372a874fd95" alt="Criar uma lista de contatos" width="2342" height="1350" data-path="images/light-crm-create-list.png" />

As listas que você criar aparecerão:

* Como coluna na tabela de contatos, mostrando a quais listas cada contato pertence.
* Como filtro disponível no painel de **Filtros**.
* Como opção ao executar ações em massa de **Adicionar à lista** ou **Remover da lista**.

***

## Barra de ferramentas

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-toolbar-actions.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=009e885cb85db6e412d22909edcef336" alt="Barra de ferramentas de Contatos" width="2340" height="1352" data-path="images/light-crm-toolbar-actions.png" />

A barra de ferramentas, localizada no canto superior direito da tabela, contém as seguintes ações:

| Ação                                                         | Descrição                                                         |
| ------------------------------------------------------------ | ----------------------------------------------------------------- |
| <Icon icon="magnifying-glass" iconType="solid" /> **Buscar** | Busca contatos por nome ou número de telefone.                    |
| <Icon icon="download" iconType="solid" /> **Exportar**       | Baixa a lista de contatos filtrados em formato CSV.               |
| **Propriedades**                                             | Cria novas propriedades personalizadas ou consulta as existentes. |
| **Listas**                                                   | Cria novas listas de segmentação.                                 |
| **Adicionar contato**                                        | Abre o modal para adicionar um contato manualmente ou por CSV.    |

***

## Filtros

O painel de filtros permite reduzir a visualização de contatos ao exatamente o segmento que você precisa trabalhar. Clique no botão **Filtros** para abri-lo.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-filters.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=cb904b969cb1ac12211cd30bc59538b0" alt="Painel de filtros de Contatos" width="1058" height="894" data-path="images/light-crm-filters.png" />

Os filtros disponíveis são:

| Filtro                 | Opções                                                                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Intervalo de datas** | Hoje, Ontem, Últimos 7 dias, Últimas 2 semanas, Último mês, Últimos 3 meses, Último ano. Filtra por data de criação do contato. |
| **Status**             | Todos os contatos, Opt-Out, Opt-In.                                                                                             |
| **Listas**             | Mostra apenas os contatos que pertencem a uma ou mais listas selecionadas.                                                      |
| **País**               | Filtra pelo código de país do número de telefone.                                                                               |

Uma vez configurados os filtros, clique em **Aplicar filtros**. A tabela será atualizada e o cabeçalho mostrará um link **Selecionar \[N] contatos filtrados** que permite selecionar todos os contatos que atendem aos critérios, independentemente da página.

***

## Ações em massa

Com um ou mais contatos selecionados, uma barra aparece na parte inferior da tela com as ações em massa disponíveis.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-bulk-actions.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=144e104c5c54c19158c8555bf17b91bd" alt="Barra de ações em massa" width="2338" height="1352" data-path="images/light-crm-bulk-actions.png" />

Você pode selecionar contatos de três formas:

* **Individualmente**: marque a caixa ao lado de cada contato.
* **Página atual**: marque a caixa do cabeçalho para selecionar todos os contatos da página visível.
* **Todos os filtrados**: clique no link **Selecionar \[N] contatos filtrados** na barra superior para selecionar todos que passarem pelos filtros ativos, mesmo que sejam milhares.

As ações disponíveis são:

### 🗑 Excluir

Exclui permanentemente os contatos selecionados da sua conta.

### ➕ Adicionar à lista

Adiciona os contatos selecionados a uma lista existente. Ao clicar, aparece um campo de busca com suas listas disponíveis. Selecione a lista de destino e clique em **Adicionar**.

<img src="https://mintcdn.com/trebleai/DBZoHVPBew9UGNKw/images/light-crm-add-to-list.png?fit=max&auto=format&n=DBZoHVPBew9UGNKw&q=85&s=326a7a956bc02efe9bdc74df095e9ba8" alt="Adicionar contatos selecionados a uma lista" width="2344" height="1356" data-path="images/light-crm-add-to-list.png" />

### — Remover da lista

Remove os contatos selecionados de uma lista. Útil para limpar segmentos sem excluir os contatos da sua base.

### 📤 Enviar conversa

Envia uma conversa do Treble para os contatos selecionados diretamente da seção de Contatos. Ao clicar, abre-se um campo de busca de conversas para que você escolha qual enviar.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-send-conversation.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=4a2ff3fe969c35e77fcf1d93632c149c" alt="Selecionar conversa para envio em massa" width="2344" height="1352" data-path="images/light-crm-send-conversation.png" />

#### Vincular propriedades

Se a conversa selecionada contiver variáveis (por exemplo, `{{name}}` ou `{{company}}`), o Treble verificará automaticamente se essas variáveis coincidem com as propriedades dos seus contatos. Se houver variáveis que não coincidam, o modal **Vincular propriedades** será exibido.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-send-conversation-map-columns.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=b9733be2ca4fbcd7fec806465c9f29ad" alt="Vincular propriedades da conversa com as do contato" width="2338" height="1348" data-path="images/light-crm-send-conversation-map-columns.png" />

Neste modal você pode mapear manualmente cada variável da conversa com a propriedade do contato que deve ser usada como valor. Por exemplo, a variável `name` da conversa pode ser mapeada para a propriedade `name` do contato.

<img src="https://mintcdn.com/trebleai/DYg-VqTiN7vRC2Sn/images/light-crm-send-conversation-map-columns-2.png?fit=max&auto=format&n=DYg-VqTiN7vRC2Sn&q=85&s=07940d6de18882e615944156ca5eb599" alt="Selecionar propriedade do contato para vincular" width="2340" height="1352" data-path="images/light-crm-send-conversation-map-columns-2.png" />

As propriedades disponíveis para vincular incluem os campos base do contato (Email, WhatsApp Id, name, etc.) e todas as propriedades personalizadas que você criou.

<Tip>
  Se a variável da sua conversa tiver exatamente o mesmo nome que a propriedade do contato, o Treble a vinculará automaticamente sem necessidade de fazê-lo manualmente.
</Tip>

Se uma propriedade que você precisa vincular não aparecer na lista, use o link **Não encontro a propriedade que preciso** para criá-la antes de continuar.

***

## Variáveis de Contatos no editor de conversas

As propriedades dos seus contatos no Treble podem ser usadas como variáveis diretamente dentro do editor de conversas, da mesma forma que as <a class="article-link" href="/pt/docs/integrations/hubspot/features/variables"><p>variáveis do HubSpot</p><Icon icon="arrow-up-right-from-square" iconType="solid" /></a> são usadas.

Isso significa que você pode:

* **Ler** uma propriedade do contato dentro de uma mensagem. Por exemplo, cumprimentar o cliente pelo nome usando a propriedade `name`.
* **Escrever** a resposta do cliente em uma propriedade do contato. Por exemplo, capturar o e-mail fornecido e salvá-lo na propriedade `email`.

As variáveis de Contatos têm um formato especial de acordo com o tipo de propriedade:

* **Propriedades padrão** (nome e e-mail): usam o prefixo `trbcontact_d_`.
* **Propriedades personalizadas**: usam o prefixo `trbcontact_c_` seguido do nome interno da propriedade.

| Propriedade                  | Variável                        |
| ---------------------------- | ------------------------------- |
| Nome (padrão)                | `{{trbcontact_d_name}}`         |
| E-mail (padrão)              | `{{trbcontact_d_email}}`        |
| Source (personalizada)       | `{{trbcontact_c_source}}`       |
| Idade (personalizada)        | `{{trbcontact_c_edad}}`         |
| Departamento (personalizada) | `{{trbcontact_c_departamento}}` |
| Site (personalizada)         | `{{trbcontact_c_sitio_web}}`    |

<Tip>
  O nome interno de uma propriedade personalizada é o que você atribuiu ao criá-la. Se não lembrar o nome exato, consulte em **Propriedades → Ver propriedades personalizadas**.
</Tip>

Assim como com as variáveis do HubSpot, para salvar a resposta de um cliente em uma propriedade do contato você deve dar um duplo clique no bloco correspondente no editor, selecionar **Salvar resposta como variável** e escrever o nome da variável do contato (por exemplo, `trbcontact_c_edad`) no campo de nome da variável.