--- title: "Importar e criar perfis de usuário" slug: "user-profile-create" updated: 2026-06-12T10:30:51Z published: 2026-06-12T10:30:51Z canonical: "docs.xtremepush.com/user-profile-create" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. > [!NOTE] > 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](/documentation/docs/pt-br/attributes-tags) Personalizados ou [atributos do sistema](/documentation/docs/pt-br/attributes-tags#system-attributes) 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](/documentation/docs/pt-br/attributes-tags#system-attributes) . Abaixo está um exemplo de CSV que demonstra os atributos do sistema e inclui um atributo personalizado chamado *first_name*: ```CSV 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 ``` > [!NOTE] > 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](https://tools.ietf.org/html/rfc4180). > > 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](/documentation/docs/pt-br/sftp-file-storage). - **Selecione Upload** para escolher um CSV no seu computador. > [!TIP] > 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. > [!WARNING] > 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](/documentation/docs/pt-br/automated-imports). ## 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](/ref:user-profile-import) . Você pode encontrar informações gerais sobre as APIs do Xtremepush na [Visão Geral da API Externa](/documentation/docs/pt-br/external-api-overview). > [!WARNING] > 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](/documentation/docs/pt-br/task-history). 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. ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/f4d7ef9-Screenshot_2024-01-03_at_4.33.06_PM(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A42Z&se=2026-11-04T10%3A28%3A42Z&sr=c&sp=r&sig=QCvz8nD0GzJvpz6BDK0P46eObr4aQ5kP1UcLVk2yRFM%3D) 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.