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

# Configurações de atributos de contato

Os atributos de contato são usados para armazenar informações básicas, origem, tags e status de interação de um contato. Com os atributos de contato, você pode visualizar informações de clientes na lista e nos detalhes do contato, além de usar atributos para filtragem, segmentação e ações de acompanhamento.

Os atributos de contato incluem **atributos do sistema** e **atributos personalizados**:

* Atributos do sistema: gerados ou atualizados automaticamente pela YCloud, como apelido, número de telefone, origem, data de criação e data do último contato.
* Atributos personalizados: criados por membros da equipe com base nas necessidades do negócio, como nível de cliente, intenção de compra, localização da loja ou tipo de negócio.

### Atributos comuns do sistema

Os atributos comuns de contato incluem:

<table><thead><tr><th width="153.89453125">Atributo</th><th>Descrição</th></tr></thead><tbody><tr><td>Apelido</td><td>O apelido original do contato, geralmente sincronizado a partir das informações de perfil do WhatsApp.</td></tr><tr><td>Número de telefone</td><td>O número de telefone principal do contato, geralmente sincronizado do WhatsApp ou inserido manualmente.</td></tr><tr><td>E-mail</td><td>O endereço de e-mail do contato.</td></tr><tr><td>País / Região</td><td>O país ou região associado ao contato, geralmente identificado com base no número de telefone ou informações de perfil.</td></tr><tr><td>Origem</td><td>A origem do contato, usada para indicar se o contato veio de uma mensagem, link, importação, API, anúncio ou outro ponto de entrada.</td></tr><tr><td>ID de origem</td><td>O identificador exclusivo da origem do contato, normalmente usado para registrar a origem original do anúncio ou do canal.</td></tr><tr><td>URL de origem</td><td>A URL original associada à origem do contato, como um anúncio, campanha ou link de entrada.</td></tr><tr><td>Tag</td><td>Tags atribuídas ao contato para classificação, filtragem e ações de acompanhamento.</td></tr><tr><td>Responsável</td><td>O endereço de e-mail do membro da equipe responsável por gerenciar o contato.</td></tr><tr><td>Data de criação</td><td>A data e hora em que o contato foi criado pela primeira vez no sistema.</td></tr><tr><td>Último contato</td><td>A data e hora mais recente em que ocorreu uma interação com este contato.</td></tr><tr><td>Último número conectado</td><td>O número do WhatsApp Business ou número do canal usado mais recentemente para se comunicar com este contato.</td></tr></tbody></table>

<Info>
  Atributos marcados como Sistema são atributos do sistema. Eles são normalmente gerados ou atualizados automaticamente pela YCloud com base em informações de contato, origem, conversas, importações ou dados de integração.
</Info>

#### Origem

Origem, também conhecida como Origem do contato, é um dos atributos do sistema mais comumente usados para contatos. Ela indica onde o contato entrou pela primeira vez na YCloud e pode ser usada para identificar canais de aquisição, analisar o desempenho de anúncios ou filtrar contatos de diferentes pontos de entrada.

A origem pode incluir os seguintes valores enum:

<table><thead><tr><th width="154.671875">Origem</th><th>Descrição</th></tr></thead><tbody><tr><td>Mensagem recebida</td><td>O contato se conectou com seu número do WhatsApp enviando uma mensagem recebida.</td></tr><tr><td>Link / Código QR</td><td>O contato se conectou com seu número do WhatsApp por meio de um link ou código QR.</td></tr><tr><td>Adicionado manualmente</td><td>O contato foi adicionado manualmente por um membro da equipe.</td></tr><tr><td>Importação de arquivo</td><td>O contato foi adicionado por meio de importação de arquivo.</td></tr><tr><td>Shopify</td><td>O contato foi sincronizado da sua loja Shopify para a YCloud por meio da <a href="/pt/documentation/integrations/e-commerce/shopify/confirm-cod-orders">integração com a Shopify</a>.</td></tr><tr><td>Adicionado via API</td><td>O contato se conectou com seu número do WhatsApp por meio da <a href="/api-reference/contacts/create-a-contact">API da YCloud</a>.</td></tr><tr><td>Anúncio</td><td>O contato se conectou com seu número do WhatsApp por meio do tráfego de anúncios Click-to-WhatsApp da Meta. Saiba mais sobre <a href="/pt/documentation/ctwa-click-to-whatsapp-ad/ctwa-introduction">Anúncios CTWA da Meta</a>.</td></tr><tr><td>Anúncio do TikTok</td><td>O contato se conectou com seu número do WhatsApp por meio de Anúncios de Mensagens do TikTok. Saiba mais sobre <a href="/pt/documentation/ctwa-click-to-whatsapp-ad/tiktok-messaging-ad/index">Anúncios de Mensagens do TikTok</a>.</td></tr><tr><td>Publicação</td><td>O contato se conectou com seu número do WhatsApp por meio de publicações no Facebook ou pontos de entrada semelhantes.</td></tr><tr><td>Chamadas</td><td>O contato se conectou com seu número do WhatsApp por meio de Chamadas do WhatsApp.</td></tr><tr><td>WhatsApp Business App</td><td>O contato se conectou com seu número do WhatsApp por meio do WhatsApp Business App.</td></tr><tr><td>Desconhecido</td><td>O sistema não consegue identificar como o contato se conectou com seu número do WhatsApp, ou a origem não foi registrada nos dados históricos.</td></tr></tbody></table>

Por exemplo, se você quiser visualizar contatos gerados por anúncios do TikTok, pode filtrar por "TikTok AD". Se quiser visualizar contatos sincronizados ou criados por meio da Shopify, pode filtrar por "Shopify".

<Frame caption="Filter contacts by Source. This example selects Tiktok AD; the demo account has no matching contacts.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/contact-source-filter-context.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=310821a3f082afaf2e0d735ffe6cf920" alt="Lista completa de Contatos com o filtro Origem aberto e TikTok AD selecionado." width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/contact-source-filter-context.png" />
</Frame>

### Adicionar um Atributo Personalizado

Se os atributos do sistema não atenderem às suas necessidades de gerenciamento de negócios, você poderá adicionar atributos personalizados.

1. Faça login na sua [conta da YCloud](https://www.ycloud.com).
2. Acesse **Configurações > Contato > Atributos**.
3. Clique em **Adicionar Atributo**.&#x20;

<Frame caption="Define the attribute name, unique key, description, and format, then select Add.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/contact-attribute-create-context.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=2b032fef30edb623352472e60627b6d8" alt="Página completa de Atributos em Configurações atrás do formulário Adicionar um novo atributo." width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/contact-attribute-create-context.png" />
</Frame>

4. Insira o **Nome** do atributo e uma **Chave** exclusiva. Opcionalmente, adicione uma **Descrição** e, em seguida, selecione um **Formato**.
5. Clique em **Adicionar** para finalizar.

<Frame caption="The saved attribute appears in the list with its format and description.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/contact-attribute-list-context.png?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=2eb89f36e37f32096cf1a8ae713ed3fc" alt="O atributo personalizado de Texto salvo na página completa de Atributos em Configurações." width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/contact-attribute-list-context.png" />
</Frame>

### Editar ou Excluir um Atributo

Depois que um atributo for adicionado com sucesso, você poderá visualizá-lo na página **Configurações > Contato > Atributos** . Você também pode editá-lo ou excluí-lo conforme necessário.

<Frame caption="Use the pencil icon to edit an attribute, or open its actions menu to find Delete.">
  <img src="https://mintcdn.com/lchnan/rmZYWVwRdpR7TJaI/product-assets/english-help-context-2026-09-23/contact-attribute-actions-context-annotated.svg?fit=max&auto=format&n=rmZYWVwRdpR7TJaI&q=85&s=c13d5a0d2ac467de5271c48d0d07a511" alt="Linha do atributo com o ícone de edição e o menu Excluir aberto." width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-23/contact-attribute-actions-context-annotated.svg" />
</Frame>

Antes de editar ou excluir um atributo, verifique se ele está sendo usado em filtros de contatos, segmentos, fluxos de trabalho de automação ou outros cenários operacionais, para evitar impactos nos fluxos de gerenciamento de contatos existentes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.