# Importar clientes de uma planilha

> Vá em Clientes e clique em Importar. Envie um arquivo CSV, Excel ou JSON, ou uma exportação de clientes do Shopify ou do WooCommerce do jeito que está, associe as colunas, confirme o consentimento de marketing e clique em Iniciar importação. Clientes existentes são identificados pelo e-mail e atualizados.

Central de Ajuda / Pedidos e clientes - Atualizado em 29 de outubro de 2026

Está migrando para o Shoprocket de outra plataforma, ou mantém clientes em uma planilha? Importe todos de uma vez, com endereços, tags, observações e a escolha de marketing. A mesma importação atualiza clientes que você já tem, identificados pelo e-mail.

## Antes de começar

- Seu arquivo pode ser um CSV, um arquivo do Excel (`.xlsx`, `.xls`) ou um arquivo JSON, de até 10 MB. Salve os arquivos CSV em UTF-8.
- Para ver o formato esperado, vá em **Clientes**, clique em **Importar** e depois em **Baixar modelo CSV**.
- **Do Shopify ou do WooCommerce:** envie a exportação de clientes deles do jeito que está. Depois traga também o histórico de pedidos: veja [Importar seu histórico de pedidos](https://v3.shoprocket.io/pt/ajuda/importar-seu-historico-de-pedidos.md).
- Para editar clientes que você já tem, comece por **Exportar** na página de Clientes. A exportação usa as mesmas colunas, então volta na importação sem mudar a associação.
- Importe só pessoas que concordaram em receber contato seu. Importar listas de contatos compradas ou coletadas sem consentimento é contra os nossos Termos de Serviço.

## Como o arquivo é organizado

- A primeira linha deve ser o cabeçalho das colunas.
- Um cliente por linha. Toda linha precisa de um **E-mail**: é assim que o Shoprocket distingue os clientes.
- Use `yes` ou `no` em **Accepts Marketing**.
- Separe várias tags com ponto e vírgula, por exemplo `VIP;Wholesale`. As tags separadas por vírgula do Shopify também funcionam. As tags que ainda não existem são criadas.
- Cada cliente recebe um endereço, salvo como padrão. Os códigos de país têm duas letras, como `US` ou `CA`.

Por exemplo:

```
Email,First Name,Last Name,Phone,Accepts Marketing,Tags,Note,Address Line 1,City,State,Postal Code,Country Code
jane@example.com,Jane,Smith,+1-503-555-0100,yes,VIP;Wholesale,Buys for her cafe,123 SE Hawthorne Blvd,Portland,OR,97214,US
bob@example.com,Bob,Jones,,no,,,,,,,
```

## Etapa 1: Envie o arquivo

1. Vá em **Clientes** e clique em **Importar**.
2. Clique em **Escolher um arquivo CSV, Excel ou JSON** e escolha o arquivo, depois clique em **Enviar e continuar**.

   Ou cole um endereço da web em **Ou cole um link para um arquivo CSV, Excel ou JSON** e clique em **Buscar e continuar**. O link precisa abrir sem login.

## Etapa 2: Associe as colunas

A lista **Associar colunas do CSV** mostra cada coluna do seu arquivo com alguns valores de exemplo. Use **Associar a** ao lado de cada uma para escolher o campo do cliente que ela preenche, ou **(Ignorar esta coluna)**. As colunas que o Shoprocket reconhece, incluindo as do Shopify e do WooCommerce, são associadas para você e marcadas como **Detectado automaticamente**; confira-as de qualquer forma.

Os campos que você pode associar:

- **Cliente**: **E-mail** (obrigatório), **Nome**, **Sobrenome**, **Telefone**, **Aceita marketing**, **Observação** (interna, nunca mostrada ao cliente) e **Tags**.
- **Endereço**: **Empresa**, **Endereço, linha 1**, **Endereço, linha 2**, **Bairro**, **Cidade**, **Estado / província**, **CEP / código postal**, **Código do país** e **Telefone do endereço**.

Se você escolheu o arquivo errado, clique em **Trocar arquivo**.

![A etapa Associar colunas do CSV para clientes, com e-mail, nomes e tags associados, o painel Configurações de importação e a caixa de consentimento de marketing](https://v3.shoprocket.io/img/help/import-customers/map-columns.webp)

## Etapa 3: Escolha como a importação funciona

Em **Configurações de importação**, escolha um **Modo de importação**:

- **Importar tudo (criar + atualizar)**: clientes novos são criados e os que você já tem são atualizados.
- **Somente criar novos**: linhas que correspondem a um cliente existente são ignoradas.
- **Somente atualizar existentes**: só os clientes que correspondem são atualizados, e linhas sem correspondência são ignoradas.

Os clientes existentes são identificados pelo **E-mail**. Quando um cliente é atualizado:

- Células vazias mantêm o que já existe, então um arquivo só com E-mail e Telefone muda apenas os telefones.
- As tags do arquivo são adicionadas. As tags que o cliente já tem nunca são removidas.
- O endereço padrão dele é atualizado com as células que você preencheu.
- A escolha de marketing dele nunca é alterada. **Aceita marketing** só é registrado para clientes que a importação cria, então um arquivo não pode inscrever nem cancelar a inscrição de ninguém sem que a pessoa saiba.

Marque a caixa confirmando que os clientes marcados como inscritos em marketing deram consentimento para receber e-mails de marketing da sua empresa. Você não pode iniciar a importação sem isso. Depois clique em **Iniciar importação**.

## Etapa 4: Confira o resultado

A página mostra o andamento da importação e depois quantos clientes foram **Criados**, **Atualizados** e **Com falha**, e quantos foram ignorados pelo modo de importação. Enquanto ela roda, **Cancelar importação** a interrompe.

Uma linha falha quando o e-mail está faltando ou não é um endereço válido. Se alguma linha falhou, clique em **Baixar relatório de erros**, corrija essas linhas no arquivo e importe de novo.

Clique em **Ver clientes** para vê-los, ou em **Importar outro arquivo**. Os clientes importados ficam **Ativo** e podem entrar na sua loja com o e-mail: veja [Deixe os clientes entrarem para ver seus pedidos](https://v3.shoprocket.io/pt/ajuda/deixe-os-clientes-entrarem-para-ver-seus-pedidos.md).

## Vindo do Ecwid?

O cartão **Vindo do Ecwid?** fica na página **Importar produtos**. Quando encontra clientes na sua loja Ecwid, ele os traz junto com os produtos, depois que você marca a mesma caixa de consentimento.

## Relacionados

- [Gerenciar seus clientes](https://v3.shoprocket.io/pt/ajuda/gerenciar-seus-clientes.md)
- [Agrupar clientes com tags](https://v3.shoprocket.io/pt/ajuda/agrupar-clientes-com-tags.md)
- [Importar seu histórico de pedidos](https://v3.shoprocket.io/pt/ajuda/importar-seu-historico-de-pedidos.md)
- [Importar produtos de uma planilha](https://v3.shoprocket.io/pt/ajuda/importar-produtos-de-planilha.md)

[Abrir Importar clientes no seu painel](https://app-v3.shoprocket.io/go/customers/import)

---

- HTML version: https://v3.shoprocket.io/pt/ajuda/importar-clientes-de-uma-planilha
- Language: Português (pt)
- Also in: [العربية](https://v3.shoprocket.io/ar/help/import-customers.md), [Deutsch](https://v3.shoprocket.io/de/hilfe/kunden-aus-einer-tabelle-importieren.md), [Ελληνικά](https://v3.shoprocket.io/el/help/import-customers.md), [English](https://v3.shoprocket.io/help/import-customers.md), [Español](https://v3.shoprocket.io/es/ayuda/importa-clientes-desde-una-hoja-de-calculo.md), [Français](https://v3.shoprocket.io/fr/aide/importer-des-clients-depuis-un-tableur.md), [עברית](https://v3.shoprocket.io/he/help/import-customers.md), [हिन्दी](https://v3.shoprocket.io/hi/help/import-customers.md), [Bahasa Indonesia](https://v3.shoprocket.io/id/bantuan/impor-pelanggan-dari-spreadsheet.md), [Italiano](https://v3.shoprocket.io/it/aiuto/importare-i-clienti-da-un-foglio-di-calcolo.md), [日本語](https://v3.shoprocket.io/ja/help/import-customers.md), [Lietuvių](https://v3.shoprocket.io/lt/pagalba/importuokite-klientus-is-skaiciuokles.md), [Norsk](https://v3.shoprocket.io/nb/hjelp/importer-kunder-fra-et-regneark.md), [Nederlands](https://v3.shoprocket.io/nl/hulp/klanten-importeren-uit-een-spreadsheet.md), [Polski](https://v3.shoprocket.io/pl/pomoc/zaimportuj-klientow-z-arkusza.md), [Română](https://v3.shoprocket.io/ro/ajutor/importa-clienti-dintr-un-tabel.md), [Русский](https://v3.shoprocket.io/ru/help/import-customers.md), [ไทย](https://v3.shoprocket.io/th/help/import-customers.md), [Türkçe](https://v3.shoprocket.io/tr/yardim/musterileri-bir-elektronik-tablodan-ice-aktarin.md), [中文](https://v3.shoprocket.io/zh/help/import-customers.md)
