Guia prático
Gerenciar inscritos
Adicione e importe pessoas para uma lista de contatos, edite-as, ative ou desative o indicador Subscribed delas, remova-as e faça tudo isso em massa, no painel ou com a API de inscritos.
Um inscrito é a participação de um contato em uma lista. Esta página mostra como adicionar inscritos, alterá-los, descadastrá-los ou reinscrevê-los e removê-los, e o que cada alteração faz com o contato por trás deles.
Antes de começar
- Crie a lista primeiro. Consulte Listas de contatos.
- Confira quanto espaço a lista tem. O limite conta todos os inscritos, incluindo os descadastrados. Consulte Limites.
- Para a API, use uma chave de API com Full Access.
Adicionar um inscrito
-
Abra a lista. Acesse Email MarketingAudiences e selecione a lista.
-
Adicione a pessoa. Selecione Add subscriber, digite o Email e, opcionalmente, First name e Last name.
-
Salve. Selecione Add. Se não existir um contato para o endereço, o Emailit cria um.
Quando a lista tem o double opt-in ativado, Ask them to confirm by email first (double opt-in) vem marcado: a pessoa recebe o e-mail de double opt-in e entra na lista quando clica no link dele. Desmarque a opção para adicioná-la na hora. Quando a lista tem um e-mail de confirmação, Send the confirmation email o envia à pessoa que você adiciona.
Você também pode adicionar contatos existentes em Email MarketingContacts: abra um contato e selecione Add to audience, ou selecione vários contatos e use Actions > Add to audience. Para adicionar muitas pessoas de uma vez, importe um arquivo.
Chame Adicionar um inscrito com o ID ou o nome da lista:
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": { "company": "Acme" }
}'{
"object": "subscriber",
"id": "sub_7Rt2vX9kLm3Qp",
"audience_id": "aud_5hJ2kL8mNp4Qr",
"contact_id": "con_2kq8Vt4xLm7Rz",
"email": "ada@example.com",
"first_name": "Ada",
"last_name": "Lovelace",
"custom_fields": { "company": "Acme" },
"subscribed": true,
"subscribed_at": "2026-10-01T09:30:00Z",
"unsubscribed_at": null,
"created_at": "2026-10-01T09:30:00Z",
"updated_at": "2026-10-01T09:30:00Z"
}Apenas email é obrigatório. Se você enviar first_name, last_name ou custom_fields para um contato existente, eles sobrescrevem os valores do contato, e custom_fields substitui o objeto inteiro.
Passe "double_opt_in": true para enviar o e-mail de double opt-in da lista em vez de adicionar a pessoa na hora; a resposta é 202 com "status": "pending". Passe "send_confirmation_email": true para enviar o e-mail de confirmação da lista depois de adicioná-la.
Quando a pessoa já está na lista
O resultado de adicionar um endereço que já está na lista depende do estado atual dele:
| Estado atual | Resultado | Resposta da API |
|---|---|---|
| Fora da lista | Um novo inscrito é criado com Subscribed ativado. | 201 |
| Na lista, com Subscribed ativado | Nada muda. O painel mostra “Contact is already subscribed to this audience”. | 409 com o inscrito em existing |
| Na lista, descadastrado | O inscrito é reinscrito: Subscribed é ativado, subscribed_at passa a ser o horário atual e unsubscribed_at é limpo. |
200 |
| A lista está cheia | Nada é adicionado. | 422 com usage |
Uma reinscrição por esse endpoint envia os eventos subscriber.updated e subscriber.resubscribed e inicia automações Added to audience, assim como um novo inscrito.
Importar inscritos
Para adicionar muitas pessoas de uma vez, abra a lista e selecione Import. Envie um arquivo CSV ou Excel com até 2.500 linhas, associe as colunas dele aos campos do contato, confira a prévia e selecione Import. Todas as pessoas do arquivo são adicionadas a esta lista; os contatos que ainda não existem são criados.
As importações são processadas em segundo plano, então os novos inscritos aparecem depois de alguns instantes. Elas não pedem double opt-in, não enviam o e-mail de confirmação e não enviam eventos de inscrito. Para importar para várias listas de uma vez, use a importação da página de contatos. Consulte Importar e exportar contatos.
Editar um inscrito
Na tabela de inscritos da lista, abra o menu da linha e selecione Edit. Você pode alterar First name, Last name e a opção Subscribed. O endereço de e-mail é somente leitura aqui.
Pela API, chame Atualizar um inscrito. Identifique o inscrito pelo ID sub_ ou pelo endereço de e-mail e envie qualquer um destes campos: email, first_name, last_name, custom_fields e subscribed:
curl https://api.emailit.com/v2/audiences/Newsletter/subscribers/ada@example.com \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "first_name": "Augusta", "subscribed": false }'Nome, sobrenome, e-mail e campos personalizados pertencem ao contato, não ao inscrito. Alterá-los aqui atualiza o contato em todos os lugares, inclusive nas outras listas dele. Apenas subscribed é específico desta lista.
Ativar ou desativar Subscribed
O indicador Subscribed define se as campanhas para esta lista chegam à pessoa. Desativá-lo mantém o inscrito na lista, registra unsubscribed_at e não mexe nas outras listas do contato. Ativá-lo de novo define um novo subscribed_at e limpa unsubscribed_at.
| Onde | Descadastrar | Reinscrever |
|---|---|---|
| Página da lista | Edit e depois desative Subscribed | Edit e depois ative Subscribed |
| Página do contato | Unsubscribe no menu da linha da lista | Resubscribe no menu da linha |
| API | Atualizar um inscrito com "subscribed": false |
Atualizar com "subscribed": true, ou adicionar o endereço de novo |
Essas alterações enviam um evento subscriber.updated. Elas não registram um descadastro em nenhuma campanha, então não aparecem na aba Unsubscribes de uma campanha. Quando os próprios destinatários se descadastram pelo link de uma campanha, eles saem de todas as listas de uma vez. Consulte Descadastros.
Remover um inscrito
Remover um inscrito exclui a participação na lista. Selecione Delete no menu da linha na página da lista, Remove from audience na página do contato, ou chame Excluir um inscrito.
| Descadastrar | Remover | |
|---|---|---|
| A pessoa continua na lista | Sim, com Subscribed desativado | Não |
| Conta para o limite da lista | Sim | Não |
| O contato é mantido | Sim | Sim |
| Evento | subscriber.updated |
subscriber.deleted, que inicia automações Removed from audience |
| Adicionar o endereço de novo | Reinscreve o inscrito existente | Cria um novo inscrito |
Prefira descadastrar quando alguém pede para sair, para manter um registro disso. Remova os inscritos que você adicionou por engano ou que não quer mais manter. Para excluir a pessoa por completo, exclua o contato, o que o remove de todas as listas.
Ações em massa
Selecione os inscritos com as caixas de seleção e use Actions:
- Subscribe ativa Subscribed.
- Unsubscribe desativa Subscribed e mantém as pessoas na lista.
- Remove from audience exclui a participação delas na lista. Os contatos continuam.
Para agir sobre mais de uma página, selecione a página inteira com a caixa de seleção do cabeçalho e depois Select all matching subscribers. Isso seleciona todas as pessoas que correspondem à visualização atual (All, Engaged ou Unengaged) e à busca, até 10.000 pessoas. Cada alteração envia os mesmos eventos que alterar o inscrito manualmente.
Pela API, chame Atualizar inscritos em massa com até 1.000 IDs de inscritos, ou com "all_matching": true e um filtro engagement ou subscribed opcional.
Listar e encontrar inscritos
Na página da lista, pesquise por e-mail ou nome e filtre por Email, First name, Last name, Subscribed, Subscribed at, Last opened or clicked ou Added. Selecione o cabeçalho de uma coluna para ordenar por ela. Last opened or clicked mostra a abertura ou o clique mais recente do contato em qualquer e-mail do seu workspace, e as visualizações Engaged e Unengaged dividem as pessoas inscritas de acordo com a regra de não engajamento da lista.
Pela API, Listar inscritos retorna todos os inscritos, incluindo os descadastrados. Adicione subscribed=true ou subscribed=false para restringir a lista, engagement=engaged ou engagement=unengaged para separar por engajamento, search para buscar no e-mail ou nos nomes, order e direction para ordenar, e page e limit (até 100) para paginar:
curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
-H "Authorization: Bearer $EMAILIT_API_KEY"Para consultar uma pessoa, use Obter um inscrito com o ID sub_ ou o endereço de e-mail.