Contatos

Um contato é uma pessoa no seu workspace, identificada pelo endereço de e-mail. Os contatos guardam os nomes e os valores de campos personalizados que você usa para personalizar campanhas, e participam de listas de contatos, que são as listas para as quais as campanhas são enviadas. Esta página explica como essas peças se encaixam e o que você pode fazer com contatos no painel e na API.

Contatos, listas e inscritos

O Emailit mantém pessoas e listas separadas. Uma pessoa existe uma única vez como contato, e cada lista em que ela está é um registro de inscrito separado, com o seu próprio estado de opt-in.

Workspace
├── Contacts ────────────── one per email address
│   ├── email, first_name, last_name, custom_fields
│   └── marketing status (unsubscribed: true | false)
└── Audiences ───────────── named lists, for example "Newsletter"
    └── Subscribers ─────── one per contact on the list
        └── subscribed: true | false

Na prática:

• Um contato pode ser inscrito de muitas listas, com um indicador Subscribed separado em cada uma.
• Adicionar alguém a uma lista pelo e-mail cria o contato primeiro, se ele ainda não existir.
• Os nomes e os campos personalizados ficam no contato. Editá-los a partir de uma lista altera o contato, então a alteração aparece em todos os lugares.

Quem recebe uma campanha

Uma campanha é enviada a todos os contatos que atendem às três condições:

1. O contato é inscrito de pelo menos uma das listas da campanha, com Subscribed ativado.
2. O status de marketing do contato é Subscribed.
3. O endereço não está na sua lista de supressão.

Um contato que está em várias das listas selecionadas recebe uma única cópia. Consulte Criar uma campanha para as regras completas.

Status de marketing

Todo contato também tem um Marketing status válido para todo o workspace: Subscribed ou Unsubscribed (o campo unsubscribed na API). Ele é um descadastro global que fica acima do indicador de cada lista.

O status de marketing e as inscrições em listas controlam apenas as campanhas. Eles não bloqueiam os e-mails que você envia com a API ou por SMTP, nem os e-mails enviados por automações. Para interromper todos os e-mails para um endereço, adicione-o às suas supressões. Descadastros explica todas as formas de descadastro.

A página de contatos

Abra Email Marketing›Contacts para ver todos os contatos do workspace, dos mais recentes para os mais antigos.

• Colunas. Email sempre aparece. Ative ou desative First name, Last name, Audiences, Created e Updated em Display options > Edit columns, ou selecione Show full name para juntar os nomes em uma única coluna Name. Na coluna Audiences, o selo de cada lista fica verde enquanto o contato está inscrito nela e vermelho depois que ele se descadastra.
• A busca procura no e-mail, no nome e no sobrenome.
• Filtre por Email, Name, First name, Last name, Unsubscribed, Created, Updated, Audiences ou Audience, e por qualquer campo personalizado. Com dois ou mais filtros, escolha se o contato precisa atender a todos ou a qualquer um deles.
• Ordene selecionando o cabeçalho de uma coluna.
• Import e Export trazem e levam contatos como arquivos. Consulte Importar e exportar contatos.

Selecione uma linha para abrir o contato. O menu da linha tem Edit e Delete.

Adicionar um contato

Selecione Add contact e digite o Email e, opcionalmente, First name, Last name e Audiences. Selecione Show custom fields para preencher os valores dos campos personalizados. Um endereço de e-mail só pode existir uma vez por workspace, então adicionar um endereço existente falha.

Para alterar um contato depois, selecione Edit. Você pode alterar os nomes e os campos personalizados. O endereço de e-mail não pode ser alterado no painel. Use o campo email de Atualizar um contato.

Ações em massa

Selecione os contatos com as caixas de seleção (a caixa do cabeçalho seleciona a página inteira) e abra Actions. Cada ação se aplica a até 100 contatos por vez.

A página do contato

A página do contato mostra tudo o que o Emailit sabe sobre uma pessoa. Use Edit e Delete no topo.

Usar a API

A API de contatos cobre tudo o que a lista e o perfil fazem, exceto a importação de arquivos:

• Crie, obtenha, atualize, liste e exclua contatos. Onde um ID for esperado, você pode passar o endereço de e-mail do contato em vez do ID con_ dele.
• Passe audiences (um array de IDs aud_) ao criar um contato para inscrevê-lo na hora. Na atualização, audiences substitui as participações do contato.
• Execute uma ação em massa em até 100 contatos e exporte até 10.000 como CSV ou XLSX.

curl https://api.emailit.com/v2/contacts \
  -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", "plan": "pro" },
    "audiences": ["aud_2kq8Vt4xLm7Rz"]
  }'

Criar um contato com um e-mail que já existe retorna 409 com o contato existente em existing. A API de contatos exige uma chave de API com Full Access.

As alterações em contatos geram os eventos contact.created, contact.updated e contact.deleted, e as alterações nas participações geram eventos subscriber.*, que você pode receber com webhooks.

Próximos passos