Visão geral
Listas de contatos
As listas de contatos são as listas para as quais as suas campanhas são enviadas. Crie, mescle e arquive listas, gerencie inscritos, configure o double opt-in e um nome público 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 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 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.
- Excluir um inscrito remove a pessoa da lista. O contato continua no seu workspace.
A página Audiences
Acesse Email MarketingAudiences para ver as suas listas, com Name, Visibility, Subscribers e a data em Created. Abaixo do nome aparece o nome público, quando ele é diferente, e Visibility mostra Public ou Private e um selo Double opt-in quando ele está ativado. A coluna Subscribers mostra quantos inscritos cada lista tem em relação ao limite do seu plano, por exemplo 1.2k/10k. Todas as colunas podem ser ordenadas.
O menu da linha tem Manage subscribers, Rename, Merge into another audience, Archive e Delete. Para agir sobre várias listas, selecione-as e use Actions: Merge, Archive (ou Unarchive na aba Archived) e Delete.
Para criar uma, selecione Create audience, digite um nome em Name e selecione Create. Os nomes precisam ser únicos no workspace.
Arquivar uma lista
Arquive as listas que você não usa mais para organizar o painel sem perder nada. Uma lista arquivada vai para a aba Archived e:
- mantém todos os inscritos,
- fica oculta nos seletores de listas das campanhas, dos formulários, das automações e dos contatos,
- não aparece na página de gerenciamento de inscrições, exceto para as pessoas que ainda estão inscritas nela,
- deixa de aceitar inscrições pela URL de inscrição, que retorna
404.
As campanhas, os formulários e as automações que já a usam continuam funcionando. Selecione Unarchive para trazê-la de volta.
Mesclar listas
A mesclagem copia os inscritos de uma ou mais listas para outra. Selecione as listas, escolha Actions > Merge e depois a lista de destino, ou use Merge into another audience no menu de uma linha. Na página de uma lista, Merge audiences into this one no menu faz o mesmo na direção contrária.
- As pessoas que já estão na lista de destino mantêm o status que têm nela, então ninguém que se descadastrou é inscrito de novo.
- Uma pessoa que está em várias das listas mescladas fica inscrita quando está inscrita em pelo menos uma delas.
- Com Delete the merged audiences afterwards, as listas mescladas e as participações nelas são excluídas, e as campanhas que ainda não terminaram de ser enviadas a elas passam a ser enviadas à lista de destino. Os segmentos que têm uma lista mesclada como origem, ou uma regra sobre ela, também passam a usar a lista de destino, assim como as automações que começam por ela, adicionam pessoas a ela, a verificam em uma condição ou encerram execuções quando alguém sai dela. Isso também vale para os formulários que adicionam pessoas a ela ou a oferecem como opção, os links de double opt-in que ainda não foram confirmados e as execuções de automações que aguardam uma condição sobre ela.
A mesclagem não envia eventos subscriber.*, não inicia automações e não envia e-mails de double opt-in nem de confirmação. Os segmentos rastreados atualizam os membros deles em seguida. O limite de inscritos da lista de destino se aplica: uma mesclagem que o ultrapassaria não adiciona ninguém.
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 |
|---|---|
| Subscribe URL | Mostra a URL de inscrição desta lista e permite redefini-la. Consulte URL de inscrição. |
| Import | Importa um arquivo CSV ou Excel diretamente para esta lista. Consulte Importar inscritos. |
| 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. |
| Settings (no menu) | Abre a aba Settings. |
| Merge audiences into this one (no menu) | Copia os inscritos de outras listas para esta. Consulte Mesclar listas. |
| Archive (no menu) | Arquiva a lista ou a desarquiva. Consulte Arquivar uma lista. |
| Create segment (no menu) | Cria um novo segmento com esta lista como origem. Os segmentos estão em alfa e abertos apenas à equipe do Emailit. |
| 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. |
A aba Subscribers lista as pessoas da lista, com as visualizações All, Engaged e Unengaged, colunas ordenáveis, busca, filtros e ações em massa. Consulte Gerenciar inscritos.
A aba Settings reúne:
- Name and visibility: o nome interno, o nome público e a descrição que os inscritos veem, e se a lista é pública ou privada na página de gerenciamento de inscrições.
- Double opt-in e Confirmation email: consulte Double opt-in e e-mails de confirmação.
- Unengaged contacts: consulte Contatos não engajados.
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 ou peça um limite maior a support@emailit.com.
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:
{
"error": "Pro includes 50,000 subscribers per audience.",
"usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}Usar a API
A API de listas de contatos permite criar, obter, atualizar, listar, mesclar, atualizar em massa e excluir listas, e a API de inscritos 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.
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 as configurações (visibility, public_name, public_description, double_opt_in, confirmation_email, unengaged, archived, archived_at), 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. Um nome duplicado retorna 409. As listagens deixam de fora as listas arquivadas, a menos que você passe archived=true ou archived=all.
Eventos
As alterações em listas e inscritos geram eventos que você pode receber com webhooks e que iniciam automações:
| Evento | Quando |
|---|---|
audience.created, audience.updated, audience.deleted |
Uma lista é criada, alterada (inclusive quando é arquivada) ou excluída. Excluir uma lista não envia um evento para cada um dos inscritos dela. |
subscriber.created |
Alguém é adicionado a uma lista pelo painel, pela API, pela URL de inscrição, por um formulário, por um link de double opt-in ou pela página de gerenciamento de inscrições. Inicia as automações Added to audience. |
subscriber.updated |
Os dados ou o indicador Subscribed de um inscrito mudam. |
subscriber.deleted |
Um inscrito é removido. Inicia as automações Removed from audience. |
Importações e mesclagens não enviam eventos de inscrito.