Lista de Contatos

Para receber destinatários via lista de contatos, é necessário escolher entre uma ou mais planilhas que foram adicionadas anteriormente ao seu banco de contatos da Zenvia. Este artigo te ensina como inserir uma lista de contatos pra incluir na jornada.
Para enviar uma planilha para a nossa plataforma, na barra lateral esquerda, acesse o ícone Configuração e clique em Lista de Contatos.
No centro da tela, você verá todas as planilhas que foram importadas divididas por:
Nome da lista;
Status:
1. Processado: o arquivo já foi processado e está pronto para uso;
2. Configurando: em processo de configuração;
3. Aguardando processamento: o arquivo está na fila para ser processado.
Erros: indica a quantidade de erros, caso existam, da planilha importada;
Processados: indica a quantidade de dados processados;
Total: exibe a quantidade de dados da planilha. Assim, você pode comparar a soma de erros com a de processados.
Adicionar nova lista de contatos
Para começar clique em + Nova Lista de Contatos, no canto superior direito da tela.
 Boas práticas para criação da planilha:
Crie um arquivo em .csv com formatação UTF-8 com BOM;
É obrigatório ter uma coluna de ID para identificação do destinatário;
É obrigatório ter pelo menos uma coluna de telefone ou e-mail;
É obrigatório ter um título em cada coluna, sem espaço entre as palavras (Exemplo: datadenascimento)
Não deixe linhas em branco;
O processo de importação da lista de contatos possui três etapas. A seguir, conheça cada uma.
Importar dados
Clique em Procurar Arquivo e escolha a planilha com os dados dos clientes.
Ao carregar, selecione a opção que deseja fazer:
Efetuar disparo: utilizar a lista de contato para efetuar disparo imediato;
Criar regra: utilizar a lista de contato para criação de regras (disponível para disparos também).
Mais adiante, você verá como mapear as colunas, etapa seguinte após selecionar uma das opções acima.
Erros ao importar dados
Sua planilha só será processada caso tenha seguido os critérios no arquivo. Caso contrário, uma mensagem de erro aparecerá no canto superior da tela.
Conheça os erros mais comuns:
1. O arquivo está em formato incorreto. Certifique-se de que seja um arquivo .csv, com formatação UTF-8 com BOM;
2. Os dados de uma coluna já são utilizados em outra coluna;
3. Os campos a serem utilizados para as colunas específicas a eles não foram definidos;
4. A(s) coluna(s) podem estar duplicadas;5. O atributo ID não está associado a uma coluna;6. O atributo NAME não está associado a uma coluna.
No processamento, todos os requisitos listados acima precisam estar com o “check”. Caso contrário, não é possível importar a planilha.
Mapear colunas
Nessa etapa, você deve verificar se os atributos identificados pela plataforma estão de acordo com as colunas que foram importadas da planilha. Independente do objetivo escolhido, “Efetuar disparo” ou “Criar regra”, essa será a próxima etapa após importar a planilha.
Você obrigatoriamente precisa mapear as colunas ID, Nome e pelo menos uma de e-mail ou telefone para conseguir efetuar os disparos.
No lado esquerdo da tela há um campo com o nome e informações das colunas da sua planilha, conforme está no arquivo. No lado direito, você verá uma lista com os atributos do jornadas.
Definir atributos
Para isso, clique e arraste o atributo do lado direito para as colunas do lado esquerdo da página.
Caso você arraste um atributo para a coluna errada, clique no X para remover o atributo e siga as instruções citadas anteriormente.

Confirme se o mapeamento dos atributos correspondem ao formato da coluna. (Exemplo: Coluna de "Nome" deverá ser associado ao atributo com formato de texto). Lembre-se de associar o atributo de ID, e-mail e/ou telefone às colunas correspondentes.
Quando todas as colunas estiverem corretas, clique em Continuar. Com isso, você verá uma tela que demonstra o status de processamento da planilha.
Dependendo do tamanho da planilha, a ação pode demorar alguns minutos, e você pode deixá-la em segundo plano, clicando no botão Deixar em Segundo Plano na parte inferior da tela.
Novo atributo
Caso precise associar algum atributo que não esteja na lista, você pode criar um novo.
Para isso, clique em + Novo Atributo, logo acima da lista de atributos.
Escolha um nome, também será necessário escolher uma formatação. Os tipos disponíveis são:
Texto: qualquer combinação de letras e números abaixo de 255 caracteres;
Número: numerais inteiros e decimais;
Data: um dia, mês e ano específico.
Após o preenchimento desses campos, clique em Continuar.
A associação incorreta entre as colunas e atributos pode ocasionar problemas nos disparos das comunicações.
Resultados
Após a verificação e processamento, caso os dados estejam corretos, você verá a mensagem “Processamento concluído".
Logo abaixo, verá uma lista de amostra com destinatários que estão com todos os dados preenchidos.
Caso você receba a mensagem “Atenção! Sua planilha possui muitos campos vazios”, revise sua planilha e exclua as linhas em branco. Destinatários com colunas de atributos sem preenchimento também apresentarão esse erro.
Se a sua planilha apresentar algum erro apontado acima, é possível realizar o download e a correção para um novo upload. Nela, serão apontadas as linhas que precisam ser corrigidas.
Após clicar na opção “Baixar lista com erros”, o download se iniciará automaticamente. Ao abrir a planilha, será apontada a correção.
No exemplo acima, o campo “Identificação”, propriedade obrigatória, não foi informado.
Depois que sua planilha for verificada e processada com sucesso, ela estará disponível para uso ao criar uma jornada.
Você pode incluir uma nova lista de contatos em uma jornada ativa sem a necessidade de versionamento.
Webhook
Motor de Regras
Last modified 6mo ago