# Listas de contatos

> As listas de contatos são as listas para as quais as suas campanhas são enviadas. Crie listas, gerencie inscritos, confira o limite de inscritos do seu plano e use listas pela API.

Uma lista de contatos é uma lista nomeada de contatos, como “Newsletter” ou “Novidades do produto”. Você escolhe uma ou mais listas como destinatárias de uma [campanha](/pt/docs/campaigns/) e pode adicionar pessoas a uma lista manualmente, por importação, pela API ou com uma URL de inscrição hospedada.

## Como as listas funcionam

Cada pessoa em uma lista é um **inscrito**: um vínculo entre um [contato](/pt/docs/contacts/) e a lista, com o seu próprio indicador **Subscribed**. O mesmo contato pode estar em várias listas e estar inscrito em algumas e descadastrado de outras.

- As **campanhas** são enviadas aos inscritos cujo indicador **Subscribed** está ativado, cujo contato não está descadastrado globalmente e cujo endereço não está suprimido. Um contato que está em várias das listas selecionadas recebe uma única cópia.
- O **descadastro** desativa o indicador, mas mantém o inscrito na lista, para que você preserve o histórico. Consulte [Descadastros](/pt/docs/audiences/unsubscribes/).
- **Excluir um inscrito** remove a pessoa da lista. O contato continua no seu workspace.

## A página Audiences

Acesse **Email Marketing → Audiences** para ver as suas listas, com **Name**, **Subscribers** e a data em **Created**. A coluna **Subscribers** mostra quantos inscritos cada lista tem em relação ao limite do seu plano, por exemplo `1.2k/10k`. Use o menu da linha para gerenciar os inscritos (**Manage subscribers**), renomear (**Rename**) ou excluir (**Delete**) uma lista.

Para criar uma, selecione **Create audience**, digite um nome em **Name** e selecione **Create**. Os nomes precisam ser únicos no workspace.

## A página da lista

Abra uma lista para gerenciar os inscritos dela. O cabeçalho mostra o número de inscritos e o selo do limite, com estas ações:

| Ação | O que faz |
| --- | --- |
| **Rename** | Altera o nome da lista. |
| **Subscribe URL** | Mostra a URL de inscrição hospedada desta lista e permite redefini-la. Consulte [URL de inscrição](/pt/docs/audiences/subscribe-url/). |
| **Add subscriber** | Adiciona uma pessoa pelo endereço de e-mail. É substituído por **Upgrade** quando uma lista no Pay as you go está cheia. |
| **Delete** (no menu) | Exclui a lista e todos os inscritos dela. Os contatos continuam no seu workspace. Essa ação não pode ser desfeita. |

Abaixo, a tabela de inscritos lista **Email**, **First name**, **Last name**, **Subscribed** e **Created**, com busca, filtros e um menu na linha para editar (**Edit**) ou excluir (**Delete**) cada inscrito. Consulte [Gerenciar inscritos](/pt/docs/audiences/subscribers/).

## Limites

Cada plano limita quantos inscritos uma lista pode ter. O número de listas não é limitado.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Inscritos por lista | 10.000 | 50.000 | 250.000 | Ilimitados |

O limite conta todos os inscritos da lista, incluindo as pessoas que se descadastraram. Para liberar espaço, exclua os inscritos de que você não precisa mais, [faça upgrade do seu plano](/pt/docs/billing/plans/) ou solicite um limite maior com **Request Increase** no card **Sending Limits** da página inicial do painel.

Quando uma lista está cheia, **Add subscriber** fica desativado e todas as formas de adicionar pessoas, incluindo a API, as importações e a URL de inscrição, são rejeitadas com `422` e uma mensagem como “Pro includes 50,000 subscribers per audience.”. O erro da API inclui o `usage` atual:

```json
{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}
```

## Usar a API

A [API de listas de contatos](/pt/docs/api-reference/audiences/) permite [criar](/pt/docs/api-reference/audiences/create/), [obter](/pt/docs/api-reference/audiences/get/), [renomear](/pt/docs/api-reference/audiences/update/), [listar](/pt/docs/api-reference/audiences/list/) e [excluir](/pt/docs/api-reference/audiences/delete/) listas, e a [API de inscritos](/pt/docs/api-reference/audiences/subscribers/) gerencia as pessoas nelas. Você pode usar o nome de uma lista em vez do ID `aud_` dela na URL. A API exige uma chave de API com **Full Access**.

```bash
curl https://api.emailit.com/v2/audiences \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Newsletter" }'
```

As respostas de listas incluem `subscribers_count` e um objeto `usage` com `used`, `limit` e `plan`. Criar, obter e atualizar uma lista também retorna o `token` dela, a parte secreta da [URL de inscrição](/pt/docs/audiences/subscribe-url/). Um nome duplicado retorna `409`.

## Eventos

As alterações em listas e inscritos geram eventos que você pode receber com [webhooks](/pt/docs/webhooks/) e que iniciam [automações](/pt/docs/automations/):

| Evento | Quando |
| --- | --- |
| [`audience.created`, `audience.updated`, `audience.deleted`](/pt/docs/webhooks/events/audience/) | Uma lista é criada, renomeada ou excluída. Excluir uma lista não envia um evento para cada um dos inscritos dela. |
| [`subscriber.created`](/pt/docs/webhooks/events/subscriber/) | Alguém é adicionado a uma lista pelo painel ou pela API. Inicia as automações **Added to audience**. |
| [`subscriber.updated`](/pt/docs/webhooks/events/subscriber/) | Os dados ou o indicador **Subscribed** de um inscrito mudam. |
| [`subscriber.deleted`](/pt/docs/webhooks/events/subscriber/) | Um inscrito é removido. Inicia as automações **Removed from audience**. |

Importações e a URL de inscrição não enviam eventos de inscrito.

## Próximos passos

  - [Gerenciar inscritos](/pt/docs/audiences/subscribers/): Adicione, edite, descadastre e remova pessoas.
  - [URL de inscrição](/pt/docs/audiences/subscribe-url/): Receba inscrições do seu próprio site.
  - [Descadastros](/pt/docs/audiences/unsubscribes/): Como os descadastros funcionam entre listas.
  - [Enviar uma campanha](/pt/docs/campaigns/create/): Envie e-mails para os inscritos das suas listas.

---
Fonte: https://emailit.com/pt/docs/audiences/