Migrar para o Respondo
Vindo de outro helpdesk? Traga sua base de conhecimento, o histórico de conversas, as respostas salvas e as configurações do workspace em uma passada guiada — uma importação única, sem conexão contínua com a sua ferramenta antiga.
Visão geral#
O assistente de migração conecta-se ao seu helpdesk atual com uma credencial de API somente leitura, mostra exatamente o que encontrou, permite escolher o que trazer e então importa tudo em segundo plano enquanto você continua trabalhando. Quando termina, seus artigos alimentam o agente de IA, suas conversas antigas ficam na caixa de entrada com o histórico completo e suas respostas salvas estão prontas para uso.
Importação única
Os dados são copiados uma vez. O Respondo não sincroniza de volta com o seu helpdesk antigo nem mantém uma conexão viva com ele.
Você escolhe o que vem
Cada categoria — artigos, conversas, respostas salvas, configurações — pode ser ligada ou desligada. Artigos podem até ser escolhidos um a um.
Progresso honesto
Uma tela de progresso ao vivo mostra contagens reais por categoria — importados, atualizados, pulados, com falha — e você pode cancelar a qualquer momento.
Fontes suportadas#
O Respondo pode importar de três helpdesks. Cada um nomeia as coisas de um jeito um pouco diferente — o assistente usa a terminologia do próprio fornecedor do início ao fim:
| Fonte | Base de conhecimento | Respostas reutilizáveis |
|---|---|---|
| Zendesk | Artigos do Help Center | Macros |
| Intercom | Artigos | Respostas salvas (não disponível — veja as limitações abaixo) |
| Freshdesk | Solutions | Canned responses |
O que é importado#
A importação roda em quatro categorias independentes. Você escolhe quais incluir no passo Escolher do assistente:
| Categoria | Em que se torna no Respondo |
|---|---|
| Artigos da base de conhecimento | Artigos publicados tornam-se uma fonte de conhecimento para o agente de IA que você selecionar — o agente pode respondê-los de imediato. Você pode importar tudo ou escolher artigos individuais, com um filtro por idioma para centrais de ajuda multilíngues. |
| Conversas antigas | Tickets e conversas chegam à caixa de entrada como conversas resolvidas, com o histórico completo de mensagens e os contatos. Pares de pergunta e resposta de alta qualidade também são minerados delas como dados de treinamento, para que o agente aprenda como sua equipe realmente responde. |
| Macros / respostas salvas / canned responses | Suas respostas reutilizáveis tornam-se respostas salvas (Configurações → Macros) que os colegas de time podem inserir em qualquer conversa. |
| Configurações do workspace | Fuso horário, horários comerciais (incluindo feriados) e o nome da sua empresa. Nada é aplicado às cegas — o assistente mostra um diff lado a lado de cada configuração, e só as mudanças que você aceitar são gravadas. |
Conversas importadas não acionam automação alguma: sem respostas do bot, sem escalonamentos, sem notificações. Elas chegam em silêncio, como histórico. Como um humano as resolveu no seu helpdesk antigo, são arquivadas como Resolvidas pela equipe, não como Resolvidas pela IA.
Credenciais necessárias#
Cada fornecedor requer uma credencial de API somente leitura. O passo Conectar do assistente diz exatamente onde criá-la:
| Fonte | Você informa | Onde obter |
|---|---|---|
| Zendesk | Subdomínio, e-mail de admin e um token de API | No Zendesk: Admin → Apps and integrations → APIs → Zendesk API |
| Intercom | Token de acesso e sua região de dados (EUA, UE ou Austrália) | No Intercom Developer Hub: crie um app interno em Your apps e copie o Access Token em Authentication |
| Freshdesk | Domínio e uma chave de API | No Freshdesk: Profile settings → View API key (a chave de um admin importa mais dados) |
Executar o assistente#
Abra o hub de migração em /migrate, ou chegue a ele por Conhecimento → Adicionar fonte → Migrar de um helpdesk. Escolha sua fonte e o assistente conduz você por quatro passos:
| Passo | O que acontece |
|---|---|
| 1. Conectar | Informe a credencial somente leitura. O Respondo a verifica e lê seu workspace para contar o que está disponível para importar. |
| 2. Escolher | Ligue as categorias que quiser, escolha o agente de IA que deve receber o conhecimento e, opcionalmente, selecione artigos individuais. |
| 3. Prévia | Revise o diff das configurações do workspace — cada mudança proposta é exibida contra o seu valor atual, e você as aceita individualmente. |
| 4. Executar | A importação roda como um job em segundo plano com progresso ao vivo por categoria. Você pode sair da página e voltar — o hub mostra a migração em execução no cartão do fornecedor. |
Apenas uma migração pode rodar por vez em cada workspace. Você pode cancelar uma importação em execução pela tela de progresso, e pode rodar uma importação de novo mais tarde — itens já importados são reconhecidos e atualizados ou pulados, em vez de duplicados.
Conversas importadas são nativas#
Toda conversa importada é atribuída ao canal real que o cliente usou — um ticket que chegou por e-mail vira uma conversa nativa de e-mail, um chat de um messenger de site vira uma conversa nativa de widget. Não existe canal separado de "migrado" nem comportamento especial de migração: conversas importadas filtram, buscam, atribuem e respondem exatamente como conversas que começaram no Respondo.
Quando o canal original não pode ser determinado, o Respondo coloca a conversa onde você pode de fato continuá-la: se o contato tem um endereço de e-mail utilizável, ela vira uma conversa de e-mail; caso contrário, vira uma conversa de widget, que não precisa de endereço para permanecer legível.
Limitações#
O que pode ser importado é limitado pelo que a API pública de cada fornecedor expõe. O assistente é honesto quanto a isso — uma categoria que a fonte não consegue servir aparece como indisponível, com o motivo, em vez de importar nada em silêncio:
- Respostas salvas do Intercom não podem ser migradas — a API pública do Intercom não as expõe.
- Configurações do Intercom transferem apenas o fuso horário do workspace; a API não expõe o horário comercial.
- Conversas muito longas do Intercom (mais de aproximadamente 500 partes) são importadas truncadas — a API retorna no máximo 500 partes por conversa.
- Zendesk e Freshdesk suportam as quatro categorias: conversas, base de conhecimento, respostas reutilizáveis e configurações.
Se uma execução terminar com algumas categorias com falha, seu status é reportado como parcial e a tela de progresso mostra qual categoria falhou e por quê. Você pode corrigir a causa (por exemplo, um token de API expirado) e rodar a importação de novo.