Gerenciamento dos assinantes

O menu de assinantes mostra toda a sua lista de contatos.

Essa lista pode ser filtrada usando as abas principais: Busca básica e Busca avançada.

A principal diferença entre elas é o número e o tipo de filtros disponíveis: a busca básica é muito mais simples e rápida, enquanto a busca avançada permite filtrar seus contatos de uma forma muito mais poderosa.

ÍNDICE

• 1. Adicionar
• 2. Importar
  • 2.1. Escolher método
  • 2.2. Mapa de colunas
  • 2.3. Revise e confirme
• 3. Editar em massa
• 4. Filtros rápidos
• 5. Exportar para CSV
• 6. Área de resultados
  • 6.1. Busca básica
  • 6.2. Busca avançada

Na aba Busca básica, a área de busca oferece campos condicionais básicos como nome, email, grupos, tags, data de criação, telefone e status de SMS, e telefone e status de WhatsApp.

Depois de definir as condições que serão usadas para filtrar, clique no botão Buscar para aplicá-las, ou em Limpar para remover todos os filtros.

Além da área de busca, há cinco botões de ação:

• Adicionar: permite criar um novo assinante.
• Importar: permite importar sua lista de contatos em massa.
• Editar em massa: aplica uma ação em massa aos contatos selecionados, ou a todos se nenhum estiver selecionado.
• Filtros rápidos: permite filtrar pelo status do contato (ativo, em lista negra, devolvido, inativo, relatado como spam ou cancelado).
• Exportar para CSV: exporta em formato CSV os contatos que atendem aos filtros definidos, se houver.

1. Adicionar

Permite adicionar um novo assinante e seus valores nos campos personalizados, que você poderá usar para personalizar suas newsletters de email, além de escolher em quais grupos ele será cadastrado.

Para adicionar um único assinante novo, basta clicar em +Adicionar e você verá os diferentes campos; apenas o campo Email é obrigatório. No entanto, você também precisará selecionar o grupo ou os grupos aos quais o assinante pertencerá.

Na parte superior você também pode informar o Fone SMS e o Telefone WhatsApp do contato e, em Informações adicionais, pode preencher dados como endereço, cidade, estado, país, tags, idioma, fuso horário, aniversário ou website.

Se você criou campos personalizados, eles também aparecerão aqui e você poderá preencher as informações correspondentes. Em qualquer caso, o novo assinante será adicionado depois que você clicar em Criar Assinante.

2. Importar

Se quiser adicionar mais de um assinante, clique em Importar. Essa opção abrirá um assistente de importação de contatos dividido em três etapas (1. Escolher método, 2. Mapa de colunas e 3. Revise e confirme).

2.1. Escolher método

Aqui você pode adicionar assinantes em massa de quatro formas diferentes: Copiar e colar, Importar arquivos (.csv, .txt), Importar da Mailchimp ou Importação do Hubspot.

Importar com a opção Copiar e colar é simples: basta colar um email por linha na área de dados e clicar em IMPORTAR DE TEXTO.

Já ao selecionar Importar arquivos (.csv, .txt), abre-se uma área de envio (Solte o arquivo aqui ou clique para selecionar um arquivo) onde você pode arrastar e soltar o documento que deseja importar, ou clicar dentro dessa área para abrir o explorador de arquivos e enviá-lo de lá.

A opção Importar da Mailchimp exige uma chave que você deverá inserir no campo Chave API da Mailchimp para que os dados possam ser importados da Mailchimp. Para obter essa chave API, faça login na sua conta da Mailchimp e acesse Profile >> Extras >> API keys >> Create A Key.

Em seguida, a chave API (uma sequência alfanumérica) será exibida na área Your API keys; copie-a e cole-a no Mailrelay (Chave API da Mailchimp).

Depois, pressione Enter e será aberto um menu suspenso com as suas listas da Mailchimp, onde você deverá selecionar a lista de contatos que deseja importar e clicar no botão de importação.

Por fim, a opção Importação do Hubspot permite trazer seus contatos diretamente da sua conta do HubSpot. Basta clicar em Entrar com o Hubspot, acessar sua conta e autorizar a conexão para continuar com a importação.

2.2. Mapa de colunas

Depois de carregar a lista de contatos com qualquer uma dessas opções, você chegará à etapa em que poderá associar cada coluna ao campo correspondente e escolher em qual grupo ou grupos deseja importar os contatos.

De acordo com os campos/colunas detectados, cada coluna será exibida em Etiqueta do arquivo e, ao lado de cada uma, na coluna Campo, você encontrará um menu suspenso para associá-la a um dos campos disponíveis. Na coluna Pré-visualizar dados você verá uma amostra do conteúdo de cada coluna para facilitar a associação. Se o arquivo tiver apenas uma coluna, o sistema considerará que se trata do campo de email.

Em seguida, selecione o grupo de destino dos assinantes em Importar para os grupos > Grupos e, se precisar adicioná-los a um grupo novo, marque a caixa Novo grupo e escreva o nome do grupo que deseja criar.

Antes de continuar, indique em Opções adicionais como deseja tratar os assinantes que já existem. Aqui você tem duas alternativas:

• Se não marcar a caixa Atualizar os dados dos assinantes existentes: os assinantes existentes serão ignorados e apenas os novos serão importados. Nesse caso, os assinantes que já estiverem nas suas listas de contatos do Mailrelay não serão importados.
• Se marcar a caixa Atualizar os dados dos assinantes existentes: o assinante será importado e aparecerão duas opções: Nada, quero manter os assinantes em seus grupos existentes e adicionar aos grupos selecionados e Remover assinantes de grupos existentes e adicionar aos grupos selecionados. Com a primeira, os assinantes que você está importando serão adicionados ao novo grupo (ou grupos) e continuarão nos grupos em que já estavam; com a segunda, serão removidos dos grupos em que estavam e adicionados apenas ao novo grupo (ou grupos).

Agora, marque a declaração: Confirmo que os dados a serem importados cumprem o GDPR e os regulamentos internacionais anti-spam e foram verificados com double opt-in (confirmação dupla), isentando a MailRelay de qualquer responsabilidade por qualquer dano, perda, responsabilidade, liquidação ou despesa (incluindo despesas adicionais) que possam surgir em relação a qualquer reclamação ou ação legal, se esse não for o caso.

Depois, conclua o mapeamento clicando em Importar. O sistema adicionará os assinantes e levará você diretamente para Revise e confirme.

2.3. Revise e confirme

Essa área mostra um relatório da importação, no qual você pode pesquisar os assinantes importados usando os filtros Linha, Email e Resultado (se foram importados ou não: Sucesso ou Falha) e clicando no botão Buscar.

Logo abaixo, você vê um resumo do resultado da importação com uma barra de progresso e, se houver alguma falha, a coluna Razão da falha explica o motivo. Você também pode baixar esse relatório com o botão Exportar para CSV e consultar a aba Registro.

Você pode voltar a consultar esse relatório a qualquer momento em Assinantes > Importações.

3. Editar em massa

Com essa opção você pode fazer ajustes em massa aplicando uma mesma ação a lotes de assinantes.

Depois de clicar no botão Editar em massa, será exibida uma janela pop-up que indica o número total de assinantes aos quais a edição em massa será aplicada.

Logo abaixo fica o menu suspenso Ação, onde você deve escolher a ação que deseja aplicar: Adicionar ao grupo, Remover do grupo, Adicionar tags, Remover tags, Atualizar campo, Remover assinante da lista negra, Remover assinante (mover para a lixeira) e Deletar permanentemente. Excluir um assinante (mover para a lixeira) coloca o assinante na lixeira, de onde você pode restaurá-lo; ele permanece lá por tempo indeterminado, até que você o exclua permanentemente ou até que a conta seja excluída. A exclusão permanente apaga os dados do assinante e torna suas estatísticas anônimas, sendo uma ação irreversível: esta é a opção que você deve utilizar quando uma pessoa exerce seu direito de exclusão (art. 17 do RGPD). Na API, o equivalente é DELETE /subscribers/{id} com o parâmetro permanent_delete: true.

Depois de escolher, clique em Enviar para aplicar a ação.

OBSERVAÇÃO: A edição em massa é aplicada a todos os emails selecionados; se não houver nenhuma seleção ativa, será aplicada a todos eles ou a grupos inteiros.

4. Filtros rápidos

Como o nome indica, esses filtros são aplicados de forma rápida e simples a todos os emails da base de dados ou a uma seleção/grupo que já tenha sido filtrado.

Com um clique, você segmenta pelo status do assinante: Ativo, Em lista negra, Devolvido, Inativo, Relatado como spam ou Cancelado. Basta selecionar qualquer um dos filtros e ele será aplicado imediatamente.

5. Exportar para CSV

Essa função permite exportar listas de assinantes com opções personalizadas, extraindo os contatos filtrados por algum modificador ou grupo selecionado (se não houver filtros, o sistema exportará todos).

Depois de clicar em Exportar para CSV, será aberta uma janela pop-up na qual você deverá selecionar os campos que deseja incluir no documento exportado.

Além disso, se quiser adicionar um cabeçalho para saber o que cada coluna exportada representa, marque a opção Incluir cabeçalhos.

Em Campos, selecione os campos que deseja adicionar ao documento (você pode usar Selecionar tudo; a lista também inclui os dados de grupos e o telefone e status de SMS e de WhatsApp) e clique no botão Exportar para CSV para baixá-lo.

Depois que o arquivo é gerado, é exibida uma mensagem de confirmação com um link de download direto (clique aqui para fazer o download), caso o download não comece automaticamente.

Você também pode acessar essa exportação em Outros >> Arquivos exportados (funciona como um histórico de exportações anteriores), onde é possível fazer o Download ou Deletar cada arquivo. Lembre-se de que o sistema remove esses arquivos automaticamente após sete dias.

6. Área de resultados

A área de resultados é composta por duas abas: Busca básica e Busca avançada.

6.1. Busca básica

Essa aba oferece os seguintes modificadores de busca: Nome, Email, Grupos, Tags, Criado (onde você pode indicar um período específico), Fone SMS, Status do SMS (Ativo e Cancelado), Telefone WhatsApp e Status do WhatsApp.

Também inclui os botões para iniciar a busca e remover os filtros selecionados: Buscar e Limpar, respectivamente.

Na área de resultados você vê estas colunas: ID, Nome, Email, Status, Fone SMS, Status do SMS, Telefone WhatsApp, Status do WhatsApp, Reputação do assinante, Criado, Atualizado em e Tags. Além disso, há três botões de ação: Exibir, Editar e Mover para a lixeira.

Se quiser mudar as colunas exibidas, clique no ícone de engrenagem à direita do cabeçalho da tabela. Será aberta a janela Selecione as colunas, onde você pode marcar ou desmarcar colunas (por exemplo, endereço ou cidade) e arrastá-las para mudar a ordem. Clique em Aplicar para salvar as alterações.

De acordo com os modificadores e filtros aplicados, as informações exibidas na área de resultados mudam automaticamente. Na parte inferior da área de resultados aparecem as páginas de resultados numeradas, junto com as setas de navegação.

Se você moveu algum assinante para a lixeira, pode recuperá-lo com o botão vermelho da lixeira no canto superior direito (Visualizar e restaurar assinantes excluídos).

Os assinantes permanecem na papelera até que as eliminações do formulário permanente (apartado 3) ou até que a conta seja eliminada.

6.2. Busca avançada

Na aba Busca avançada, a área de busca oferece várias condições que podem ser combinadas para refinar a busca com mais precisão.

As condições são organizadas em grupos de condições. Na parte superior você define se os assinantes devem atender a todos os grupos ou a qualquer um deles (Corresponder a todas ou Corresponder a qualquer uma destes grupos de condições) e, dentro de cada grupo, se devem atender a todas ou a qualquer uma das condições (Corresponder a todas ou Corresponder a qualquer uma destas condições neste grupo).

No início, só é exibida uma condição, mas você pode adicionar quantas quiser clicando no botão +Adicionar condição. Também pode adicionar grupos de condições com o botão +Adicionar grupo de condições.

Todas as condições de busca seguem a mesma estrutura: um condicional principal pertencente a uma das seções disponíveis: Assinante, Newsletter, Atividade geral e Campanha por SMS; um condicional secundário cujas opções de filtragem variam conforme o condicional principal selecionado; e um terceiro valor que depende do segundo condicional.

Como há muitas possibilidades para refinar as buscas, veja a seguir um exemplo que ilustra o processo de filtragem: buscar os assinantes que têm a tag Cliente e que foram criados depois de 01/09/2026.

Você pode excluir qualquer condição clicando na lixeira vermelha à direita. Depois de criar as condições desejadas, clique em Buscar para obter os resultados da busca avançada e, se quiser apagar todas as condições, clique em Limpar.

Os botões Adicionar, Importar, Editar em massa, Filtros rápidos e Exportar para CSV, assim como a forma como os dados são exibidos na área de resultados, funcionam exatamente igual à Busca básica.