Migrar do Intercom para o Chat: como trazer suas conversas
Quando um time de suporte sai do Intercom, o que mais pesa é o histórico. Cada conversa antiga é contexto: o que aquele cliente perguntou no ano passado, o que foi prometido, como foi resolvido. Começar do zero em outra caixa de entrada significa perder isso.
Este guia mostra como trazer esse histórico para o Chat, o que o importador traz exatamente (lemos o código), o que fica de fora e em que ordem fazer a troca. Vale avisar logo: a importação do Intercom no Chat funciona com um arquivo JSON, e não com uma conexão direta, e foi testada com os exemplos da documentação do Intercom, não com uma conta real. Por isso o guia insiste em fazer um teste pequeno antes.
O que você precisa
- Um access token do Intercom. Segundo a documentação do Intercom, ao criar um app no seu workspace pelo Developer Hub, o token aparece em Configure › Authentication desse app.
- Um widget criado no Chat. As conversas importadas ficam guardadas em um widget. Se ainda não tem um, crie primeiro.
- Ser admin do workspace no zerosoft.
- Um terminal com
curlejq, ou qualquer linguagem que faça requisições HTTP. É a única parte técnica.
Passo 1: tirar o JSON do Intercom
O Chat lê o formato que a API do Intercom devolve quando você busca uma conversa: GET /conversations/{id}. Essa requisição traz a primeira mensagem e as partes da conversa. A listagem (GET /conversations) serve para conseguir os ids, mas a documentação do Intercom avisa que ela não inclui as partes, então é preciso buscar cada conversa separadamente. O Intercom também informa que a API devolve no máximo as 500 partes mais recentes de uma conversa.
Um exemplo mínimo para uma página da listagem:
TOKEN="seu_access_token"
curl -s -H "Authorization: Bearer $TOKEN" -H "Accept: application/json" \
"https://api.intercom.io/conversations?per_page=50" | jq -r '.conversations[].id' > ids.txt
while read id; do
curl -s -H "Authorization: Bearer $TOKEN" -H "Accept: application/json" \
"https://api.intercom.io/conversations/$id"
done < ids.txt | jq -s '.' > intercom.json
A listagem vem paginada: para trazer tudo, repita a primeira requisição com o cursor que o Intercom devolve e junte os ids. O Chat aceita um array de conversas, um objeto com conversations ou data dentro, ou uma conversa só.
Dois limites do lado do Chat: até 4 MB por arquivo e 2.000 conversas por arquivo. Se o seu histórico for maior, divida em vários arquivos e envie um de cada vez.
Passo 2: importar no Chat
- No Chat, vá em Relatórios e clique em Importar conversas no cabeçalho da página.
- Em Para o widget, escolha para onde vão as conversas.
- Em Arquivo JSON, envie o arquivo e clique em Importar.
No fim você vê quantas conversas entraram, quantas já existiam e quantas mensagens foram importadas. Se alguma falhou, ela é limpa e você pode tentar de novo enviando o mesmo arquivo: o que já entrou não se duplica.
O que é importado
De cada conversa:
- A pessoa: nome e email do contato (ou do autor da primeira mensagem, quando é o cliente). Valores que não têm cara de email são descartados.
- O assunto, se a conversa tinha, ou o título dela.
- As mensagens em ordem, com data. O que foi escrito pelo contato, lead ou usuário fica como do visitante; o resto conta como resposta do time.
- O status: aberta se estava aberta no Intercom; qualquer outro estado entra como resolvida.
- Uma etiqueta
import-intercomem cada conversa, para encontrar e separar na caixa de entrada.
O que é importado não dispara regras, bot nem webhooks. E as pessoas importadas não recebem campanhas até um admin marcar o consentimento na ficha.
O que não é importado
- As notas internas. O importador pula de propósito.
- Anexos e imagens. O Intercom manda as mensagens em HTML; o Chat fica com o texto.
- Quem respondeu. As respostas do time entram como do time, sem a pessoa específica. Mensagens de bots também caem aí.
- Atribuições, mudanças de status e conversas adiadas. As atribuições chegam como partes sem texto e não são importadas. Uma conversa adiada entra como resolvida.
- Tags, atributos, empresas e avaliações do Intercom.
- A pessoa unificada. Cada conversa importada cria o seu próprio registro de visitante, mesmo quando o email se repete.
- Artigos da central de ajuda, bots e regras. Isso se monta de novo no Chat.
Antes de trocar o widget
- Teste com um arquivo pequeno, de dez ou vinte conversas. Abra algumas no Chat e compare com o Intercom.
- Importe o resto em lotes.
- Cadastre suas respostas salvas e os artigos de ajuda que o bot pode usar. Em artigos de ajuda que o bot consegue ler está o passo a passo.
- Cole o script do widget do Chat no seu site e tire o do Intercom.
- Faça uma última exportação do Intercom com as conversas dos últimos dias e importe. O que se repete é pulado.
O que ainda falta no Chat em relação ao Intercom
Da tabela de paridade, do jeito que está:
- WhatsApp, Instagram, Messenger e SMS: ainda não.
- Telefone e voz: ainda não.
- Apps nativos de iOS e Android para o time e SDK mobile do messenger: ainda não.
- Loja de apps: não há. O Intercom tem mais de 450.
- Central de ajuda multilíngue, privada ou com domínio próprio: ainda não.
- Email de entrada, tickets, workflows visuais, multimarca e SSO: cobertos em parte. Por exemplo, os issues do Track funcionam como tracker tickets, mas não há tipos de ticket nem portal para o cliente.
- Campanhas por email: só texto, para pessoas com consentimento, com limite diário.
- Prioridades: quatro níveis; o Intercom tem cinco.
- Idiomas do messenger: 15, contra cerca de 45 do Intercom.
- A própria importação: sem conexão direta, anexos nem notas internas.
A tabela completa está em /compare/zerosoft-vs-intercom.
Quanto custa
O Intercom começa em cerca de US$ 29 por assento por mês: um time de dez paga US$ 3.480 por ano. O Chat no seu servidor custa $0, com o core em AGPLv3. No zerosoft Cloud você começa com um plano gratuito e depois paga pelo uso. Assentos não são cobrados, então colocar mais alguém no suporte não muda a fatura.
Para ver a comparação do dia a dia antes de mudar, leia Chat vs Intercom.