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

# Introdução

> Cadastre pessoas uma vez e use no painel e na API: tags, tópicos, segmentos e campanhas.

<Tip>
  **Contato** é a **pessoa** na base. Tag, tópico, segmento e campanha são formas de **organizar** ou **disparar** em cima dela, não são a mesma coisa.
</Tip>

## O que é Contatos na Notifique?

É a **base de pessoas** do workspace: nome, telefone, e-mail, etiquetas, campos extras e preferências de marketing. Você cadastra **uma vez** e reutiliza em templates, campanhas, segmentos e envios por API.

Você pode:

* **Criar e importar** contatos (telefone e/ou e-mail obrigatório)
* **Etiquetar** com tags reutilizáveis (`Lead`, `VIP`)
* **Registrar consentimento** por tema com **tópicos** (Newsletter, Promoções)
* **Montar públicos** com **segmentos** (regras salvas com AND/OR)
* **Disparar em lote** com **campanhas** (template + canais + audiência)

Pense numa **ficha de cliente** na gaveta: sem ela, cada envio vira planilha solta e você nunca sabe se aquele WhatsApp é o mesmo e-mail.

## Onde fica no painel

| Menu                     | O que é                                                  |
| ------------------------ | -------------------------------------------------------- |
| **Contacts**             | Ficha da pessoa, tags, campos personalizados, importação |
| **Audience → Topics**    | Temas de marketing e consentimento                       |
| **Audience → Segments**  | Públicos por regra (filtro salvo)                        |
| **Audience → Campaigns** | Disparo em lote (template + canais + quem recebe)        |

## Não confunda: mapa dos conceitos

Use esta tabela quando estiver em dúvida:

| Conceito                | Analogia rápida                          | O que faz                                                           |
| ----------------------- | ---------------------------------------- | ------------------------------------------------------------------- |
| **Contato**             | A ficha da pessoa                        | Guarda telefone, e-mail, nome, tags, campos                         |
| **Tag**                 | Etiqueta colada na ficha                 | Marca manual (`Lead`, `Cliente`), não é consentimento legal sozinha |
| **Campo personalizado** | Linha extra na ficha (`cidade`, `plano`) | Filtro em segmentos e `{{variável}}` em templates                   |
| **Tópico**              | Assunto que a pessoa aceita receber      | Consentimento por tema (Newsletter ≠ Promoções)                     |
| **Segmento**            | Busca salva no arquivo                   | “Quem tem tag X **e** aceita marketing **e** está no tópico Y”      |
| **Campanha**            | Carimbar e soltar na caixa               | Template + canais + público → **Run** enfileira envios              |

**Ordem mental:** contato → (tag/campo) → tópico → segmento → campanha.

<Info>
  **Segmento** responde “**quem** entra?”. **Campanha** responde “**o quê**, **por onde** e **quando** disparar?”. **Tópico** responde “essa pessoa **aceita este tipo** de marketing?”.
</Info>

## Quando usar?

Funciona muito bem para **campanhas**, **CRM integrado**, **personalização** com nome do cliente e **compliance** de marketing por tópico. Para **um SMS único** a um número que não vai repetir, pode mandar direto na API do canal sem cadastrar contato.

## Como funciona na prática

1. **Cadastre** contatos (painel ou API), telefone e/ou e-mail, únicos no workspace
2. **Organize** com tags, campos personalizados e tópicos
3. **Monte segmentos** com regras (preview antes de disparar)
4. **Crie campanhas** ligando template, canais e audiência
5. **Dispare** (Run) ou agende, mesma fila e créditos da API de envio

<Note>
  Cada contato precisa de **telefone ou e-mail** (ou ambos). Duplicata no workspace → **409** (`CONTACT_PHONE_EXISTS`, `CONTACT_EMAIL_EXISTS`).
</Note>

## Na API

* **Contatos, tags, tópicos, segmentos, campanhas**, CRUD completo
* Escopos: `contacts:*`, `tags:*`, `topics:*`, `segments:*`, `campaigns:*`
* Campanha na API usa canais **`whatsapp`**, **`sms`**, **`email`**, **`telegram`** (subconjunto do template)

Detalhe de rotas: **referência da API** na aba Contatos.

## Próximos passos

* [Quick Start](/contacts-api/como-funciona/quick-start): primeira tag e primeiro contato
* [Escopos da API Key](/contacts-api/como-funciona/escopos-da-api-key): permissões
* [Tópicos de comunicação](/contacts-api/como-funciona/topicos-de-comunicacao): consentimento por tema
* [Segmentos na audiência](/contacts-api/como-funciona/segmentos-na-audiencia): públicos dinâmicos
* [Campanhas no painel](/contacts-api/como-funciona/campanhas-no-painel): disparo em lote