Importando do Help Scout
Nesta página
Traga para o Deskwoot as suas conversas, clientes, organizações, Saved Replies e a sua base de conhecimento do Docs que estão no Help Scout. Você precisa do App ID e do App Secret de um app que você cria no Help Scout, e de uma chave da Docs API para os seus artigos do Docs. Tudo vem junto por padrão, e você pode escolher importar menos. A importação roda em segundo plano, continua durante as atualizações do Deskwoot e pode ser iniciada de novo com segurança. Nada muda na sua conta do Help Scout.
O que vem junto
- Conversas chegam com todos os threads: as mensagens do cliente, as respostas da sua equipe, as linhas de chat, as notas privadas e as linhas de atividade do Help Scout (atribuída, fechada, um workflow rodou etc.), com os anexos e as imagens. Cada uma mantém o assunto, as tags, os valores dos campos personalizados, as datas originais e o membro da equipe ou a equipe a quem estava atribuída. Uma ligação que um membro da equipe registrou e a nota com que uma conversa foi encaminhada chegam como notas privadas.
- Tickets do Deskwoot: se o seu workspace usa tickets (o seu plano inclui tickets e eles estão ligados em Configurações > Tickets), cada conversa importada também ganha um ticket do Deskwoot. O ticket assume o status, o assunto, a equipe, a atribuição e as etiquetas, e passa a carregar o trabalho dali em diante. A conversa mantém todas as mensagens, é resolvida como passagem para o ticket e mostra um card privado Ticket #… importado do Help Scout. Uma resposta no ticket sai por essa conversa. Sem tickets, a conversa mantém o status do Help Scout.
- Tags viram etiquetas. Todas as tags da sua conta vêm junto, também uma que nenhuma conversa importada tem (por exemplo, uma que só um workflow adiciona), para que você a encontre quando recriar esse workflow.
- Avaliações de satisfação viram avaliações CSAT com o comentário do cliente na conversa correspondente: Great vira 5, Okay 3 e Not Good 1 na escala de 1 a 5 do Deskwoot. Uma conversa com várias avaliações fica com a mais recente.
- Clientes viram contatos com todos os endereços de e-mail e números de telefone, cargo, localização, endereço, sites, perfis sociais, contas de chat, os valores das suas propriedades de cliente e a foto de perfil. O campo Notes de um cliente vira a descrição do contato.
- Organizações chegam com os dados delas e os valores das suas propriedades de organização, e cada contato mantém a sua organização.
- Users são associados aos membros da sua equipe pelo e-mail, também pelos e-mails adicionais que eles têm no Help Scout (veja abaixo). Equipes viram equipes, com os membros que já estão no seu workspace.
- Saved Replies viram respostas prontas com as imagens e os arquivos delas. O atalho vem do nome da Saved Reply. Uma Saved Reply que também tem um texto de chat traz uma segunda resposta pronta para ele, com um atalho que termina em
_chat. Saved Replies de várias caixas de entrada com o mesmo nome e o mesmo texto viram uma única resposta pronta; com o mesmo nome e outro texto, elas recebem_2,_3e assim por diante. Se já existir no Deskwoot uma resposta pronta com o mesmo atalho, a importada fica de fora, e o Histórico de importações mostra quantas ficaram de fora. - Campos personalizados das suas caixas de entrada viram atributos de conversa (campos com o mesmo nome e tipo em várias caixas de entrada viram um só), propriedades de cliente viram atributos de contato e propriedades de organização viram atributos de organização.
- Workflows ativos no Help Scout viram regras de automação com o mesmo nome, desligadas e sem condições nem ações, porque a API do Help Scout não as fornece. Cada regra informa na descrição de qual workflow e de qual caixa de entrada do Help Scout ela veio, para que você possa recriá-la.
- Docs: com uma chave da Docs API, cada site do Docs vira uma central de ajuda própria, com o nome do site. As coleções viram categorias de primeiro nível, com as categorias delas logo abaixo. Artigos publicados continuam publicados, e todos os outros chegam como rascunho.
Arquivos e imagens
A importação copia para o Deskwoot todos os arquivos que estão no Help Scout: anexos das conversas, imagens coladas em mensagens e notas, imagens e links de arquivos nos artigos do Docs e nas Saved Replies, e as fotos de perfil que você enviou para os seus clientes. Nada fica como link para o Help Scout, então os seus arquivos continuam funcionando depois que você sair do Help Scout. Se o seu workspace contratou a Verificação de vírus, cada arquivo é verificado antes de ser salvo.
- Links entre as páginas do seu site do Docs, e links para elas em Saved Replies e conversas, apontam para a página correspondente da sua central de ajuda no Deskwoot, também quando essa página é um rascunho ou é Só a equipe. Os seus clientes conseguem abrir essa página assim que você a publicar para eles. Sem a base de conhecimento (sem chave da Docs API, ou com Base de conhecimento desligada), esses links continuam apontando para o seu site do Docs.
- Uma foto de perfil que o Help Scout mostra a partir de outro serviço, como o Gravatar ou uma rede social, fica de fora: a importação nunca pede essa foto a esses serviços. O mesmo vale para as imagens padrão que o Help Scout desenha para clientes sem foto.
- Um anexo que a própria verificação de vírus do Help Scout bloqueou fica de fora.
- Se um arquivo não puder ser copiado agora (o Help Scout não responde nem depois de várias tentativas, ou o verificador de vírus ou o armazenamento do Deskwoot não está acessível), a importação termina com Importada em parte. Inicie a importação novamente para copiá-lo. Quando 3 arquivos seguidos do mesmo servidor não chegam, a execução pula os arquivos desse servidor por 2 minutos e depois tenta um deles de novo. Se ele chegar, a execução continua com os arquivos do servidor. Se não, ela espera mais 2 minutos. Assim, um servidor que não responde não segura a importação inteira, e a próxima execução tenta de novo os arquivos pulados.
- Um arquivo que nenhuma execução consegue copiar fica de fora, e a importação termina mesmo assim. Isso vale também para um arquivo que não pôde ser acessado em 3 execuções, para que um servidor que nunca responde não deixe a sua importação para sempre em Importada em parte. Só contam as execuções em que o arquivo não pôde ser acessado, não as execuções em que o verificador de vírus ou o armazenamento estava fora do ar. A contagem recomeça quando a última dessas execuções foi há mais de 7 dias, e excluir qualquer importação do seu workspace zera a contagem.
- O Histórico de importações lista esses arquivos em Arquivos não importados com o motivo, por exemplo grande demais (mais de 25 MB, fotos de perfil com mais de 2 MB), um tipo de arquivo não permitido, recusado por uma verificação de vírus ou não está mais disponível no Help Scout.
- Imagens que uma mensagem ou um artigo carrega de outro site, como o seu, continuam como estão.
O que não vem junto
Algumas coisas a API do Help Scout não fornece, e para outras o Deskwoot não tem lugar:
- As condições e ações de um workflow (veja acima). Workflows inativos ficam de fora.
- Pastas e visualizações (Mine, Assigned, Closed e as visualizações que a sua equipe criou), então nenhum filtro salvo vem junto.
- Rascunhos, respostas retidas para revisão, e conversas de spam e excluídas.
- Uma prioridade, porque o Help Scout não tem, e um adiamento: o Help Scout mantém ativa uma conversa adiada, então ela chega como aberta.
- Os endereços em Para, CC e CCO das conversas e respostas, para que responder a todos em uma conversa antiga nunca escreva para eles. A nota com que uma conversa foi encaminhada chega sem o endereço para onde ela foi.
- O vínculo entre uma conversa encaminhada e a conversa que o encaminhamento abriu: as duas chegam, cada uma com as próprias mensagens, mas sem vínculo entre si.
- O canal de mensagens (WhatsApp, SMS, Messenger, Instagram) por onde uma conversa chegou. O Help Scout lista a conversa como de e-mail, de chat ou de telefone, e ela chega assim.
- As mensagens avulsas de um chat do Beacon que já terminou: o Help Scout guarda a transcrição como uma única mensagem, e ela chega como uma única mensagem.
- Do Docs: artigos relacionados, palavras-chave, redirecionamentos, o logo e as cores do site, e o rascunho não publicado de um artigo publicado (o texto publicado vem junto). Um artigo que está em várias categorias vai para a primeira delas. Uma categoria vazia, como a categoria Uncategorized que toda coleção tem, só chega quando tiver um artigo.
- Logos e cores de marca das organizações, e as fotos dos users e das equipes.
- Os números de conversa do Help Scout. O Deskwoot numera as conversas na ordem em que o Help Scout as lista, da mais recente para a mais antiga.
O que fica interno
O Deskwoot mantém privado tudo o que o seu site do Docs não mostrava para todo mundo:
- Uma coleção privada vira uma categoria Só a equipe, junto com todas as categorias dentro dela. Uma categoria que não é pública também vira Só a equipe.
- Todas as categorias de um site do Docs que não tem site público, está desligado ou usa Restricted Docs (só visitantes aprovados, planos Plus e Pro) viram Só a equipe.
Categorias Só a equipe e os artigos delas ficam visíveis só para a sua equipe no painel. Elas nunca aparecem na central de ajuda pública, no sitemap, no widget de chat nem para o Fynn, o bot de IA.
Antes de começar
- Confira o seu plano do Help Scout. A importação lê pela API do Help Scout, que faz parte de todos os planos pagos e do teste grátis. O plano Free do Help Scout não tem API, então a importação precisa de um plano pago ou de um teste grátis.
- No Help Scout, clique no seu avatar e abra Your Profile > My Apps. Faça isso como dono da conta, para que a importação veja todas as caixas de entrada. Clique em Create App, digite qualquer nome (por exemplo, "Deskwoot Migration") e qualquer URL de redirecionamento (por exemplo, https://deskwoot.com) e salve. Copie o App ID e o App Secret.
- Para os seus artigos do Docs, copie também a chave em Your Profile > Security & Access > Docs API.
- Convide os membros da sua equipe para o Deskwoot com o mesmo e-mail que eles usam no Help Scout. Você também pode fazer isso depois.
Como importar
- No Deskwoot, vá em Configurações > Importação e migração. Só administradores podem importar.
- Escolha Help Scout.
- Digite o App ID e o App Secret, e a Chave da Docs API se quiser os seus artigos do Docs. Sem a chave, os seus artigos do Docs ficam fora da importação. O Deskwoot confere as chaves com o Help Scout ao iniciar e avisa se o Help Scout recusar.
- Em O que deve vir junto?, escolha o que vem junto. Tudo vem ligado por padrão. Para importar só as conversas mais recentes, escolha um dia em Somente conversas criadas a partir de.
- Em Para qual caixa de entrada vão as conversas?, escolha uma caixa de entrada para cada tipo de conversa, ou deixe Nenhuma caixa de entrada. Só caixas de entrada de e-mail, Telegram, WhatsApp e SMS aparecem como opção, então configure-as antes.
- Clique em Iniciar importação.
Enquanto a importação roda
- A importação roda em segundo plano, então você pode fechar a página. A página de importação mostra em que etapa ela está e quantos registros já foram processados. Depois de alguns minutos medindo, ela também mostra a velocidade. Ela mostra ainda quantas chamadas de API por minuto a sua conta do Help Scout permite e quantas delas a importação usa no máximo.
- O Help Scout dá a cada conta um número de chamadas de API por minuto, de acordo com o plano, e conta juntas as chamadas de todos os seus apps e integrações. A importação usa no máximo 85% desse limite, para que os seus outros apps continuem funcionando enquanto ela roda. Quando o limite é atingido, a importação espera e depois continua.
- Atualizações do Deskwoot e reinicializações do servidor não a interrompem. Ela continua de onde parou. Se uma execução cair ou travar 3 vezes seguidas sem avançar, a importação para e avisa. Inicie a importação novamente para continuar.
- Só uma importação roda por workspace de cada vez. Inicie a próxima quando a atual terminar.
- Para parar uma importação, clique em Cancelar importação na página de importação e confirme com Cancelar e excluir. A importação para, e o que ela importou até agora é excluído. Uma conversa em que alguém escreveu desde então mantém essas mensagens novas.
- Se o Help Scout parar de responder ou recusar uma lista, a importação mantém o que já leu, conclui as outras etapas e termina com Importada em parte e as etapas que pararam antes do fim. Inicie a importação novamente para continuar. Uma lista que o seu plano do Help Scout não tem (equipes e campos personalizados das caixas de entrada vêm com Plus e Pro) é pulada sem aviso.
Conversas e respostas dos membros da sua equipe
Uma conversa atribuída a um user do Help Scout vai para o membro da equipe com o mesmo e-mail, e as respostas e notas dele aparecem com ele como remetente. Com tickets ligados, o ticket do Deskwoot também vai para esse membro da equipe. Uma conversa atribuída a uma equipe do Help Scout vai para a equipe do Deskwoot com esse nome. Se o user ainda não tem conta no Deskwoot, a conversa chega sem atribuição e as respostas dele mostram o nome com (importado).
Quando essa pessoa entrar no seu workspace depois, com o mesmo e-mail, o Deskwoot passa o trabalho para ela automaticamente: as conversas importadas sem atribuição são atribuídas a ela, e ela vira a remetente das próprias respostas. Conversas abertas, pendentes e adiadas chegam com uma única notificação para todas. As resolvidas são atribuídas sem aviso. Nenhum status muda, e os seus clientes não percebem nada. Uma conversa que alguém no Deskwoot já teve continua como está. Os tickets do Deskwoot que a importação criou não são passados dessa forma: atribua-os manualmente.
Conversas importadas ficam em silêncio
Conversas importadas são histórico, por isso ficam em silêncio até o cliente escrever de novo ou alguém da sua equipe responder no Deskwoot. Até lá, o Deskwoot não envia nada ao cliente a partir delas (nem mensagem de despedida, nem pesquisa de satisfação), não inicia nenhum relógio de SLA e não as resolve automaticamente. Conversas importadas nunca contam no limite mensal de conversas do seu plano e nunca são bloqueadas por ele, nem depois que o cliente escreve de novo. Resolver ou reabrir uma delas manualmente não dispara nenhum webhook nem regra de automação. A partir da primeira mensagem nova, a conversa funciona como qualquer outra, só que o Fynn, o bot de IA, nunca responde em uma conversa importada.
Caixas de entrada para as conversas importadas
- O Help Scout guarda se cada conversa é um e-mail, um chat ou uma ligação, e se ela chegou por um formulário de contato do Beacon ou do Docs. A importação coloca cada conversa na caixa de entrada que você escolheu para o tipo dela (E-mail, Chat, Formulários e central de ajuda ou Telefone), para que a sua equipe possa responder por lá. O Help Scout também lista conversas de WhatsApp, SMS e Messenger como um desses tipos, então as linhas WhatsApp, SMS e Todo o resto não recebem conversas do Help Scout.
- Uma conversa só vai para uma caixa de entrada pela qual o Deskwoot consegue falar com o cliente: uma caixa de e-mail precisa do endereço de e-mail dele, uma do Telegram precisa do chat dele no Telegram, e uma de WhatsApp ou SMS precisa do número de telefone dele. As outras conversas chegam sem caixa de entrada.
- Quando você roda a importação de novo, as conversas importadas antes também vão para as caixas de entrada escolhidas, se ainda não tiverem uma. Uma conversa que já tem caixa de entrada, ou em que alguém da sua equipe já escreveu, fica onde está. A próxima importação começa com as caixas de entrada da última.
- Um ticket do Deskwoot não tem caixa de entrada própria: as respostas dele saem pela conversa dele, então essa conversa precisa de uma.
- O Histórico de importações mostra as caixas de entrada escolhidas e quantas conversas foram para uma delas.
Depois da importação
- Uma conversa sem caixa de entrada (porque você não escolheu nenhuma para o tipo dela, ou porque o Deskwoot não consegue falar com o cliente por ela) precisa de uma antes de você responder: abra a conversa e escolha uma caixa de entrada no aviso Esta conversa não tem caixa de entrada. O Histórico de importações mostra em Ainda a fazer quantas são.
- Recrie os seus workflows: adicione as condições e ações a cada regra importada e depois ligue as que você quiser. O Histórico de importações leva até elas com Verificar e ligar as regras.
- Confira os artigos e as categorias da sua nova central de ajuda e publique os que os seus clientes devem ver.
Perguntas frequentes
De qual plano do Help Scout eu preciso?
De um plano pago ou de um teste grátis: o plano Free do Help Scout não tem acesso à API. Equipes, campos personalizados das caixas de entrada e Restricted Docs só existem no Help Scout nos planos Plus e Pro. No Standard, as avaliações ficam com a data da resposta que avaliam, porque os relatórios do Help Scout, que trazem o horário de cada avaliação, só fazem parte do Plus e do Pro.
Posso importar só uma parte dos meus dados?
Sim. Em O que deve vir junto?, tudo vem ligado por padrão, e você pode desligar Conversas, Contatos e organizações, Base de conhecimento, Respostas prontas e Avaliações de satisfação. Com um dia em Somente conversas criadas a partir de, só vêm as conversas criadas nesse dia ou depois, e só as avaliações feitas desde então. As avaliações só vêm junto com as conversas que elas avaliam, por isso essa opção fica cinza sem as conversas. As tags também vêm com as conversas. Users, equipes, workflows e os campos de conversas e contatos sempre vêm junto. Se você deixar os contatos de fora, cada conversa importada traz mesmo assim o próprio contato.
O Histórico de importações mostra em cada importação o que não foi selecionado e a data de início. Para trazer o resto depois, inicie uma importação com tudo selecionado: ela pula o que já está no Deskwoot e traz o que ficou de fora.
Meus contatos já estão no Deskwoot. A importação usa esses contatos?
Sim. Antes de criar um contato, a importação procura essa pessoa no Deskwoot por cada um dos endereços de e-mail dela, seja em maiúsculas ou minúsculas. As conversas dela vão então para o contato que você já tem, e o nome, os dados e os campos dele continuam como estão. Se todos os seus contatos já estão no Deskwoot, você pode desligar Contatos e organizações: cada conversa vai mesmo assim para o contato dela, e um contato que o Deskwoot ainda não tem chega junto com a conversa.
Posso iniciar a importação de novo?
Sim, com segurança. Uma nova execução encontra o que já está no Deskwoot e pula, então conversas, contatos e artigos não são duplicados. Ela traz o que é novo ou estava faltando, por exemplo depois de uma execução que terminou com Importada em parte. Em uma conversa que ela importou antes, ela adiciona as mensagens e tags novas e assume um novo status, assunto, atribuição ou equipe, desde que ninguém tenha trabalhado nessa conversa no Deskwoot. Valores de campos alterados no Help Scout e tags removidas lá não são seguidos.
Se você mesclou duas conversas no Help Scout depois de uma importação anterior, uma nova execução traz as mensagens movidas para a conversa que o Help Scout manteve, e a conversa mesclada continua no Deskwoot como foi importada.
Artigos da central de ajuda que a sua equipe editou no Deskwoot mantêm o texto novo, e uma nova execução nunca publica um artigo que você despublicou ou deixou como Só a equipe. Se o Help Scout deixou uma coleção ou categoria privada desde então, uma nova execução também a deixa como Só a equipe no Deskwoot. Se um artigo deixou de ser publicado no Help Scout, uma nova execução também o despublica no Deskwoot, mas só se a sua equipe não o editou.
Lembre-se: conversas, contatos e notas que você excluiu ou apagou no Deskwoot desde a última importação voltam se o Help Scout ainda os tiver. O mesmo vale para contatos que você mesclou.
A importação terminou com "Importada em parte". E agora?
O Help Scout parou de responder em uma ou mais etapas, por exemplo porque o limite de API dele ficou esgotado por muito tempo. Tudo o que foi lido até ali está no Deskwoot. Inicie a importação novamente: ela pula o que já está lá e continua.
Como desfaço uma importação?
No Histórico de importações, clique em Excluir ao lado da importação, confirme e digite a sua senha. Isso apaga as conversas, os tickets e os contatos que ela criou, junto com os arquivos que ela copiou para eles. Uma conversa em que alguém escreveu desde então continua com essas mensagens novas, sem as importadas, e um contato que ainda tem uma conversa também continua. Equipes, respostas prontas, etiquetas, campos, regras de automação, artigos da central de ajuda e outras configurações continuam. A exclusão continua depois de uma reinicialização, e você pode iniciar uma nova importação quando ela terminar. Enquanto outra importação estiver em andamento, não é possível excluir uma importação. Se você importou do Help Scout mais de uma vez, exclua as importações da mais recente para a mais antiga: enquanto existir uma importação mais recente do Help Scout, o Deskwoot pede que você exclua essa primeiro.
Este guia foi útil?
Continue lendo
- Importando do TidioTraga para o Deskwoot seus tickets, chats ao vivo, contatos e o conhecimento do Lyro do Tidio com a sua chave da API do Tidio.Ler guia
- Colegas de IA: como agentes de IA trabalham na sua equipeConecte Claude, ChatGPT, Grok Bot ou Cursor como colegas de IA: funções, o que eles leem, autonomia e temas retidos, aprovações, pausar e parar, e cobrança.Ler guia
- Conectar o Grok Bot ao DeskwootConecte o Grok Bot como colega de IA: a frase para o chat dele, a página de consentimento, as perguntas de configuração, o aviso de trabalho novo e os seus dados.Ler guia
Perguntar ao Fynn sobre este guia
Receba uma resposta curta deste guia e do resto da Central de Ajuda.