Importando membros e pontos

A ferramenta de importação do RewardsWP permite que você traga membros e saldos de pontos de um arquivo CSV. Se você está migrando de outro plugin de fidelidade, integrando uma lista de clientes existente ou aplicando um crédito de pontos em massa, o fluxo de trabalho de importação em três etapas cuida do trabalho pesado. Após ler este guia, você saberá como preparar seu CSV, mapear colunas, processar a importação e solucionar quaisquer erros.

Antes de começar

A ferramenta de importação está disponível em todos os planos do RewardsWP. Para acessá-la, navegue até RewardsWP » Ferramentas em seu administrador do WordPress. A guia Importar é selecionada por padrão.

Antes de começar, certifique-se de ter:

• Um arquivo CSV com seus dados de membros e pontos. Se você ainda não tem um, fará o download de um modelo na próxima etapa.
• Pelo menos um identificador por linha para que o RewardsWP saiba qual membro creditar. Identificadores válidos são member_id, user_id ou email.
• Um valor de pontos por linha. A coluna points é obrigatória para cada importação.

Baixe o modelo e prepare seu CSV

Clique no botão Baixar exemplo de CSV na guia Importar para obter um arquivo CSV pré-formatado. O arquivo baixado é nomeado rewardswp-points-import-template-{DATE}.csv (onde {DATE} é a data de hoje) e inclui todas as 16 colunas disponíveis como cabeçalhos.

Colunas disponíveis

Coluna	Obrigatório	Descrição
id_do_membro	Condicional	O ID do membro do RewardsWP. Use este ID ao atualizar membros existentes.
id_do_usuario	Condicional	O ID do usuário do WordPress. Vincula o membro a uma conta existente do WordPress ou cria um novo membro se nenhuma correspondência for encontrada.
email	Condicional	O endereço de e-mail do membro. Corresponde a um membro existente por e-mail ou cria um novo.
primeiro_nome	Não	O primeiro nome do membro. Recomendado para novos membros.
ultimo_nome	Não	O sobrenome do membro. Recomendado para novos membros.
codigo_referencia	Não	Um código de referência personalizado para o membro.
status	Não	O status do membro (por exemplo, ativo, excluído).
pontos	Sim	O número de pontos a serem adicionados. Cada linha cria uma entrada de ponto separada.
tipo	Não	O tipo de transação de pontos.
tipo_origem	Não	De onde vieram os pontos (por exemplo, compra, manual).
id_origem	Não	Um ID que vincula os pontos a uma origem específica (por exemplo, um ID de pedido).
status_pontos	Não	O status da entrada de pontos (por exemplo, aprovado, pendente).
criado_em	Não	A data em que a entrada de pontos foi criada. Recomendado para importações históricas.
expira_em	Não	Quando os pontos expiram.
nota_publica	Não	Uma nota visível para o membro em seu log de atividades. Recomendado para clareza.
nota_interna	Não	Uma nota apenas para administradores. Não visível para membros.

Pelo menos uma coluna de identificação (member_id, user_id, ou email) deve estar presente ao lado da coluna obrigatória points. Você pode incluir qualquer combinação das colunas opcionais.

Preparando seus dados

Abra o modelo em um aplicativo de planilha e preencha seus dados. Algumas dicas:

• Uma linha por entrada de pontos. Se você precisar dar a um membro 500 pontos como um único saldo, use uma linha com points definido como 500. Se você quiser importar o histórico completo dele com várias transações, use uma linha por transação.
• Use identificadores consistentes. Escolha um tipo de identificador (e-mail geralmente é o mais fácil) e use-o consistentemente em todas as linhas.
• Formato da data. Use YYYY-MM-DD ou YYYY-MM-DD HH:MM:SS para as colunas created_at e expires_at.
• Salve como CSV. Certifique-se de que sua planilha seja exportada como um arquivo .csv padrão (valores separados por vírgula), e não .xlsx ou .xls.

Carregar e mapear colunas

Na aba Importar, carregue seu arquivo CSV usando o seletor de arquivos ou a área de arrastar e soltar. O RewardsWP valida o arquivo (formato CSV obrigatório) e lê os cabeçalhos das colunas.

Mapeamento de colunas

Após o upload, uma interface de mapeamento de colunas aparece. O RewardsWP detecta automaticamente quais colunas do CSV correspondem a quais campos de importação usando os cabeçalhos das colunas. Cada mapeamento mostra um nível de confiança:

Confiança	O que significa
Confiante	O cabeçalho da coluna é uma correspondência exata ou quase exata. Nenhuma ação é necessária.
Moderada	O cabeçalho é uma correspondência parcial. Revise o mapeamento para confirmar se está correto.
Baixa	O RewardsWP não conseguiu corresponder confiavelmente a esta coluna. Você precisará mapeá-la manualmente usando o menu suspenso.

Revise cada mapeamento e use os menus suspensos para corrigir quaisquer correspondências incorretas. Colunas não mapeadas são ignoradas durante a importação.

Visualize seus dados

Após o mapeamento, uma modal de pré-visualização mostra uma amostra dos seus dados com os mapeamentos aplicados. Revise a pré-visualização para confirmar que os valores caíram nas colunas corretas antes de prosseguir.

Revisar e processar a importação

Quando estiver satisfeito com o mapeamento de colunas e a pré-visualização, clique no botão para iniciar a importação. O RewardsWP processa o arquivo em lotes de 50 registros por solicitação, portanto, você verá um indicador de progresso rastreando a contagem enquanto ele processa seu arquivo.

Como o RewardsWP lida com cada linha

A lógica de importação depende de qual identificador você forneceu:

Identificador fornecido	O que acontece
id_do_membro	Atualiza o membro existente com esse ID. Se nenhum membro for encontrado, a linha é ignorada e registrada como um erro.
id_do_usuario	Procura um membro vinculado a esse usuário do WordPress. Se encontrado, atualiza esse membro. Se não encontrado, cria um novo membro vinculado ao usuário.
email	Procura um membro com esse endereço de e-mail. Se encontrado, atualiza esse membro. Se não encontrado, cria um novo membro com esse e-mail.

Quando vários identificadores estão presentes em uma única linha, `member_id` tem prioridade, seguido por `user_id`, depois `email`.

Cada linha no CSV cria uma entrada de ponto separada no histórico do membro. Se uma linha incluir campos opcionais como `first_name`, `last_name` ou `referral_code`, esses valores também serão aplicados ao registro do membro.

Após a importação

Quando a importação terminar, você verá um resumo mostrando o total de registros processados, o número de sucessos e o número de falhas.

Se alguma linha falhou, clique em **Baixar Relatório de Erros** para obter um arquivo CSV listando cada linha com falha e o motivo pelo qual ela foi ignorada. Razões comuns incluem:

• Valor ausente na coluna obrigatória `points`
• Nenhum identificador válido (`member_id`, `user_id` ou `email`) na linha
• `member_id` não corresponde a nenhum membro existente
• Formato de data inválido em `created_at` ou `expires_at`

Você pode corrigir os problemas no CSV do relatório de erros e reimportar apenas as linhas que falharam.

Após uma importação bem-sucedida, navegue até RewardsWP » Membros para verificar se seus membros e saldos de pontos importados aparecem corretamente.

Perguntas frequentes

---

É isso! A ferramenta de importação torna simples trazer membros e saldos de pontos de qualquer fonte.