Audiência
Contatos, segmentos, etiquetas, tópicos e propriedades, a importação, as ações em massa e os filtros.
Para que serve
A Audiência é a sua base de contatos: as pessoas que recebem campanhas e automações, e tudo o que ajuda a organizá-las. São cinco abas: Contatos, Segmentos (listas de contatos), Etiquetas (marcas livres), Tópicos (assuntos que cada pessoa escolhe receber) e Propriedades (campos extras, como empresa ou plano).
Quando usar: Para cadastrar e importar contatos, separar quem recebe o quê, manter a base limpa e preparar o público de uma campanha.
#Contatos
Onde fica: Marketing › Audiência. Endereço: app.postal.so/audience.
A aba Contatos lista todas as pessoas do time. Contatos entram por cadastro manual, importação de CSV, formulários, API, conexão de CRM e automações. O e-mail identifica o contato: não existem dois com o mesmo endereço no time.
Quem recebe um e-mail transacional seu também entra aqui, sozinho, como contato Não confirmado, e só recebe marketing depois que você confirma. Veja Audiência automática dos e-mails transacionais.
Botões da aba
| Item | O que faz |
|---|---|
| Ver código | Mostra como criar um contato pela API (POST /contacts). |
| Importar CSV | Abre a importação. |
| Adicionar contato | Abre o cadastro de um contato: E-mail, Nome, Sobrenome e, se você tem segmentos estáticos, o Segmento a que ele entra. Se você estava vendo um segmento, ele já vem escolhido. |
Barra de ferramentas
| Item | O que faz |
|---|---|
| Buscar por e-mail ou nome | Procura nos dois campos. |
| Filtros | Sete filtros por Segmento, Tópico, Etiqueta, Inscrição, Validação, Confirmação e Origem. Veja Filtros. |
| Total | À direita, a contagem de contatos: 52.300 contatos sem filtros e 1.204 de 52.300 contatos com filtros (quantos combinam, de quantos o time tem). O número vem de uma contagem exata da API e pode levar alguns segundos para se atualizar. |
| Verificar e-mails | Leva à Validação de e-mails com a origem já escolhida: o segmento filtrado, ou todos os contatos. |
| Exportar | Gera um CSV dos contatos que combinam com a busca e os filtros. Veja Exportações. |
Colunas
| Coluna | O que mostra |
|---|---|
| Caixa de seleção | Marca contatos para as ações em massa. A caixa do cabeçalho (Selecionar todos os contatos desta página) marca a página; fica com um traço quando só parte está marcada. Segure Shift ao clicar para marcar uma faixa. |
| O endereço (link que abre o contato), o selo da validação (Válido, Inválido, Arriscado ou Não validado, com a data no ponteiro do mouse) e o ID no seu sistema, quando existe. | |
| Nome | Nome e sobrenome. |
| Selo Não confirmado | Ao lado do e-mail, nos contatos guardados dos e-mails transacionais que ainda não foram confirmados. Eles não recebem campanhas nem automações. |
| Etiquetas | As primeiras etiquetas do contato. |
| Inscrição | Inscrito ou Descadastrado. Quem se descadastra deixa de receber qualquer campanha. |
| Última alteração | Quem mexeu por último (API, Painel, Formulário, Importação, Automação, Plataforma parceira, Postal ou CRM conectado) e há quanto tempo. |
| Criado em | Quando o contato entrou. |
| Menu da linha | Abrir e Excluir. |
Detalhe de um contato
Clicar num contato abre a página dele, com um botão Contatos para voltar.
| Item | O que faz |
|---|---|
| Cabeçalho | O e-mail com o selo de validação, o nome, Inscrito/Descadastrado, as etiquetas, Desde a data de entrada e Última alteração. O botão Excluir apaga o contato (ele sai de todos os segmentos). |
| Dados | Nome, Sobrenome, ID no seu sistema (o ID da pessoa no seu app ou CRM, único no time) e um campo para cada propriedade. Salvar grava. |
| Recebe campanhas | A chave que descadastra e reinscreve. Descadastrado, o contato não recebe nenhuma campanha, seja qual for o tópico. |
| Etiquetas | As etiquetas do contato, cada uma com um X para tirar; o campo Adicionar etiqueta escolhe uma existente ou cria uma nova; Gerenciar leva à aba Etiquetas. |
| Segmentos | Uma chave por segmento estático, para pôr o contato ou tirá-lo da lista; Nos segmentos dinâmicos lista, só para leitura, aqueles em que ele entrou pelos filtros. |
| Tópicos | Uma chave por tópico, ligada quando o contato está inscrito. Mudar aqui muda a escolha dele. |
Veja também: Contatos (API) · Marketing por e-mail: consentimento e descadastro.
#Filtros
Quase toda lista do painel tem um único botão Filtros (um ícone de controles deslizantes) na barra de ferramentas. Ele guarda todos os filtros da tela num painel só, para a barra continuar curta mesmo em telas com muitos filtros.
Como usar
- Clique em Filtros. No celular, o painel sobe como uma folha presa à parte de baixo da tela.
- Cada filtro é uma linha com o nome e uma lista; a primeira opção da lista desliga o filtro (por exemplo, Todos os status). Escolha o valor. A lista de contatos, e-mails ou o que for se atualiza na hora.
- Os filtros ligados ficam na cor de destaque e ganham um X (Limpar ...) para desligar só aquele.
- No fim do painel, Limpar filtros desliga todos de uma vez. Ele fica desativado quando não há filtro ligado.
- Clique fora do painel, ou aperte
Esc, para fechá-lo.
O que o botão mostra
- Sem filtros ligados, só o nome Filtros.
- Com filtros ligados, uma bolinha com a quantidade e o contorno em destaque. Com um só filtro ligado, o valor dele aparece ao lado (em telas largas). Passar o mouse sobre o botão lista todos (por exemplo, "Status: Bounce").
- No alto do painel, o resumo diz Nenhum filtro aplicado, 1 filtro aplicado ou N filtros aplicados.
O que fica fora do painel
Os controles principais ficam sempre à vista, ao lado do botão: a busca e o seletor de Período (nas listas que têm). A busca não é apagada pelo Limpar filtros. Filtros sem nada para escolher somem do painel: sem nenhum segmento criado, por exemplo, não aparece o filtro de segmento.
Onde ele aparece
| Tela | Filtros |
|---|---|
| Contatos | Segmento, Tópico, Etiqueta, Inscrição (Inscritos ou Descadastrados) e Validação (Válido, Inválido, Arriscado, Não validado), Confirmação (Não confirmados ou Confirmados) e Origem (E-mails transacionais). |
| E-mails | Status, Domínio e Chave de API. Veja E-mails. |
| Logs | Status, Origem, User agent e Chave de API. Veja Logs. |
| Outras listas | Templates (Status), Campanhas (Status), Automações (Status), Eventos (Evento), Agendados (Tipo), Domínios (Status e Região), Chaves de API (Permissão), as respostas de formulários (Formulário), a lista de execuções de uma automação (Status) e os destinatários de uma campanha (Status do destinatário). |
Dica
Os filtros e a busca ficam no endereço da página. Copie o link de uma lista já filtrada para mandar a um colega, ou salve nos favoritos.
#Ações em massa nos contatos
Marque vários contatos e aplique uma ação a todos de uma vez: inscrever em um tópico, pôr etiquetas, mudar de segmento, verificar os e-mails, descadastrar, reinscrever, exportar ou excluir. Dá para marcar a página, ou todos os contatos que combinam com os filtros, mesmo que sejam milhares. Funciona na aba Contatos.
Escolher os contatos
- Use a caixa de cada linha, ou a do cabeçalho (Selecionar todos os contatos desta página). Com
Shiftvocê marca uma faixa de linhas. A seleção continua ao trocar de página. - Se há mais contatos do que a página mostra, uma faixa aparece sob a barra: "50 contatos desta página estão selecionados." com o link Selecionar todos os 52.300 contatos (ou Selecionar todos os 1.204 contatos que correspondem a estes filtros, se há filtros). O número é a contagem exata (Contando os contatos… enquanto calcula).
- Depois de clicar nesse link, a faixa passa a dizer Todos os 1.204 contatos estão selecionados. Desmarcar uma linha tira aquele contato da seleção (N desmarcados) e o total diminui. Limpar seleção desfaz tudo.
Há limites: você pode marcar até 1.000 contatos um a um (acima disso, use "selecionar todos que correspondem aos filtros") e desmarcar até 5.000 depois de selecionar todos (acima disso, refine os filtros). Uma ação aceita até 200.000 contatos.
A barra de ações
Com contatos marcados, a barra de busca e filtros dá lugar a uma barra que diz N selecionados e tem Limpar (também funciona a tecla Esc, quando nenhuma janela, menu ou campo de texto está em uso). No celular, a barra gruda na parte de baixo da tela e mostra só os ícones.
| Ação | O que faz |
|---|---|
| Tópico | Abre Inscrição em tópico: escolha o Tópico e a Inscrição (Inscrever no tópico ou Tirar do tópico). Sem tópicos criados, a janela manda criar um na aba Tópicos. |
| Etiquetas | Abre Etiquetas: O que fazer (Adicionar etiquetas ou Remover etiquetas) e as etiquetas, escolhidas da lista ou criadas ali mesmo (só ao adicionar). Até 20 etiquetas por vez. |
| Segmento | Abre Segmento: Adicionar ao segmento ou Remover do segmento. Só aparecem segmentos estáticos: os dinâmicos se atualizam pelos filtros. |
| Mais ações › Verificar e-mails | Confere se cada endereço existe e pode receber e-mails. Mostra Créditos necessários e Créditos disponíveis; cada endereço verificado usa um crédito, e quem já foi verificado há pouco não custa nada. Verificar de novo os endereços verificados há muito tempo inclui os de mais de 90 dias. Sem créditos suficientes, o botão fica desligado e aparece Comprar adicional de validação. Ao terminar de preparar, o painel abre a validação em Validação de e-mails. |
| Mais ações › Descadastrar | Pede confirmação: os contatos deixam de receber qualquer campanha, mas continuam na base. |
| Mais ações › Reinscrever | Volta a enviar campanhas a quem tinha se descadastrado. Por ser uma questão de consentimento, o botão só liga depois de você marcar Confirmo que essas pessoas pediram para voltar a receber e-mails. Reinscrever sem o consentimento viola a LGPD e as regras anti-spam e pode bloquear o seu envio. Endereços da lista de supressão continuam de fora. |
| Mais ações › Confirmar que aceitam receber | Só para o dono e os admins. Faz os contatos Não confirmados passarem a receber campanhas e automações, depois que você marca a declaração de que eles aceitaram. Veja Confirmar que aceitam receber. |
| Mais ações › Exportar | Começa a exportação na hora e entrega um CSV dos contatos selecionados pelo cartão de tarefas do canto da tela. |
| Excluir | Apaga os contatos de vez: eles saem de todos os segmentos e tópicos e não dá para desfazer. A partir de 1.000 contatos, é preciso digitar o número de contatos para confirmar. |
Acompanhar, cancelar e conferir o resultado
- Ações pequenas (até 200 contatos) terminam na hora. As maiores rodam em segundo plano: um cartão no alto da aba mostra o que está sendo feito (Excluindo contatos…, Adicionando etiquetas…), o andamento (3.200 / 12.345) e a barra com a porcentagem. Pode sair da tela: o cartão volta, mesmo depois de recarregar a página.
- Cancelar termina o pedaço que já estava em andamento e mantém o que já foi feito (o cartão muda para Cancelando… e depois Operação cancelada).
- O time faz uma operação em massa por vez. Enquanto uma roda, as ações ficam desligadas, com o aviso Há uma operação em andamento. Aguarde ela terminar para iniciar outra.
- Ao fim, um aviso resume o resultado (por exemplo, 1.150 alterados · 50 ignorados · 2 falharam). Os ignorados já estavam no estado final (quem já tinha a etiqueta, por exemplo). Se houve falhas, o cartão fica com Ver erros (N), que lista os primeiros contatos que falharam, até você tocar em Dispensar.
- Se a operação não terminar, o cartão diz A operação não terminou: o que já foi feito foi mantido e, ao tentar de novo, o que já está no estado final é ignorado.
- Se o número de contatos mudou entre o momento em que você viu e o de confirmar (por exemplo, uma importação terminou), o painel pergunta: A seleção mudou de X para Y contatos. Continuar com Y?
Dica
Para limpar uma base antes de uma campanha: filtre por Validação › Inválido, selecione todos os que combinam, e use Descadastrar (reversível) em vez de Excluir.
Veja também: Validação de e-mails · Contatos (API) · Exportações.
#Importar contatos
Onde fica: Marketing › Audiência › Importar CSV. Endereço: app.postal.so/audience.
Traz contatos de uma planilha CSV. Quem já existe é atualizado pelo e-mail, não duplicado. Os endereços da lista de supressão são ignorados, e o plano limita o total de contatos.
- Clique em Importar CSV e escolha o arquivo (Escolher arquivo CSV). O arquivo precisa ter uma linha de cabeçalho, ser separado por vírgula ou ponto e vírgula e ter até 20 MB; maiores devem ser divididos. Sem uma planilha pronta, Baixar modelo (CSV) traz uma com as colunas das suas propriedades.
- Em Colunas, ligue cada campo a uma coluna do arquivo. Só o E-mail é obrigatório. Os demais: Nome, Sobrenome, Descadastrado (sim/não), Etiquetas (separadas por vírgula) e uma linha para cada propriedade. Não importar ignora um campo. O painel sugere as ligações pelo nome das colunas.
- Confira a Prévia da importação, com as primeiras linhas já mapeadas.
- Escolha, se quiser, o Adicionar ao segmento (só estáticos recebem contatos importados) e os tópicos em Inscrever nos tópicos.
- Decida se liga Disparar automações para os contatos importados: inicia as automações de "Contato criado", "Adicionado a um segmento" e "Etiqueta adicionada", como a API faz. Em arquivos grandes isso pode iniciar muitas automações e enviar muitos e-mails, disparados aos poucos e contados no limite mensal de execuções do plano. O padrão é desligado.
- Clique em Importar.
A importação roda em segundo plano, e o cartão de tarefas no canto mostra Importando contatos com o andamento (N de M linhas). Ao fim, o resumo traz quantos foram novos, atualizados e ignorados, quantos endereços foram pulados por estarem na lista de supressão e as Linhas com erro (com o número da linha). Se o limite de contatos do plano acabou no meio, o resto do arquivo não é importado; quando o plano permite, ligar Continuar adicionando contatos acima do limite do plano em Cobrança permite importar o resto (os contatos extras são cobrados). Se o seu plano de marketing oferece o Adicional de contatos, adicionar pacotes também aumenta o limite.
Dica
Prefira importar quem pediu para receber seus e-mails. Antes da primeira campanha para uma lista nova, valide-a em Validação de e-mails para evitar bounces.
Veja também: Importação de contatos (API) · Propriedades.
#Segmentos
Onde fica: Marketing › Audiência › Segmentos. Endereço: app.postal.so/audience/segments.
Um segmento é uma lista de contatos para direcionar campanhas, automações e formulários. Um contato pode estar em vários. Há dois tipos:
| Tipo | Como funciona |
|---|---|
| Estático | Uma lista que você mantém: adiciona e remove contatos (pela tela do contato, na importação, nas ações em massa, por um formulário ou pela API). |
| Dinâmico | Um grupo definido por filtros: os contatos entram e saem sozinhos conforme combinam com eles (marcado com o selo Dinâmico). As campanhas vão para quem combina com os filtros na hora do envio. Depende do plano. |
Lista
| Item | O que faz |
|---|---|
| Segmento dinâmico | Abre o editor de filtros de um segmento novo. |
| Criar segmento | Cria um segmento estático: Nome e Descrição (opcional). |
| Unificar | Junta segmentos estáticos em um só (veja abaixo). Fica ativo com 2 ou mais segmentos estáticos. Marcados ao menos dois, o botão vira Unificar N segmentos. |
| Buscar segmento | Procura pelo nome. Ao lado, o total (N segmentos). |
| Coluna | O que mostra |
|---|---|
| Caixa de seleção | Marca segmentos para unificar. Os dinâmicos ficam desligados (Segmentos dinâmicos não podem ser unificados. Converta em estático antes.). |
| Nome | Link que mostra os contatos do segmento em Contatos. Segmentos dinâmicos têm o selo Dinâmico. |
| Contatos | Quantos contatos tem (clicar mostra a lista). |
| Criado em | A data de criação. |
| Menu da linha | Ver contatos; Editar (estático: nome e descrição) ou Editar filtros (dinâmico); Converter (dinâmico → estático); Excluir (os contatos continuam na audiência). |
Editor de segmento dinâmico
Os filtros são grupos de condições. Dentro de cada grupo, escolha se o contato precisa atender a todas ou a qualquer uma das condições; entre os grupos, a ligação é E ou OU (um clique alterna). Há no máximo 10 grupos e 20 condições. Cada condição escolhe o tipo, o campo, o operador e o valor:
| Tipo de condição | O que verifica |
|---|---|
| Contato | E-mail, Nome, Sobrenome, Data de criação, Descadastrado, Validação do e-mail (Válido, Arriscado, Inválido, Não validado), Confirmação de marketing (Não confirmado ou Confirmado) e Origem (E-mails transacionais). |
| Propriedades | Qualquer propriedade criada, com operadores do tipo dela (texto, número, sim/não, data). |
| Etiquetas | tem / não tem uma etiqueta. |
| Tópicos | está inscrito / não está inscrito. |
| Segmentos | está em / não está em outro segmento estático. |
| Atividade de e-mail | Recebimento, abertura, clique, resposta, bounce ou marcação como spam, de qualquer e-mail, de uma campanha, de um template ou de uma automação, com o período (nos últimos N dias, ou em qualquer data) e a quantidade mínima. |
| Eventos | realizou / não realizou um evento do seu app, com o período e, se quiser, uma propriedade do evento. |
A Prévia à direita conta, em tempo real, quantos contatos atendem aos filtros agora e mostra os Mais recentes; antes de completar as condições ela pede para completá-las. Converter em estático transforma quem combina agora na lista do segmento, que deixa de mudar sozinha (e libera o segmento para ser unificado).
Atenção
Quem entra num segmento dinâmico inicia as automações "Adicionado a um segmento" dele. Ninguém que já atende aos filtros no momento em que você salva inicia automações. O segmento se atualiza quando um contato muda e, nos filtros com tempo ("nos últimos 30 dias"), a cada hora.
Unificar audiências
Unificar abre um assistente em quatro etapas para juntar segmentos estáticos em um só, sem repetir ninguém:
| Etapa | O que acontece |
|---|---|
| Segmentos | Escolha 2 ou mais para unificar e o Destino: um Novo segmento (dê o nome) ou Um dos escolhidos. A opção Excluir os segmentos de origem apaga os de origem no fim (os contatos continuam na audiência). |
| Prévia | Conta os Contatos únicos, as Duplicidades removidas (quem estava em mais de um) e os Possíveis contatos duplicados (endereços diferentes que chegam na mesma caixa: maiúsculas, pontos do Gmail, +tags). Mesclar contatos duplicados junta esses contatos num só, mantendo o de mais engajamento. |
| Itens vinculados | Lista o que usa os segmentos de origem (campanhas, automações, formulários, segmentos dinâmicos, importações). Para cada um, escolha: Usar "destino", Manter em "origem", Cancelar o envio (campanha agendada) ou Pausar a automação. Itens em andamento impedem excluir a origem. |
| Confirmar | Resume o que vai acontecer e roda em segundo plano (Unificando audiências, com as etapas e o andamento). Você pode fechar a janela: a unificação continua. |
Veja também: Segmentos (API) · Segmentos dinâmicos · Unificar (API).
#Etiquetas
Onde fica: Marketing › Audiência › Etiquetas. Endereço: app.postal.so/audience/tags.
Etiquetas marcam contatos com o que você sabe sobre eles: engajado, cliente VIP, lead quente. Servem em filtros, em segmentos dinâmicos e como gatilho ou condição nas automações. Uma etiqueta nasce aqui, num contato, numa importação (coluna de etiquetas) ou numa automação.
| Item | O que faz |
|---|---|
| Criar etiqueta | Pede o nome (Etiqueta) e a Cor (Rosa, Azul, Verde, Amarelo, Vermelho ou Cinza), com uma Prévia. |
| Buscar etiqueta | Procura pelo nome. À direita fica o total (N etiquetas). |
| Coluna | O que mostra |
|---|---|
| Etiqueta | A etiqueta, com a cor. |
| Contatos | Quantos contatos a têm (clicar mostra a lista). |
| Criado em | A data de criação. |
| Menu da linha | Ver contatos, Editar (nome e cor) e Excluir (a etiqueta sai de todos os contatos). |
Veja também: Etiquetas (API).
#Tópicos
Onde fica: Marketing › Audiência › Tópicos. Endereço: app.postal.so/audience/topics.
Tópicos são assuntos que a pessoa escolhe receber, como "Novidades do produto" ou "Ofertas". Com tópicos, cada contato decide o que quer receber sem sair da lista toda. Uma campanha pode ser limitada a um tópico, e os tópicos públicos aparecem na página de preferências que o link de descadastro abre.
| Campo | O que é |
|---|---|
| Nome e Descrição | O nome e um texto opcional. |
| Inscrição padrão | Inscrito: todos recebem, até escolherem sair. Não inscrito: só recebe quem escolher entrar. Não muda depois de criado: os contatos sem escolha já seguem esse padrão. |
| Visibilidade | Público: aparece na página de preferências do contato. Privado: só você gerencia, pela API ou pelo painel. |
| Coluna | O que mostra |
|---|---|
| Nome | O nome do tópico. |
| Padrão | A inscrição padrão (Inscrito ou Não inscrito). |
| Visibilidade | Público ou Privado. |
| Menu da linha | Editar e Excluir (as escolhas dos contatos para o tópico se perdem). |
Dica
Para uma newsletter opcional, use inscrição padrão Não inscrito (opt-in): só recebe quem se inscreveu por um formulário. Para avisos que todos devem receber, mas que alguns possam dispensar, use Inscrito.
Veja também: Tópicos (API) · Tópicos e consentimento.
#Propriedades
Onde fica: Marketing › Audiência › Propriedades. Endereço: app.postal.so/audience/properties.
Propriedades são campos extras dos contatos, como empresa ou plano. Servem para importar, coletar em formulários, filtrar segmentos e personalizar campanhas ({{{contact.empresa}}}).
| Campo | O que é |
|---|---|
| Chave | O nome técnico: letras minúsculas, números e _, começando por uma letra. Não muda depois de criada. |
| Tipo | Texto, Número, Sim/não ou Data. |
| Valor padrão | Usado nas campanhas quando o contato não tem valor. É a única parte que se edita depois (Editar valor padrão). |
O menu de cada propriedade tem Editar valor padrão e Excluir (o valor é apagado de todos os contatos). No topo, o total (N propriedades).
Veja também: Propriedades (API).