![Fluxo de migração do Zendesk para o Chatwoot: exportar e importar contatos, substituir o widget, configurar os canais e preservar o histórico antigo fora do importador de contatos.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbVFSIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d769c33239429fb3fab761ebc76411f88b15f7c4/1732304714-como-migrar-do-zendesk-para-o-chatwoot.png)

Se você usa o Zendesk, este guia orienta a transferência dos contatos, a substituição do widget e a configuração inicial do Chatwoot. O histórico de conversas exige um plano separado, explicado abaixo.

### Antes de começar

Antes de configurar o Chatwoot, há duas tarefas essenciais para remover o Zendesk do seu ambiente sem sobreposição de atendimentos.

#### Passo 1 — Remover o widget de chat do Zendesk

Comece desinstalando do seu site o código do widget de chat ao vivo do Zendesk que você havia integrado anteriormente. Assim, os visitantes deixam de abrir conversas pelo canal antigo.

#### Passo 2 — Exportar os contatos

Em seguida, exporte todos os seus contatos do Zendesk. Ao final, você terá um arquivo em formato **CSV** que será usado na importação para o Chatwoot.

### Migrando para o Chatwoot

#### Passo 3 — Criar uma conta

Crie a sua conta no Chatwoot seguindo o guia de primeiros passos.

#### Passo 4 — Migrar o widget de chat do site

No Chatwoot, crie uma caixa de entrada do canal **chat no site** em **Configurações → Caixas de Entrada → Adicionar caixa de entrada**. Ao concluir a configuração, o Chatwoot exibirá o trecho de código do widget para você colar no código do seu site. Antes de publicar, confirme que o widget do Zendesk já foi removido, conforme o Passo 1, para não exibir dois chats ao mesmo tempo.

#### Passo 5 — Migrar os contatos

Abra a aba **Contatos** no Chatwoot e clique no botão **Importar**.

Siga as instruções na tela para enviar o arquivo **CSV** exportado do Zendesk. Concluído o envio, todos os seus contatos aparecerão sincronizados no Chatwoot.

#### Passo 6 — Preservar o histórico de conversas

O importador atual do Chatwoot aceita **contatos**, não um arquivo de conversas do Zendesk. Exporte e preserve o histórico no sistema antigo ou em um repositório seguro e, se ele precisar aparecer no Chatwoot, fale com o suporte para avaliar um projeto de migração antes de encerrar o Zendesk.

#### Passo 7 — Deixe o Chatwoot com a sua cara

Pronto, migração concluída! A partir daqui, recomendamos alguns passos para aproveitar o Chatwoot ao máximo:

* **Conecte o WhatsApp Web:** este é o canal principal da plataforma. Escaneie um QR Code com o seu celular para conectar seu número, sem precisar de credenciais do Meta Business. Veja [**Conectar o WhatsApp Web (QR Code)**](1724618803-como-configurar-um-canal-whats_app-usando-a-evolution-api).
* **Monte uma caixa de entrada omnicanal:** reúna WhatsApp Web, chat no site, e-mail, Instagram, Facebook, Telegram, SMS e API em um só lugar.
* **Cadastre seus agentes:** em **Configurações → Agentes**, use **Adicionar agente** para dar acesso à sua equipe. No Chatwoot há dois papéis — **Administrador** (acesso total, incluindo configurações) e **Agente** (atende as conversas).
* **Boas práticas:** ajuste seu fluxo de trabalho para atender com mais eficiência desde o início.

Se precisar de ajuda, fale com a gente pelo e-mail [atendimento@chatwoot.app.br](mailto:atendimento@chatwoot.app.br) e não deixe de compartilhar seu feedback. Boas conversas!