Como preencher o arquivo .csv do mailing

O mailing é uma opção que permite importação de dados de clientes em massa no CRM de atendimento PipeRun. Essa funcionalidade pode ser utilizada para importar contatos, como também é um passo necessário para o envio em massa de mensagens através das campanhas.

Confira neste artigo as regras de preenchimento e quais os campos obrigatórios para o cadastro do mailing.

Para saber mais sobre o cadastro de mailings, acesse este artigo.


VÍDEO TUTORIAL


TÓPICOS DO ARTIGO

  1. Como baixar o arquivo de exemplo
  2. Como preencher o arquivo .csv do mailing
  3. Regras de preenchimento e campo obrigatório
  4. Como salvar o arquivo no Excel desktop
  5. Como preencher o arquivo csv no Office 365 (online)
  6. Como preencher o arquivo cxv no Google Sheets
  7. Como preencher o arquivo csv no LibreOffice
  8. Como converter o arquivo de mailing para o formato de importação

COMO BAIXAR O ARQUIVO DE EXEMPLO

Para realizar a importação do Mailing é necessário baixar o arquivo de exemplo atualizado para então realizar o preenchimento do arquivo.

1. No painel administrativo, clique em "Ações em massa" (1). Após, clique na opção "Mailing" (2) Baixar o arquivo de modelo para importação.



Menu lateral do Painel Administrativo Piperun com opção Ações em massa destacada e submenu Mailings selecionado

2. Na listagem de mailings clique em "Adicionar".

Painel Administrativo - Ações em massa - Mailings com botão Adicionar destacado e tabela de campanhas de email


3. Na tela de adição do arquivo de importação clique em "Baixar arquivo de exemplo".

Tela de adição de Mailing com campo de descrição, área para upload de arquivo CSV e botão 'Baixar arquivo de exemplo'4. Selecione o local onde deseja salvar o arquivo e clique em "Salvar".

Janela de salvamento de arquivo Excel 'mailing_template_crm' com botão Salvar destacado em vermelho

Pronto! O arquivo foi salvo e você pode realizar o preenchimento dos dados que deseja importar.


COMO PREENCHER O ARQUIVO .CSV DO MAILING

Para importar um mailing, você precisa enviar informações sobre os contatos a serem importados para sua base de dados. O mailing funciona como uma importação, mas de maneira mais simples.

Você deverá ter no seu arquivo uma coluna para cada campo a ser importado. Os campos DATA_TYPE, VALUE , CUSTOMER_NAME e CUSTOMER_EXTERNAL_ID são de preenchimento obrigatório. O campo MESSAGE só será obrigatório se o DATA_TYPE for informado "SMS".

Os demais campos são de preenchimento opcional, porém não deverão ser removidos da planilha de mailing. Se não informar um campo curinga, por exemplo, basta deixar a coluna com as células vazias.

O preenchimento da planilha segue a seguinte lógica: cada coluna representará um campo e cada linha será uma informação. No exemplo abaixo, vamos simular como deveríamos informar os campos e-mail e WhatsApp de um mesmo cliente.

DATA_TYPEVALUECUSTOMER_NAMECUSTOMER_EXTERNAL_ID
EMAIL[email protected]Nome de Teste10
WHATSAPP51999999999Nome de Teste10


Atenção! Caso deseje informar mais de um e-mail para o mesmo cliente, adicione mais uma linha com o DATA_TYPE de e-mail, como abaixo:Tabela de exemplo com múltiplos contatos de cliente: dois emails e um WhatsApp para mesmo cliente


REGRAS DE PREENCHIMENTO E CAMPOS OBRIGATÓRIOS

Os campos que podem ser importados via mailing são:

  • DATA_TYPE (campo obrigatório): corresponde ao tipo de campo a ser cadastrado. As opções disponíveis são "EMAIL", "SMS", "WHATSAPP" e "TELEFONE";
  • VALUE (campo obrigatório): é o dado que corresponde ao campo informado em DATA_TYPE. Por exemplo, ao colocar DATA_TYPE como EMAIL, o VALUE deverá ser um endereço de e-mail válido;

Dica: quando o número de telefone informado incluir o DDI, é obrigatório iniciá-lo com o sinal “+”. Por exemplo: +5551999887755. Caso esse sinal não seja enviado, o sistema considerará que se trata de um número do Brasil (DDI 55).

DATA_TYPEVALUE
EMAIL[email protected]
TELEFONE+5551999887755
TELEFONE51999887756
  • MESSAGE: é a mensagem a ser enviada em massa. É de preenchimento obrigatório caso o DATA_TYPE informado seja do tipo SMS;

Você poderá configurar o tipo de mensagem enviada no momento de criação da campanha. Para saber mais, acesse este artigo
Se não estiver importando um arquivo para envio de campanhas via SMS, apague o conteúdo da coluna "Message".

  • CUSTOMER_NAME (preenchimento obrigatório): nome do cliente;
  • CUSTOMER_DOCUMENT_NUMBER: número do documento do cliente, podendo ser CPF ou CNPJ. Deverão ser informados apenas números, ou seja, 11 caracteres para CPF e 14 para CNPJ;
  • CUSTOMER_EXTERNAL_ID (campo obrigatório): código externo do cliente no CRM;
Atenção! Caso você informe no CUSTOMER_EXTERNAL_ID um ID externo já vinculado a um cliente, os dados informados serão incluídos no cadastro já existente.

Se você não tem código externo do cliente do seu CRM, informe o número do telefone ou o número do documento neste campo.

  • HASHTAG: informe uma hashtag para vincular ao cliente. Caso não esteja previamente cadastrada, ela será criada no momento da importação;

Os campos Wilcard_01 até WilCard_10 são campos customizados do cadastro de cliente, mas estão temporariamente indisponíveis para importação.

Não remova as colunas, apenas  as deixe sem preenchimento.

  • WILDCARD_01: campo curinga número 01;
  • WILDCARD_02: campo curinga número 02;
  • WILDCARD_03: campo curinga número 03;
  • WILDCARD_04: campo curinga número 04;
  • WILDCARD_05: campo curinga número 05;
  • WILDCARD_06: campo curinga número 06;
  • WILDCARD_07: campo curinga número 07;
  • WILDCARD_08: campo curinga número 08;
  • WILDCARD_09: campo curinga número 09;
  • WILDCARD_10: campo curinga número 10;

Para saber mais sobre o que são e como utilizar campos curingas, acesse este artigo.

  • ORGANIZATION_DOCUMENT_NUMBER: CNPJ da organização. É de preenchimento obrigatório se os campos ORGANIZATION_LEGAL_NAME ou ORGANIZATION_TRADE_NAME forem informados;
  • ORGANIZATION_LEGAL_NAME: razão social da organização. É de preenchimento obrigatório se os campos ORGANIZATION_DOCUMENT_NUMBER ou ORGANIZATION_TRADE_NAME forem informados;
  • ORGANIZATION_TRADE_NAME: nome fantasia da organização.

Para saber mais sobre o cadastro de organizações, acesse este artigo.

Após preencher a planilha, salve em formato CSV.


COMO SALVAR O ARQUIVO NO EXCEL (DESKTOP)

1.  Preencha todos os campos conforme a descrição do tópico 2.

Planilha Excel 'Mailing' com campos de tipos de dados, valores, mensagens e informações de clientes para envio de campanhas

2. Após preencher a planilha, clique em "Arquivo" e, após, em "Salvar como".

Planilha Excel com dados de tipos de contato (EMAIL, WHATSAPP) e respectivos valores em colunas A e B

Interface Excel com menu 'Salvar como' aberto, mostrando opções de salvamento e arquivos recentes como 'Planilha modelo - Mailing'
3. Selecione o local em que deseja salvar, como por exemplo "Este PC" (1), e em seguida, selecione na listagem de formatos a opção "CSV MS-DOS (.csv)" (2) e, após, clique em "Salvar" (3).

Tela Salvar como do Windows mostrando opção 'Este PC' destacada em vermelho para salvar arquivo

Diálogo Salvar como do Excel com formato CSV (MS-DOS) selecionado e botão Salvar destacado

Pronto! O arquivo foi salvo. Agora clique aqui, para saber como converter o arquivo para o formato de importação.


COMO COMO SALVAR O ARQUIVO NO MICROSOFT 365 (ONLINE)

1. Baixe o arquivo de importação e salve no seu computador.

Tela de adição de mailing no Painel Administrativo com campo de descrição e upload de arquivo CSV

2. Faça o login na sua conta da Microsoft 365.

Página inicial do Microsoft 365 Copilot com botão 'Entrar' destacado em vermelho para acesso à conta

3. No menu á esquerda, clique em Excel.

Menu lateral do M365 Copilot com Excel destacado em vermelho entre as opções de aplicativos

4. Clique em "Carregar um arquivo".

Tela inicial do Excel em português com opções para criar pasta de trabalho ou carregar arquivo, destacando botão 'Carregar um arquivo'5. Selecione o arquivo e clique em "Abrir".Janela do explorador de arquivos com arquivo 'mailing_template_crm.xlsx' selecionado e botão 'Abrir' destacado em vermelho

6. Clique na planilha "Exemplo de arquivo".

Planilha Excel com dados de template de mailing contendo colunas de tipo, valor, mensagem e informações de cliente, com abas de planilha destacadas na base

7.  Preencha todos os campos conforme a descrição do tópico 2.Planilha Excel com template de mailing contendo colunas de tipo dados, valor, mensagem, nome cliente, documento e hashtag

8. Clique em "Arquivo" (1), "Exportar" (2) e a seguir em "Baixar como CSV UTF-8".

Menu Arquivo do Excel com opção Exportar aberta e seleção de 'Baixar como CSV UTF-8'

9. Escolha o local e o nome do arquivo, por fim clique em "Salvar".

Diálogo de salvamento de arquivo CSV 'mailing_template.com' com botão Salvar destacado em vermelho

Pronto! O arquivo foi salvo. Agora clique aqui para saber como converter o arquivo para o formato de importação.


COMO SALVAR O ARQUIVO NO GOOGLE SHEETS

1. Faça login na sua conta para acessar o Google Drive.

Tela de seleção de conta Google com opção 'Usar outra conta' destacada em vermelho

2. Na tela do Google Drive clique em " + Novo".

Interface do Google Drive com menu lateral mostrando opção '+ Novo' destacada em vermelho

3. Clique em "Planilha Google".

Menu do Google Drive com opção 'Planilhas Google' destacada em vermelho

4. Na tela do Google Shets clique em "Arquivo" (1) e a seguir em "Abrir" (2).

Menu Arquivo do Google Sheets aberto mostrando opção Abrir destacada em vermelho

4. Clique em "Upload".

Interface do Google Drive mostrando a aba Recentes com botão Upload destacado em vermelho para fazer upload de arquivos

5. Clique em "Procurar" para fazer o Upload do arquivo de exemplo que será preenchido para importação.

Tela Google Drive com abas de navegação e botão 'Procurar' destacado para upload de arquivo de exemplo

6. Localize o arquivo no seu computador e clique em "Abrir".

Diálogo de seleção de arquivo com 'mailing_template_cm.xlsx' destacado e botão 'Abrir' em vermelho


7. Clique na planilha "Exemplo de arquivo".

Planilha Google Sheets com modelo de mailing contendo colunas de tipo de dado, valor, mensagem e informações do cliente

8. Realize o preenchimento do arquivo conforme descrito no tópico 2.

Planilha Google Sheets com template de mailing contendo colunas de tipo de dado, valor, mensagem e informações do cliente

Dica: Ao inserir um telefone no campo "Value", utilize o formato +DDIDDDFone (exemplo: +555399999999).
Para que o número seja aceito corretamente, pode ser necessário formatar a coluna como texto.

Para isso, siga o caminho: Formatar(1), Número(2) e Texto simples (3).
Depois, insira o telefone utilizando este padrão: '+DDIDDDFone.

Menu Formatar do Google Sheets com opções de formatação de números e texto simples destacadas para inserir telefones no padrão +DDIDDDFone

9. Após realizar o preenchimento clique em "Arquivo" (1), "Baixar" (2) e a seguir em "Valores separados por vírgulas (.csv)" (3).

Menu Arquivo do Google Sheets com opção Baixar expandida, mostrando formato CSV selecionado

10. Selecione o local onde deseja salvar o arquivo e clique em "Salvar".

Janela de salvamento de arquivo CSV 'Mailing_01' na pasta Área de Trabalho com botão Salvar destacado

Pronto! O arquivo foi salvo. Agora clique aqui para saber como converter o arquivo para o formato de importação.


COMO PREENCHER O ARQUIVO CSV NO LIBREOFFICE

1. No LibreOffice Calc, clique em "Arquivo" (1) e a seguir em "Abrir" (2).

Menu Arquivo do LibreOffice Calc aberto com opção Abrir destacada em vermelho

2. Localize o arquivo no seu computador e clique em "Abrir".

Planilha LibreOffice Calc com template de mailing contendo dados de contato, tipos de dados (EMAIL, TELEFONE, WHATSAPP) e mensagens personalizadas para clientes

3. Clique na planilha "Arquivo de exemplo".

Planilha LibreOffice Calc com template de mailing contendo dados de contato, tipos de comunicação (email, telefone, WhatsApp) e informações de clientes

4. Realize o preenchimento do arquivo conforme descrito no tópico 2.

Planilha LibreOffice Calc com dados de contatos: tipo (Email, Telefone, WhatsApp), valores, mensagens e informações do cliente John Connor

5. Após realizar o preenchimento clique em "Arquivo" (1) e a seguir em "Salvar Como" (2).

Menu Arquivo do LibreOffice Calc com opção 'Salvar Como' destacada em vermelho

6. Clique em "Tipo" e escolha a opção "Texto CSV(*.csv)".

Diálogo de salvamento em Google Drive mostrando seleção de formato de arquivo com 'Texto CSV (*.csv)' destacado na lista de tipos

7. Escolha o local onde deseja salvar o arquivo  e clique em "Salvar".

Caixa de diálogo 'Salvar como' do Google Drive mostrando pasta Área de Trabalho com opção Salvar destacada em vermelho

8. Na caixa de texto clique em "Utilizar formato CSV".

Caixa de diálogo confirmando formato de arquivo com opção 'Utilizar o formato Texto CSV' destacada em vermelho

9. Selecione as opções de campo (1), Conjunto de caracteres "Unicode(UTF-8)", delimitador de campo ";" e delimitador de texto ". Clique em "Ok" para concluir a exportação do arquivo.

Diálogo 'Exportar arquivo de texto' com opções de campo Unicode, delimitadores e checkboxes, botões OK e Cancelar

Pronto! O arquivo foi salvo. Agora clique aqui para saber como converter o arquivo para o formato de importação.


CONVERTER O ARQUIVO DE MAILING PARA O FORMATO DE IMPORTAÇÃO

Ao gerar o arquivo .csv, o delimitador padrão entre as colunas vem como “;” (ponto e vírgula) ou "," (vírgula).
Para que o arquivo seja importado corretamente no CXM de Atendimento, você precisa trocar esse separador por “|” (pipe).

Atenção! Não importa qual editor de planilhas você usou (Excel, Google Sheets ou outro), essa conversão sempre deve ser feita antes de importar o arquivo para o sistema.

Acompanhe o passo a passo para fazer esta conversão:

1. Localize o arquivo salvo e clique com o botão direito do mouse. Selecione a opção "Abrir com" (1), e depois clique na opção "Bloco de notas" (2).

Menu de contexto do Windows mostrando opções 'Abrir com' e 'Bloco de notas' destacadas para abrir arquivo

2. Clique em "Editar" (1), e após, em "Substituir" (2).

Menu Editar do VS Code com opções Desfazer, Recortar, Copiar, Colar, Excluir, Localizar e Substituir destacadas

3. Agora, em localizar informe ";" (ponto e vírgula)  ou "," e em substituir informe o "|" (pipe) conforme a imagem abaixo. Clique em "Substituir tudo".

Diálogo Localizar e Substituir com campo de busca vazio e pipe (|) no campo de substituição, com botões 'Substituir' e 'Substituir tudo'
4. Salve o arquivo. Pronto! Seu arquivo .csv já possui o delimitador "|" e está pronto para ser enviado como mailing.Arquivo CSV com delimitador pipe aberto no editor de texto mostrando estrutura de dados para mailing com campos de email, WhatsApp e variáveis wildcard

Pronto! O arquivo foi convertido para o formato correto. Acesse este artigo para saber como realizar a importação.


Em caso de dúvidas, chame nossa equipe no chat. 😉