Pular para o conteúdo
Docs

Guia prático

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.

Atualizado em 9 de out. de 2026

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

  1. Abra a lista. Acesse Email MarketingAudiences e selecione a lista.

  2. Adicione a pessoa. Selecione Add subscriber, digite o Email e, opcionalmente, First name e Last name.

  3. 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.

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:

Terminal
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:

Terminal
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.

Permita que as pessoas se inscrevam pelo seu site.
A pessoa por trás de cada inscrito.

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.