Importar contatos

Carregue um único arquivo CSV para registrar contatos como assinantes de e-mail, SMS, WhatsApp e Viber de uma só vez. Mapeie cada coluna que contém um endereço de contato para o canal ao qual pertence. A mesma coluna, como um número de telefone, pode ser mapeada para mais de um canal, então você não precisa mais de um arquivo separado para números de SMS e WhatsApp que são o mesmo número.

Prepare seu arquivo CSV

Regras de formatação de CSV

Estrutura geral

A primeira linha deve conter os cabeçalhos das colunas descrevendo os dados em cada coluna.
Cada linha subsequente representa um único contato, com valores correspondentes aos cabeçalhos.
Os valores devem ser separados por vírgulas.
Salve o arquivo com codificação UTF-8 para garantir a exibição correta dos caracteres.
O tamanho máximo do arquivo é de 100 MB.

Colunas de contato

Inclua pelo menos uma das seguintes colunas, dependendo dos canais para os quais você deseja registrar o contato:

E-mail: o endereço de e-mail do destinatário.
Número de telefone (para SMS, WhatsApp e Viber): deve estar no formato internacional, começando com + seguido pelo código do país, por exemplo, +120XXXXX234. Insira o número de telefone simples. O Pushwoosh adiciona o prefixo whatsapp: ou viber: internamente assim que você mapeia a coluna para esse canal, então não o adicione você mesmo.

Um número de telefone que não está em um formato internacional válido é descartado para aquele canal durante a importação, em vez de fazer com que a linha inteira falhe.

Colunas opcionais

ID do Usuário: um identificador único para o usuário (por exemplo, nome ou e-mail). Não é obrigatório, mas recomendado para que os canais do contato compartilhem um perfil de usuário em vez de vários.
Qualquer outra coluna pode ser mapeada para uma tag de sistema para segmentação e personalização, por exemplo, Localização, Aniversário, Idioma ou Tipo de cliente.

Exemplo de arquivo CSV

Email,Mobile,User ID,Name,Location
john.smith@email.com,+120XXXXX234,john.smith@email.com,John Smith,New York
jane.smith@email.com,+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles

Carregar e mapear o arquivo CSV

Vá para Público → Importar CSV → Importar Contatos.

Hub de Importação de CSV na seção Público mostrando o cartão Importar Contatos ao lado de Atualizar valores de tags, Importar assinantes de push, Importar eventos e Importar categorias de assinatura

Clique em Carregar CSV e selecione seu arquivo. Para substituí-lo, clique em Carregar outro CSV.
Insira um Nome do segmento para os contatos importados.
Em Coluna de contato no CSV, selecione uma coluna e, ao lado dela, escolha o Canal que ela registra (E-mail, SMS, WhatsApp ou Viber). Clique em + Adicionar canal para mapear outra coluna, ou para mapear a mesma coluna para um canal adicional.
Em Coluna de UserId no CSV, selecione a coluna com identificadores de usuário únicos, se o seu arquivo tiver uma.
Para incluir dados extras para segmentação, selecione um Nome da Coluna do seu CSV e atribua a ele uma Tag. Clique em + Adicionar Coluna para mapear mais atributos.

Etapa de mapeamento do assistente de Importação de Contatos com uma coluna mapeada para E-mail, uma coluna Celular mapeada para SMS, WhatsApp e Viber, e uma coluna Cidade mapeada para uma tag

Clique em Iniciar Importação para começar a processar o arquivo.

Após a importação, os contatos ficam disponíveis para campanhas nos canais que você mapeou. Eles aparecem como um novo segmento na lista de Segmentos e também podem ser acessados através do Explorador de Usuários.

Linhas ignoradas durante a importação

A tela de conclusão agrupa as linhas ignoradas por motivo:

Endereço de e-mail não é válido
Número de telefone não é válido
Nenhum endereço de contato na linha: todas as colunas mapeadas estavam vazias

Uma linha pode ser parcialmente importada e ainda aparecer nesta análise. Por exemplo, a coluna de e-mail é bem-sucedida, mas a coluna de telefone falha na validação.

Clique em Baixar linhas ignoradas para obter um CSV apenas com essas linhas. O arquivo adiciona o motivo da exclusão como uma coluna extra para que você possa corrigir as linhas e carregá-las novamente.

Linhas que a importação não conseguiu registrar

Algumas linhas parecem corretas no arquivo, mas ainda assim não são processadas. Por exemplo, um endereço de e-mail pode estar escrito corretamente e ainda ser rejeitado porque pertence a um domínio descartável ou que retornou erro (bounced). O Pushwoosh conta linhas como esta como Falhas, separadamente de Adicionadas ou Ignoradas.

As linhas com falha não são detalhadas por motivo e não são incluídas no download de linhas ignoradas. Para encontrá-las, compare seu CSV de origem com o segmento importado. Corrija os endereços ausentes (por exemplo, remova um domínio descartável ou que retornou erro) e, em seguida, carregue novamente apenas essas linhas em uma nova importação.