Importando do Gorgias

Atualizado em 20 de nov. de 202617 min de leitura
Português
Nesta página

Traga seus tickets, clientes, macros, tags, campos, regras e visualizações do Gorgias para o Deskwoot com o seu subdomínio do Gorgias, o seu e-mail e uma chave da API. A importação lê todos os tickets com todas as mensagens e arquivos. Por padrão vem tudo, e você pode escolher importar menos. Ela 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 Gorgias.

O que vem junto

  • Tickets viram conversas com todas as mensagens, notas internas (como notas privadas), anexos, status, prioridade, time, agente, tags e os valores dos seus campos de ticket. Cada um mantém as datas originais e o canal pelo qual chegou (e-mail, chat, telefone e assim por diante). Um e-mail chega como o Gorgias o guarda para leitura: sem a assinatura e sem as respostas anteriores que ele cita. Mensagens que uma regra ou um bot do Gorgias enviou aparecem como da sua equipe, sem agente.
  • Tickets do Deskwoot: se o seu workspace usa tickets (eles vêm com o plano Enterprise e com o teste grátis, e um administrador pode desligá-los em Configurações > Tickets), cada ticket do Gorgias também vira um ticket do Deskwoot ao lado da conversa. O ticket assume o status, a prioridade, o assunto, o time, o agente e as etiquetas, e passa a concentrar o trabalho. A conversa é resolvida como passagem para o ticket e mostra um cartão privado que indica o ticket como importado do Gorgias. Sem tickets, a conversa mantém o status do Gorgias.
  • Tags viram etiquetas com a cor e a descrição. Tags excluídas ficam de fora.
  • Avaliações de satisfação viram avaliações de CSAT com a nota e o comentário na conversa correspondente. Pesquisas que o cliente nunca respondeu ficam de fora.
  • Clientes viram contatos com todos os endereços de e-mail e números de telefone (inclusive os de WhatsApp), o usuário no X, idioma, fuso horário, nota (como nota do contato), os valores dos seus campos de cliente e os dados extras guardados sobre eles no Gorgias. Os outros canais deles, como Instagram ou Facebook, também ficam salvos no contato.
  • Times vêm com a descrição e com os membros que já estão no seu workspace. Usuários (os seus agentes do Gorgias) são associados aos membros da sua equipe pelo e-mail (veja abaixo).
  • Macros que não estão arquivadas viram respostas prontas com o texto da resposta, as imagens e os anexos. As variáveis do Gorgias que o Deskwoot também tem viram as do Deskwoot, por exemplo {{ticket.customer.firstname}} vira {{contact.first_name}}. O atalho vem do nome da macro. Se já existe no Deskwoot uma resposta pronta com o mesmo atalho, a importada fica de fora, e a importação no Histórico de importações mostra quantas ficaram de fora. O que uma macro faz além da resposta (adicionar tags, mudar o status ou a prioridade, atribuir um agente ou um time, adicionar uma nota interna) vira uma macro do Deskwoot com o mesmo nome para toda a sua equipe. Uma macro com esse nome que já está no Deskwoot continua como está.
  • Campos de ticket e campos de cliente viram atributos customizados com o tipo e as opções de uma lista suspensa. Campos arquivados também vêm, para que os valores antigos cheguem.
  • Regras ativas no Gorgias viram regras de automação e chegam desligadas. O Gorgias escreve uma regra como código, e o Deskwoot não executa esse código: cada regra importada guarda o código e lista as ações que ela fazia, para você recriá-la com as condições e ações do Deskwoot. Do jeito que chega, ela nunca é acionada.
  • Visualizações de tickets ativas que a sua equipe criou viram filtros salvos do administrador que iniciou a importação. Tudo o que o Deskwoot consegue filtrar vem junto (status, adiamento, agente, time, tags, prioridade, valores de campos, palavras de busca e ordenação). O resto fica de fora, então um filtro pode mostrar mais conversas do que a visualização mostrava, nunca menos. Uma visualização cujo filtro o Deskwoot não consegue ler de jeito nenhum, como uma que usa só os campos de IA do Gorgias, fica de fora, porque mostraria todas as conversas.

Arquivos e imagens

A importação copia para o Deskwoot todos os arquivos que estão no Gorgias: os anexos e as imagens de cada mensagem, as imagens das suas macros e os arquivos que as suas macros anexam, que as respostas prontas oferecem como arquivos que o cliente pode abrir. Nada fica como link para o Gorgias, então os seus arquivos continuam funcionando depois que você sair do Gorgias. Se o seu workspace contratou a Verificação de vírus, cada arquivo é verificado antes de ser salvo.

  • Se um arquivo não puder ser copiado agora (o Gorgias 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.
  • Cada importação no Histórico de importações lista esses arquivos em Arquivos não importados com o motivo, por exemplo grande demais (mais de 25 MB), um tipo de arquivo não permitido, recusado pela verificação de vírus ou não está mais disponível na origem.
  • Imagens que uma mensagem ou uma macro carrega de outro site, como o seu, continuam como estão.

O que não vem junto

  • A sua central de ajuda do Gorgias. O Gorgias não tem uma API para ela, e a própria ajuda dele diz que os artigos não podem ser exportados.
  • Organizações, porque o Gorgias não tem empresas, e fotos de perfil, porque os clientes do Gorgias não têm. Os membros da sua equipe mantêm o perfil do Deskwoot.
  • Macros arquivadas, e as partes de uma macro para as quais uma macro do Deskwoot não tem ação: preencher um campo de ticket, ações HTTP e ações de loja.
  • Regras e visualizações desligadas, as visualizações de sistema do próprio Gorgias (as pastas que já vêm na caixa de entrada do Deskwoot cobrem essas) e as visualizações de clientes.
  • Os campos de IA do Gorgias e os palpites da IA dele sobre as mensagens (intents). O motivo do contato vem como valor de campo.
  • Os dados de loja de um cliente vindos do Shopify e de outros apps. As integrações do próprio Deskwoot leem esses dados direto da sua loja.
  • O histórico de eventos de um ticket. O Gorgias só entrega esse histórico um ticket por vez e só dos últimos 12 meses.
  • Gravações e detalhes das ligações. Um ticket de telefone vem com as mensagens dele.
  • O CC e o CCO dos e-mails.
  • Tickets no spam ou na lixeira, e mensagens excluídas. Um ticket que o Gorgias mesclou com outro já faz parte desse outro.
  • O fato de o Gorgias não ter conseguido enviar uma resposta: essa resposta chega como enviada.

O que fica interno

O Deskwoot mantém privado o que só a sua equipe via no Gorgias:

  • Notas internas chegam como notas privadas, e a nota de um cliente vira uma nota do contato. Só a sua equipe vê essas notas.
  • O cartão de uma conversa que indica o ticket do Deskwoot dela também é privado.
  • Filtros salvos criados a partir das visualizações do Gorgias pertencem ao administrador que iniciou a importação.

Antes de começar

  1. No Gorgias, abra Settings > REST API como administrador. Clique em Create API Key, ou copie a chave que já está lá. A mesma página mostra o seu Username, que é o seu e-mail. Só um administrador ou o dono da conta pode criar uma chave, e uma chave lê com as permissões da pessoa que a criou, então use a chave de um administrador: assim a importação consegue ler todas as partes do seu helpdesk.
  2. Anote o seu subdomínio do Gorgias: sua-empresa de sua-empresa.gorgias.com.
  3. O Gorgias oferece a API REST em todos os planos de Helpdesk dele, então você não precisa de nenhum plano específico do Gorgias para a importação.
  4. Convide os membros da sua equipe para o Deskwoot com o mesmo e-mail que eles usam no Gorgias. Você também pode fazer isso depois.
  5. Para que os tickets importados cheguem a uma caixa de entrada, configure antes as suas caixas de entrada de e-mail, Telegram, WhatsApp ou SMS.

Como importar

  1. No Deskwoot, vá em Configurações > Importação e migração. Só administradores podem importar.
  2. Em De onde vêm seus dados?, escolha Gorgias.
  3. Digite o Subdomínio, o E-mail (o Username que o Gorgias mostra junto da sua chave) e a Chave da API.
  4. Em O que deve vir junto?, escolha o que vem junto. Por padrão está tudo marcado. Para importar só os tickets mais recentes, escolha um dia em Somente tickets criados a partir de.
  5. Em Para qual caixa de entrada vão os tickets?, escolha uma caixa de entrada para cada tipo de ticket (E-mail, Chat, Formulários e central de ajuda, Telefone, WhatsApp, SMS, Todo o resto), ou deixe Nenhuma caixa de entrada. Só caixas de entrada de e-mail, Telegram, WhatsApp e SMS aparecem como opção. Na sua primeira importação do Gorgias, uma caixa de entrada de e-mail, WhatsApp ou SMS que é a única do tipo no seu workspace já vem escolhida.
  6. Clique em Iniciar importação. O Deskwoot primeiro confere o subdomínio, o e-mail e a chave com o Gorgias. Se o Gorgias recusar, o painel avisa e nada começa.

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. Em Quão rápido a importação vai, ela mostra quantas chamadas de API por minuto a sua conta do Gorgias permite e quantas delas a importação usa no máximo.
  • O Gorgias permite que uma chave da API faça 40 chamadas a cada 20 segundos (a cada 10 segundos no plano Enterprise dele). A importação usa no máximo 85% disso, para que os seus outros apps continuem funcionando. Se mesmo assim o limite for 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 Gorgias parar de responder, 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. Se o Gorgias não aceitar mais a chave, por exemplo porque alguém a excluiu, a execução para: inicie uma nova importação com uma chave válida, e ela pula o que já está no Deskwoot.

Tickets e respostas dos seus agentes

Um ticket atribuído a um agente do Gorgias vai para o membro da equipe com o mesmo e-mail, e as respostas dele aparecem com ele como remetente. Com os tickets ligados, o ticket do Deskwoot também vai para esse membro da equipe. Se essa pessoa ainda não tem conta no Deskwoot, o ticket chega sem atribuição e as respostas dela mostram o nome com (importado).

Quando ela 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 esses tickets 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. Os tickets do Deskwoot que a importação criou também são histórico.

Caixas de entrada para os tickets importados

  • O Gorgias guarda o canal de cada ticket. A importação coloca cada ticket na caixa de entrada que você escolheu para o tipo dele, para que sua equipe possa responder por lá. Chat é o chat ao vivo no seu site e no seu app, Formulários e central de ajuda abrange os formulários de contato e a sua central de ajuda do Gorgias, Telefone abrange ligações e mensagens de voz, e Todo o resto abrange Facebook, Instagram, X, tickets criados pela API e todos os outros canais.
  • Um ticket 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. Os outros tickets chegam sem caixa de entrada.
  • Com os tickets ligados, a caixa de entrada vai para a conversa, e uma resposta enviada a partir do ticket do Deskwoot chega ao cliente por ela (veja Responder ao cliente a partir de um ticket).
  • Quando você roda a importação de novo, os tickets que você já importou desta conta do Gorgias também vão para as caixas de entrada escolhidas, se ainda não tiverem uma. Um ticket 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.
  • Cada importação no Histórico de importações mostra as caixas de entrada escolhidas e quantos tickets foram para uma delas.

Depois da importação

  • Um ticket sem caixa de entrada (porque você não escolheu uma para o tipo dele, ou o Deskwoot não consegue falar com o cliente por ela) precisa de uma antes da sua resposta: abra o ticket e escolha uma caixa de entrada no aviso Esta conversa não tem caixa de entrada. Para uma caixa de e-mail, WhatsApp ou SMS, você também pode adicionar ao contato o e-mail ou o número de telefone que falta e rodar a importação de novo.
  • Recrie as regras de que você precisa. Abra a importação no Histórico de importações: em Ainda a fazer, Verificar e ligar as regras leva você até elas. Dê a cada uma condições e ações do Deskwoot e depois ligue a regra.
  • Revise os filtros salvos e as macros: uma visualização do Gorgias pode filtrar por mais coisas do que o Deskwoot lê, e uma ação de macro sem equivalente no Deskwoot ficou de fora.

Perguntas frequentes

Posso iniciar a importação de novo?

Sim, é seguro. Uma nova execução encontra o que já está no Deskwoot e pula, então tickets, contatos, etiquetas e respostas prontas não ficam duplicados. Ela traz o que é novo ou estava faltando, por exemplo depois de uma execução que terminou com Importada em parte. Um ticket que mudou no Gorgias desde então recebe as mensagens novas e, enquanto ninguém da sua equipe tiver trabalhado nele no Deskwoot, também assume o novo status, assunto, prioridade, time e agente (no ticket do Deskwoot dele, se tiver um). Um contato que a importação criou recebe o que ainda falta, e nada do que a sua equipe preencheu é sobrescrito.

Respostas prontas e macros que a sua equipe mudou no Deskwoot continuam como você deixou. Uma regra que você recriou também continua, mas a nova execução não encontra mais a original e traz de novo a versão do Gorgias, desligada: exclua essa cópia se não precisar dela.

Lembre que conversas, contatos e notas que você excluiu ou apagou no Deskwoot desde a última importação voltam se o Gorgias ainda tiver esses dados, e o mesmo vale para contatos que você mesclou.

A importação terminou com "Importada em parte". E agora?

O Gorgias 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.

Meus contatos já estão no Deskwoot. A importação usa esses contatos?

Sim. Antes de adicionar um contato, a importação procura essa pessoa no Deskwoot: primeiro pelo ID do Gorgias, depois pelo endereço de e-mail, esteja ele escrito em maiúsculas ou minúsculas. Os tickets 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. Para a correspondência por ID, dê a cada contato o ID dele no Gorgias quando adicionar ou atualizar o contato pela API, no campo externalId: gorgias:, o seu subdomínio do Gorgias em minúsculas, dois pontos e o ID do cliente no Gorgias, por exemplo gorgias:acme:4711 para o cliente 4711 em acme.gorgias.com. Se todos os seus contatos já estão no Deskwoot, você pode desmarcar Contatos: cada ticket ainda vai para o contato dele, e um contato que o Deskwoot ainda não tem vem com o ticket.

Posso importar só uma parte dos meus dados?

Sim. Em O que deve vir junto?, tudo vem marcado por padrão, e você pode desmarcar Tickets, Contatos, Respostas prontas (as suas macros, com as macros do Deskwoot criadas a partir delas) e Avaliações de satisfação. Com um dia em Somente tickets criados a partir de, só vêm os tickets criados nesse dia ou depois. As avaliações só vêm junto com os tickets que elas avaliam, por isso essa opção fica cinza sem os tickets. Times, agentes, tags, campos, regras e visualizações sempre vêm junto. Se você deixar os contatos de fora, cada ticket importado ainda traz o próprio contato.

Cada importação no Histórico de importações mostra em Sua escolha 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.

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 do Deskwoot 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. Times, respostas prontas, macros, etiquetas, atributos customizados, regras de automação, filtros salvos 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 Gorgias mais de uma vez, exclua as importações da mais recente para a mais antiga: enquanto existir uma importação mais recente do Gorgias, o Deskwoot pede que você exclua essa primeiro.

O Deskwoot guarda a minha chave da API?

Só enquanto a importação roda, guardada de forma criptografada, para que ela possa continuar depois de uma reinicialização. Ela é apagada quando a importação termina.

Este guia foi útil?

Continue lendo

Perguntar ao Fynn sobre este guia

Receba uma resposta curta deste guia e do resto da Central de Ajuda.

Ainda precisa de ajuda?

Fynn responde no chat a partir destes guias, e você também fala com a equipe por lá.