Importar e criar perfis de usuário

Perfis de usuário podem ser criados manualmente, o que pode ser útil para testes rápidos durante a integração inicial; no entanto, listas maiores podem ser enviadas diretamente, e a API pode ser usada para manter automaticamente os perfis dos usuários sincronizados com seus perfis backend, além de importações automáticas podem ser configuradas.

Entrada manual

Navegue até Perfis de Dados > de Usuário e clique no botão Criar Perfil de Usuário .

Todos os campos são opcionais; Preencha os campos necessários para o novo perfil. Por exemplo, se estiver adicionando um perfil para e-mail, adicione o endereço de e-mail e defina a assinatura do e-mail para yes. Clique no botão Criar Perfil para salvar o novo perfil de usuário.

Número de Celular SMS
O número de celular para SMS deve ser adicionado no formato internacional E.164 com o código do país, sem o símbolo mais (+).
Exemplo: Um número 0850123456 de celular da Irlanda deve ser inserido com o 353 código de país da Irlanda como 353850123456.
Um número 07400123456 de celular do Reino Unido deve ser inserido junto com o 44 código de país do Reino Unido como 447400123456.

Importar perfis de usuário

Você também pode adicionar usuários de teste ou configurar uma lista inicial de usuários a partir de um arquivo CSV. O arquivo precisa ter um nome para cada coluna na primeira linha (ou cabeçalho da coluna). Uma coluna para user_id é necessária. Atributos de Perfil Personalizados ou atributos do sistema também podem ser definidos. Para isso, adicione mais colunas ao arquivo; O nome do atributo deve ser o cabeçalho da coluna. Inclua os valores de atributos para cada usuário.

Existem vários nomes de campos reservados que mapeiam atributos do sistema. Esses estão listados no guia de Atributos .

Abaixo está um exemplo de CSV que demonstra os atributos do sistema e inclui um atributo personalizado chamado first_name:

user_id,email,email_subscription,mobile_number,sms_subscription,language,timezone,first_name
fe56bc676be78,[email protected],1,353850123456,1,en,Europe/Dublin,Sam
fe56bc676be79,[email protected],1,353850123457,1,en,Europe/London,Laura

Formato CSV
Seu arquivo CSV deve seguir o formato padrão, o que a maioria dos softwares desktop faz automaticamente.
Se você precisar configurar seu formato CSV, os campos devem ser separados por vírgulas e citados usando aspas duplas quando contêm caracteres reservados. Detalhes técnicos podem ser encontrados no RFC 4180.
Arquivos enviados para o Xtremepush devem sempre ser salvos usando codificação UTF-8. Isso permite que quaisquer caracteres estendidos, como aqueles com sotaques, sejam processados corretamente pela plataforma.

Para importar o arquivo, vá em Perfis de Usuário > Dados e clique no botão Importar Perfis de Usuário . Esse processo tem duas etapas: selecionar a fonte de dados e mapear as colunas para os atributos.

Fonte de Dados

Após dar um nome à importação, escolha a fonte de dados:

A opção de Armazenamento de Arquivos permite que os usuários importem arquivos de um site SFTP configurado no marketplace de integrações, o que é útil para realizar importações de uma plataforma de terceiros. Para mais detalhes sobre como configurar isso, por favor, confira nosso guia dedicado.
Selecione Upload para escolher um CSV no seu computador.

Melhores práticas
Siga estas recomendações para evitar problemas comuns ao importar perfis de usuário:
Corte os espaços de abertura e de saída a partir dos valores dos campos.
Evite valores em branco, a menos que esteja especificamente tentando remover valores existentes ao atualizar perfis existentes.
Use maiúsculas consistentes para identificadores (como e-mail ou ID de usuário). Por exemplo, se perfis de usuário foram criados como user123, importações subsequentes usadas para atualizar usuários devem continuar usando user123 e não uma maiúscula diferente como User123 ou USER123.
O tamanho máximo recomendado é 10MB.

Mapeamento de dados

Depois de importar o arquivo de qualquer uma das fontes de dados, clique em Passo Seguinte para mapear os dados.

Se os cabeçalhos CSV corresponderem exatamente aos nomes dos atributos, os dados dos perfis de usuário serão mapeados automaticamente para campos. Caso contrário, os usuários podem optar por não importar os dados dessa coluna (essa opção é selecionada por padrão (Não importar)) ou mapear os dados para o campo desejado selecionando-os em um menu suspenso.

Atributos disponíveis
Só é possível selecionar atributos existentes no projeto, então certifique-se de criar quaisquer atributos de perfil desejados antes de importar os perfis de usuário.

Depois de terminar de mapear as colunas do arquivo CSV, clique em Executar importação para completá-lo.

Importações automatizadas

Uma importação regular de perfis de usuário de uma plataforma de terceiros pode ser configurada usando importações automáticas.

Via API

Para manter os perfis dos usuários sincronizados com seu próprio sistema backend, recomendamos o uso da API.

O método da API para importar perfis de usuário pode ser encontrado na referência da API de Importação de Perfil de Usuário .

Você pode encontrar informações gerais sobre as APIs do Xtremepush na Visão Geral da API Externa.

Importações simultâneas
Para evitar problemas, certifique-se de escalonar as automações em 5 minutos se for importar mais de um arquivo que inclua os mesmos perfis de usuário.

Status de importação de revisão

O status das importações de Perfis de Usuário pode ser acompanhado revisando o Histórico de Tarefas. Isso está disponível para importações manuais, automatizadas ou assíncronas da API, e aparece como a tarefa Importar perfis de usuário. Clique no menu Opções:fa-ellipsis-v: à direita de cada tarefa para revisar os detalhes

Detalhes da importação de tarefas

A página de detalhes da importação de tarefas oferece uma visão geral da importação:

Total: o número total de linhas importadas
Importado: o número de linhas que foram importadas com sucesso.
Avisos : linhas que foram importadas com um aviso
Total falhado: o número de linhas que falharam na importação devido a um erro
Falha devido a linhas duplicadas: linhas que não foram importadas devido a uma linha com os mesmos dados já existentes no arquivo importado. A primeira linha é importada e as seguintes são ignoradas.

Esta página também mostra uma visão geral dos erros e avisos vistos nesta importação.

O arquivo de relatório traz uma divisão detalhada de todos os usuários importados, junto com os detalhes dos usuários que receberam um aviso ou não foram importados, e devido a qual erro.