**Para migrar suas conversas e contatos de outra plataforma para a Papo (https://papo.global/), você pode exportar os dados do sistema antigo, importar os contatos em massa via arquivo CSV e utilizar a API da Papo para recriar o histórico de conversas, garantindo que nenhuma informação seja perdida na transição.** A migração de uma plataforma de atendimento anterior para a Papo envolve três etapas principais: extrair os dados do sistema de origem, carregar os contatos no CRM da Papo e, se necessário, trazer o histórico de interações usando a API. A Papo oferece ferramentas que simplificam esse processo, evitando a digitação manual e preservando o contexto dos relacionamentos com os clientes. ## Resumo da migração | Etapa | Ação | Onde na Papo | | :--- | :--- | :--- | | 1. Exportar do sistema antigo | Gerar arquivo CSV com contatos e, se possível, histórico de conversas. | — | | 2. Preparar o CSV | Organizar colunas (nome, e-mail, telefone, tags) e padronizar dados. | — | | 3. Importar contatos em massa | Fazer upload do CSV e mapear os campos. | Módulo Contatos > Importar | | 4. Migrar histórico (opcional) | Usar a API para criar contatos e mensagens programaticamente. | API (chave pública e secreta) | | 5. Verificar a migração | Conferir se os contatos e as conversas aparecem corretamente. | Módulos Contatos e Conversas | ## Como funciona – passo a passo ### 1. Exporte os dados do seu sistema atual A maioria das plataformas de CRM e atendimento permite exportar contatos e conversas para CSV ou disponibiliza uma API para extração. Consulte a documentação do seu sistema antigo para gerar esses arquivos. O ideal é obter: - Lista de contatos com nome, e-mail, telefone e etiquetas (tags). - Se possível, um arquivo com o histórico de mensagens (data, remetente, texto). Caso o sistema não ofereça exportação de conversas, você ainda pode migrar os contatos e iniciar as novas interações na Papo com todo o contexto disponível no CRM. ### 2. Prepare o arquivo CSV para importação de contatos A qualidade da importação depende da organização do arquivo. Antes de subir a lista, verifique: - **Formato**: salve como `.csv` (valores separados por vírgula). - **Cabeçalhos**: a primeira linha deve conter os nomes das colunas, como `nome`, `email`, `telefone`, `tags`. - **Dados limpos**: remova células mescladas, linhas em branco e formatações especiais. Padronize os números de telefone com código do país e DDD (ex.: 55119XXXXXXXX). Exemplo de estrutura: | nome | email | telefone | tags | | :--- | :--- | :--- | :--- | | Maria Silva | maria.silva@email.com | 5511987654321 | lead-quente, evento-sp | | João Costa | joao.costa@email.com | 5521912345678 | cliente-ativo | Use a coluna `tags` para segmentar os contatos já na importação, separando múltiplas etiquetas por vírgula. ### 3. Importe os contatos em massa na Papo Com o CSV pronto, faça o upload na Papo: 1. Acesse o módulo **Contatos** no CRM. 2. Localize a opção **Importar contatos** (normalmente próxima ao botão de criar novo contato). 3. Faça o upload do seu arquivo CSV. 4. Na etapa de mapeamento, associe cada coluna do seu arquivo ao campo correspondente na Papo (ex.: coluna `nome` → campo Nome). Isso inclui campos personalizados, se houver. 5. Revise o mapeamento e inicie a importação. A plataforma processa o arquivo em segundo plano. Ao final, os contatos aparecem na sua base, prontos para serem incluídos em campanhas, funis ou atendimentos. ### 4. Traga o histórico de conversas com a API da Papo (opcional) Se você precisa preservar o histórico completo de interações, a API da Papo permite criar contatos e registrar mensagens de forma programática. Esse método é útil quando o sistema antigo fornece um extrato detalhado das conversas. Para usar a API: - Gere suas chaves de acesso (pública e secreta) seguindo o guia [Como gerar uma chave pública e uma chave secreta da API Papo](/hc/papo/articles/como-gerar-chave-publica-secreta-api-papo). - Desenvolva um script que leia os dados exportados do sistema anterior e chame os endpoints apropriados para criar contatos (caso ainda não importados) e enviar as mensagens históricas. - Consulte a documentação oficial da API em [https://papo.global/docs](https://papo.global/docs) para conhecer os endpoints, parâmetros e limites exatos. Essa abordagem garante que o contexto de atendimento anterior fique disponível no CRM da Papo, permitindo que sua equipe retome conversas passadas sem perder informações. ### 5. Verifique a migração Após a importação e, se aplicável, a carga via API, acesse os módulos **Contatos** e **Conversas** para confirmar que: - Todos os contatos aparecem com os campos preenchidos corretamente. - As etiquetas foram aplicadas conforme o CSV. - O histórico de mensagens (se migrado) está visível na linha do tempo do contato. Se algo não corresponder, você pode corrigir manualmente ou repetir a importação com os ajustes necessários. ## Para quem essa migração é útil - Empresas que estão trocando de plataforma de atendimento e desejam centralizar tudo na Papo. - Times que usavam múltiplas ferramentas (CRM, chat, e-mail) e querem unificar contatos e histórico em um só lugar. - Operações que não podem perder o contexto de conversas antigas ao adotar um novo sistema. - Negócios que precisam de uma transição rápida, sem digitar contatos um a um. ## Perguntas frequentes ### Preciso exportar os contatos em um formato específico? Sim, o formato aceito é CSV com cabeçalhos. A maioria das planilhas (Excel, Google Sheets) pode salvar nesse formato. ### Posso importar campos personalizados além de nome, e-mail e telefone? Sim. Durante o mapeamento, você pode associar colunas do CSV a campos personalizados que já existam na sua conta Papo. ### A importação em massa tem limite de contatos? Os limites podem variar conforme o plano. Para informações atualizadas, consulte a central de ajuda ou o site da Papo. ### Como faço para migrar as conversas se não tenho desenvolvedor? Você pode importar apenas os contatos e começar a atender na Papo a partir da migração. O histórico antigo permanece acessível no sistema anterior, se necessário. ### A API permite recriar conversas de qualquer canal? A API da Papo está documentada em [https://papo.global/docs](https://papo.global/docs). Lá você encontra os canais suportados e as operações disponíveis para registrar mensagens. ### O que acontece se meu CSV tiver erros? A plataforma pode rejeitar linhas com dados inválidos. Recomendamos validar a planilha antes da importação, removendo duplicidades e padronizando os telefones. ## Leia também - [Como gerar uma chave pública e uma chave secreta da API Papo](/hc/papo/articles/como-gerar-chave-publica-secreta-api-papo) - [Como configurar a Papo em 5 passos para começar a atender no WhatsApp](/hc/papo/articles/configurar-papo-5-passos-atender-whatsapp) --- **[Comece sua migração gratuitamente →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=migrar-conversas-contatos-outra-plataforma-papo&utm_content=pt_BR)** Crie sua conta na Papo sem custo e centralize contatos e conversas em uma única plataforma.