> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Como trazer contatos de outro sistema

> Use o assistente para trazer contatos, negócios do funil, etiquetas e responsáveis de outro sistema, passo a passo e com conferência antes de gravar.

## Para que serve

Você usava outro sistema e quer levar seus clientes para o STChat sem digitar. O assistente **Trazer contatos de outro sistema** traz contatos, negócios do funil, etiquetas, campos e responsáveis. Nada é gravado antes de você conferir.

Se você só tem uma planilha simples de contatos, veja também [Como importar contatos por CSV](https://docs.stchat.app/subcontas/importar-contatos-csv.md).

> [!NOTE]
>
> O assistente aceita só arquivo **.csv**. O seletor de arquivo não abre outros tipos. Se o seu sistema exporta em Excel, abra o arquivo e salve como CSV antes.

## Quem pode

Só Dono, Admin e Supervisor podem importar. Para os outros perfis a tela mostra o aviso **Só Dono, Admin e Supervisor podem importar.**

Desfazer uma importação é de quem importou, do Dono ou do Admin.

## Onde clicar

O assistente abre numa janela sobre **Contatos**, no endereço `/contacts?importar=sistema`. Você chega por dois caminhos:

* Na [Primeira semana](https://docs.stchat.app/subcontas/primeira-semana.md), no passo **Traga seus contatos**, escolha **Vim de outro sistema** e clique em **Continuar**.
* Pelo endereço acima, se alguém da equipe ou da agência te enviou o link.

## Passo a passo

**1. Origem**

Em **De onde vêm os seus contatos?**, escolha o cartão do sistema de onde você exportou. Se você só tem um arquivo, escolha **Planilha** (**CSV ou Excel** aparece como dica no cartão, mas o arquivo precisa ser CSV). **Agenda do celular** abre só no app. Clique em **Avançar**.

**2. Como exportar e Arquivos**

A tela mostra **Como exportar**, com os passos para tirar o arquivo do outro sistema. Depois, em **Seus arquivos**, clique em **Solte o arquivo aqui ou clique para escolher** no quadro **Contatos**. Quando a origem tem negócios, há outro quadro, **Negócios (opcional)**. O limite é de até 50 mil linhas por arquivo. O envio começa na hora e aparece **Enviando… e lendo as colunas**. Para parar, use **Cancelar o envio**; para trocar, **Tirar o arquivo**. Quando o arquivo é lido, a tela confirma quantas linhas e de qual origem ele parece ser.

**3. Mapear**

O sistema sugere como ligar cada coluna do arquivo a um campo do contato. Há quatro abas: **Colunas**, **Funil**, **Etiquetas** e **Responsáveis**. Em **Colunas**, troque o **Campo do contato** de cada **Coluna do arquivo**, crie um campo novo ou marque **Não importar**. Em **Funil**, crie um funil igual ao do outro sistema ou use um que já existe. Em **Etiquetas**, deixe marcado **Criar as etiquetas que ainda não existem**. Em **Responsáveis**, escolha quem é o responsável de cada nome; quem não tiver par fica **Sem responsável**.

**4. Conferir**

Em **Confira antes de importar** você vê quantos contatos entram, quantos são novos, quantos já existem e serão atualizados e quantos estão repetidos no arquivo (unidos). Também vê negócios, responsáveis encontrados e telefones inválidos. Escolha a **Base legal (LGPD)**, que é obrigatória. Marque ou desmarque **Atualizar quem já existe** (só preenche campos vazios; etiquetas somam, nunca saem) e **Não disparar automações para os importados**. Se o arquivo tem consentimento, a tela resume quem aceita, quem saiu e quem está sem registro.

**5. Importar**

Clique em **Importar N contatos**. A importação roda em segundo plano e pode ser desfeita em até 24 h. Em base grande, a tela avisa que leva uns 15 minutos.

## O que acontece depois

A tela mostra **Importando…** com o andamento. Você pode fechar: o aviso de que terminou aparece no sistema e no celular.

Ao final aparece **Importação concluída**, com contatos criados e atualizados, negócios no funil, responsáveis não encontrados e linhas com erro. Clique em **Ver os contatos importados** para abrir a lista.

**Histórico.** Todas as importações ficam em **Importações**, no endereço `/contacts?lista=importacoes`. Você chega também por **Ver importações**, no primeiro passo do assistente. A tabela tem **Data**, **Origem**, **Quem fez · números** e **Situação** (**Concluída**, **Em andamento**, **Parou** ou **Desfeita**). Em cada linha:

* **Desfazer (até …)**: remove os contatos e negócios criados e devolve os atualizados como estavam. Contatos que já conversaram depois ficam, com um aviso.
* **Baixar erros**: baixa um CSV com as linhas que não entraram e o motivo. Corrija e importe de novo.
* **Retomar**: continua uma importação que parou, de onde parou.

As datas aparecem no fuso do navegador de quem usa.

## Erros comuns

* **Trazer de outro sistema ainda não está disponível.** O recurso ainda não está ativo para você. Fale com a agência.
* **Não deu para carregar as origens.** Clique em **Tentar de novo**.
* **Este arquivo não abre.** O arquivo não foi aceito. Exporte de novo e salve como CSV.
* **O arquivo passa de 50 mil linhas. Divida em partes.**
* **Já existe uma importação em andamento nesta empresa. Espere terminar.**
* **Não deu para continuar agora. Nada foi gravado.** Tente de novo.
* **Não reconhecemos N colunas. Escolha o campo de cada uma ou marque "Não importar".** Ajuste na aba **Colunas**.
* **N telefones inválidos**: vão para a lista de erros, para baixar depois.
* **Passou de 24 h: já não dá para desfazer.**
* **A importação parou em N%. Nada se perdeu.** Use **Retomar** no histórico.

## Próximo passo

* [Como importar contatos por CSV](https://docs.stchat.app/subcontas/importar-contatos-csv.md)
* [Contatos](https://docs.stchat.app/subcontas/contatos.md)
* [Ficha do contato](https://docs.stchat.app/subcontas/ficha-do-contato.md)
* [Kanban](https://docs.stchat.app/subcontas/kanban.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.