Listas de contatos

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

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.

Limites

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

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

{
  "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, renomear, listar 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 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.

Eventos

As alterações em listas e inscritos geram eventos que você pode receber com webhooks e que iniciam automações:

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

Próximos passos