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

# Contacts

> Visão geral do gerenciamento de contatos e CRM — perfis, tags, segmentação, importação e avatares.

A página Contacts é o CRM leve do Switchbord: todo contato do WhatsApp com quem seu workspace já troca mensagens (ou que foi importado) recebe um registro persistente com nome de exibição, número de telefone, tags e quaisquer campos personalizados que seu workspace acompanhe. É um estado apenas de avanço e de acréscimo amigável — o histórico do contato não é reescrito, ele se acumula.

## O registro do contato

Cada contato carrega:

<CardGroup cols={2}>
  <Card title="Identidade" icon="id-card">
    Nome de exibição e número de telefone em formato E.164 — os dois campos obrigatórios para qualquer contato, seja ele criado manualmente, via API, ou por importação de CSV.
  </Card>

  <Card title="Tags" icon="tag">
    Rótulos de segmentação livres (`vip`, `newsletter`, `2026-winter`). As tags são o elemento compartilhado entre Inbox, Contacts e Campaigns — marque um contato com uma tag uma vez e ela poderá ser usada como filtro de audiência em qualquer lugar.
  </Card>

  <Card title="Avatar" icon="circle-user">
    Um fallback baseado em iniciais por padrão, ou uma foto enviada pelo operador. Veja [Avatares de contato](/pt-BR/features/contact-avatars) para entender por que o próprio WhatsApp nunca fornece um.
  </Card>

  <Card title="Estado de consentimento" icon="shield-check">
    Status de opt-out de marketing, definido automaticamente quando um contato responde `STOP` (ou um equivalente localizado) a um template de marketing — excluído por padrão de futuras audiências de campanha.
  </Card>
</CardGroup>

## Encontrando e filtrando contatos

A lista de Contacts suporta pesquisa e filtragem por tag e outros atributos, apoiada em consultas do lado do servidor, para escalar bem além da primeira página de resultados. A partir de uma conversa aberta no [Inbox](/pt-BR/features/inbox), o mesmo registro de contato é visível na barra lateral — atualizações feitas em qualquer uma das duas telas são refletidas imediatamente na outra.

## Criando contatos

Os contatos são criados de três formas:

1. **Automaticamente** — na primeira vez que alguém envia uma mensagem para o seu número de WhatsApp.
2. **Manualmente** — adicione um único contato por nome, telefone e tags diretamente pela página Contacts.
3. **Importação em massa** — faça upload de um CSV de contatos em uma única operação. Veja [Importação de contatos via CSV](/pt-BR/features/contacts-import) para o formato exato de colunas, regras de normalização de telefone e solução de problemas.

## Segmentação para campanhas e jornadas

As tags (e qualquer critério de filtro combinado) definidas aqui se tornam a definição de audiência para [Campaigns](/pt-BR/features/campaigns) e condições de entrada para [Journeys](/pt-BR/features/journeys). Não há um modelo de dados de "audiência" separado — uma audiência de campanha é simplesmente uma consulta de contatos.

## Margaret e contatos

A [Margaret](/pt-BR/features/margaret) tem acesso direto aos dados de contato, condicionado a aprovação: ela pode encontrar um contato por nome, telefone ou e-mail, exibir conversas recentes e tags, e — com sua aprovação — atualizar campos ou adicionar/remover tags para segmentação. Peça a ela "encontre contatos marcados com a tag `vip` que não têm mensagens recebidas nos últimos 60 dias" em vez de montar o filtro manualmente.

## Veja também

* [Importação de contatos via CSV](/pt-BR/features/contacts-import) — formato de importação em massa, limites e solução de problemas.
* [Avatares de contato](/pt-BR/features/contact-avatars) — como as fotos de perfil são renderizadas e enviadas.
* [Campaigns](/pt-BR/features/campaigns) — usando tags como audiência de disparo.
* [Modelo de dados](/pt-BR/platform/data-model#plano-de-canal-e-contato) — as tabelas subjacentes `contacts`, `tags` e `contact_tag_links`.