Importando do Tidio
Nesta página
Traga seus tickets, chats ao vivo, contatos e o conhecimento do Lyro do Tidio para o Deskwoot com a sua chave da API do Tidio. Por padrão vem tudo, 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 no seu projeto do Tidio. O Tidio só entrega uma parte dos dados de cada dia no dia seguinte, então inicie a importação de novo no dia seguinte para trazer o resto.
O que vem junto
- Tickets viram conversas com todas as mensagens, notas internas (como notas privadas), anexos, assunto, status e prioridade. As prioridades Low, Normal e High do Tidio viram Baixa, Média e Alta. O departamento vira a equipe e o agente vira o responsável (veja abaixo). As tags dos tickets viram etiquetas, e os campos personalizados dos tickets viram atributos customizados com seus valores.
- Tickets do Deskwoot: se o seu workspace usa tickets (o seu plano inclui tickets e eles estão ligados em Configurações > Tickets), cada ticket do Tidio também vira um ticket do Deskwoot ao lado da conversa. O ticket assume o status, a prioridade, o assunto, a equipe e o agente. A conversa mantém todas as mensagens, é resolvida na passagem para o ticket e mostra um card privado que cita o ticket. Sem tickets, a conversa mantém o status do Tidio.
- Chats ao vivo viram conversas, uma por chat, com suas mensagens e os arquivos enviados neles, inclusive os chats de visitantes que nunca deixaram um e-mail. As mensagens dos bots do Tidio (Flows, Workflows e Lyro) chegam sem agente. O primeiro agente que respondeu vira o responsável.
- Avaliações de satisfação de tickets e chats ao vivo, com o comentário do cliente, viram avaliações de CSAT na conversa correspondente.
- Contatos com nome, e-mail, telefone, idioma, país, cidade e consentimento de e-mail. As propriedades de contato viram atributos customizados com seus valores. As notas que os seus agentes escreveram sobre um visitante viram notas do contato. Um visitante sem contato no Tidio ganha um contato próprio.
- Departamentos viram equipes, menos o "General", que no Tidio reúne todos os agentes. Agentes são associados aos membros da sua equipe pelo e-mail (veja abaixo).
- Conhecimento do Lyro: as perguntas e respostas que o Lyro, o agente de IA do Tidio, usa para responder viram artigos de uma nova central de ajuda chamada "Tidio Lyro knowledge", só para a sua equipe (veja "O que fica interno").
Arquivos e imagens
A importação copia para o Deskwoot todos os arquivos que estão no Tidio: anexos de tickets, imagens e arquivos dentro das mensagens dos tickets, arquivos enviados em chats ao vivo e as imagens das respostas do Lyro. Nada fica como link para o Tidio, então os seus arquivos continuam funcionando depois que você sair do Tidio. Um link em uma resposta do Lyro que leva à sua central de ajuda do Tidio fica só com o texto, porque essa página some junto com a sua conta do Tidio. 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 Tidio 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 no Tidio.
- Imagens que uma mensagem ou um artigo carrega de outro site, como o seu, continuam como estão.
O que não vem junto
- Respostas prontas (o Tidio chama de Macros), Flows, Workflows e visualizações salvas. O Tidio não tem API para eles.
- Organizações, porque o Tidio não tem empresas.
- Tags de clientes, fotos de perfil dos contatos e os membros de cada departamento. Nenhuma API do Tidio entrega esses dados, então adicione os membros da sua equipe às equipes no Deskwoot.
- A sua central de ajuda do Tidio, porque o Tidio não tem API para ela. Um artigo que você ligou para o Lyro ou o Copilot vem com o conhecimento do Lyro, na medida em que o Tidio o lista ali.
- Arquivos que você enviou para o Lyro, como PDFs. As perguntas e respostas deles vêm, o arquivo em si não.
- Notas internas em chats ao vivo, porque as APIs do Tidio não as marcam como notas. Notas internas em tickets vêm como notas privadas.
- CC e CCO de tickets de e-mail.
- Tickets na pasta de spam do Tidio e tickets que você excluiu. O Tidio exclui um ticket que ele mescla com outro, e as mensagens dele vêm com esse outro ticket.
- As páginas que um contato visitou, os links para o seu painel do Tidio, o canal pelo qual um chat ao vivo chegou e se uma avaliação era para um agente ou para o Lyro.
O que fica interno
O conhecimento do Lyro é o que o agente de IA do Tidio usa para responder, não uma página para os seus clientes. Por isso a importação o guarda para a sua equipe:
- Toda categoria da central de ajuda "Tidio Lyro knowledge" é Só a equipe: uma para cada pasta do Lyro, com as subpastas abaixo dela, e uma chamada "Lyro Q&A" para as perguntas fora de qualquer pasta.
- Perguntas e respostas que o Lyro ou o Copilot do Tidio usa chegam publicadas. As que estão desligadas no Tidio chegam como rascunhos.
- Uma nova importação do mesmo projeto deixa essas categorias de novo como só a equipe e devolve para a categoria do Lyro um artigo que a sua equipe colocou em uma categoria Para clientes.
Artigos só para a equipe aparecem apenas para a sua equipe no painel: na Central de Ajuda, escolha "Tidio Lyro knowledge" e Só a equipe. Clientes, o widget de chat e o Fynn, o bot de IA, nunca os veem, e o Copilot usa os publicados quando responde à sua equipe. Saiba mais em Artigos para clientes e artigos só para a equipe.
Antes de começar
- Confira o seu plano do Tidio: o Tidio documenta a API dele para os planos Plus e Premium. Se o Tidio não permite acesso à API para o seu projeto, o Deskwoot avisa quando você inicia a importação.
- No Tidio, abra Settings > Developer > Tidio APIs como dono do projeto ou administrador.
- Clique em Generate API key e copie o Client ID e o Client secret. O Tidio mostra o secret só uma vez.
- Convide os membros da sua equipe para o Deskwoot com o mesmo e-mail que eles usam no Tidio. Você também pode fazer isso depois.
- Para que os tickets importados caiam em uma caixa de entrada, configure antes as suas caixas de entrada de e-mail, Telegram, WhatsApp ou SMS.
Como importar
- No Deskwoot, vá em Configurações > Importação e migração. Só admins podem importar.
- Em De onde vêm seus dados?, escolha Tidio.
- Cole o Client ID (começa com
ci_) e o Client secret (começa comcs_). - Em O que deve vir junto?, escolha o que vem. Por padrão, tudo está marcado. 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 (E-mail, Chat, Formulários e central de ajuda, Telefone, WhatsApp, SMS, Todo o resto), ou deixe Nenhuma caixa de entrada. Isso vale para os seus tickets do Tidio: chats ao vivo não ganham caixa de entrada. Só aparecem caixas de entrada de e-mail, Telegram, WhatsApp e SMS. Se o seu workspace tem exatamente uma caixa de entrada de e-mail, WhatsApp ou SMS, ela já vem escolhida para esse tipo.
- Clique em Iniciar importação. Primeiro o Deskwoot confere o Client ID e o Client secret com o Tidio. Se o Tidio os 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 a etapa atual e quantos registros já foram processados. Depois de alguns minutos de medição, 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 Tidio permite e quantas a importação usa no máximo.
- O Tidio limita as chamadas de API de cada projeto por minuto (a documentação dele cita 60 no Plus e 120 no Premium). A importação usa no máximo 85% desse limite, para que os seus outros apps continuem funcionando. Se o limite for atingido mesmo assim, a importação espera e depois continua.
- Atualizações do Deskwoot e reinícios do servidor não a interrompem. Ela continua de onde parou. Se uma execução travar ou ficar parada 3 vezes seguidas sem avançar, a importação para e avisa. Inicie de novo para continuar.
- Só roda uma importação por vez em cada workspace. 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é ali é excluído. Uma conversa em que alguém escreveu desde então mantém essas mensagens novas.
- Se o Tidio parar de responder ou recusar uma lista, a importação mantém o que já leu, termina as outras etapas e acaba com Importada em parte e as etapas que pararam antes do fim. Inicie a importação novamente para continuar.
As conversas e respostas dos seus agentes
Um ticket atribuído a um agente do Tidio, e um chat ao vivo que um agente respondeu primeiro, vão para o membro da equipe com o mesmo e-mail, e as respostas do agente aparecem com essa pessoa como remetente. Com os tickets ligados, o ticket do Deskwoot também vai para essa pessoa. Se ela ainda não tem conta no Deskwoot, a conversa chega sem responsável e as respostas mostram o nome dela com (importado). Agentes que você removeu do Tidio mantêm o nome nas respostas do mesmo jeito.
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 responsável são atribuídas a ela e ela vira a remetente das respostas. Conversas abertas, pendentes e adiadas vêm com uma única notificação para todas. As resolvidas são atribuídas em silêncio. Nenhum status muda, e os seus clientes não percebem nada. Uma conversa que alguém no Deskwoot já assumiu fica como está. Os tickets do Deskwoot criados pela importação não são passados assim: atribua esses à mão.
Conversas importadas ficam em silêncio
Conversas importadas são histórico, então 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 para o limite mensal de conversas do seu plano e nunca são bloqueadas por ele, mesmo depois que o cliente escreve de novo. Resolver ou reabrir uma conversa à mão não dispara nenhum webhook nem nenhuma regra de automação. A partir da primeira mensagem nova, a conversa funciona como qualquer outra, exceto que o Fynn, o bot de IA, nunca responde em uma conversa importada. Os tickets do Deskwoot criados pela importação também são histórico.
Caixas de entrada para tickets importados
- O Tidio registra de onde veio cada ticket, por exemplo de um e-mail ou de um formulário de contato. A importação coloca a conversa de cada ticket na caixa de entrada que você escolheu para o tipo dele, para que a sua equipe possa responder ali. Chats ao vivo não ganham caixa de entrada.
- O Tidio só informa de onde veio um ticket no dia seguinte (veja "Depois da importação"). Por isso um ticket de hoje chega sem caixa de entrada, e a importação no Histórico de importações o conta em Conversas sem canal salvo. Uma execução no dia seguinte o coloca na caixa de entrada que você escolheu.
- Uma conversa só vai para uma caixa de entrada pela qual o Deskwoot consegue falar com o cliente: uma caixa de entrada 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ê inicia a importação de novo, as conversas importadas antes também vão para as caixas de entrada que você escolher, se ainda não tiverem uma. Uma conversa que já tem caixa de entrada, ou em que alguém da sua equipe escreveu, fica onde está. A próxima importação começa com as caixas de entrada da última.
- A importação no Histórico de importações mostra as caixas de entrada escolhidas e quantas conversas foram para uma delas.
Depois da importação
- Inicie a importação de novo no dia seguinte. O Tidio preenche a API de Analytics dele, de onde vêm os chats ao vivo, as avaliações e as notas sobre os contatos, uma vez por dia: os dados de cada dia chegam no dia seguinte por volta das 10:00 UTC. Os tickets e as mensagens deles vêm na hora, mas do dia atual a primeira execução ainda não consegue trazer tudo: os chats ao vivo (na hora só vêm os chats de contatos que o Tidio criou desde a última atualização diária), as avaliações deles, as notas novas sobre contatos, e as tags, os valores dos campos e a caixa de entrada dos tickets de hoje. Uma execução depois das 10:00 UTC do dia seguinte traz o que faltou e não duplica nada.
- Uma conversa sem caixa de entrada (porque você não escolheu nenhuma para o tipo dela, o Deskwoot não consegue falar com o cliente ali ou ela é um chat ao vivo) 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. Se você escolheu caixas de entrada, a importação no Histórico de importações conta em Ainda a fazer os tickets que ficaram sem uma.
- Adicione os membros da sua equipe às equipes que vieram dos seus departamentos.
Perguntas frequentes
Qual plano do Tidio eu preciso?
O Tidio documenta a API dele para os planos Plus e Premium. Quando você clica em Iniciar importação, o Deskwoot primeiro consulta o Tidio sobre o seu projeto. Se o Tidio não permite acesso à API para ele, o painel avisa e nada é importado: confira o seu plano do Tidio e depois inicie a importação novamente.
Faltam alguns chats de hoje. Por quê?
O Tidio entrega os chats ao vivo, as avaliações, as notas sobre contatos e alguns dados dos tickets pela API de Analytics dele, que o Tidio preenche uma vez por dia: os dados de cada dia chegam no dia seguinte por volta das 10:00 UTC. Inicie a importação de novo depois desse horário. Ela traz o que faltou, por exemplo os chats de hoje, as avaliações deles e a caixa de entrada dos tickets de hoje, e não duplica nada.
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. Um ticket ou chat que mudou no Tidio assume o novo status, desde que ninguém da sua equipe tenha escrito nele. Uma mensagem nova em um ticket que você já importou vem na hora quando outra coisa do ticket também mudou (status, prioridade, agente, departamento ou assunto), e senão com uma execução no dia seguinte.
Respostas do Lyro que a sua equipe editou no Deskwoot mantêm o texto novo. Uma resposta desligada no Tidio desde então vira rascunho, mas só se a sua equipe não a editou.
Lembre que conversas, contatos e notas que você excluiu ou apagou no Deskwoot desde a última importação voltam se o Tidio ainda os tiver. O mesmo vale para contatos que você mesclou.
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 Conversas (seus tickets e chats ao vivo), Contatos, Base de conhecimento (o seu conhecimento do Lyro) 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. As avaliações só vêm junto com as conversas que elas avaliam, então essa opção fica cinza sem as conversas. Equipes, agentes e campos sempre vêm, e as etiquetas vêm com as conversas. Se você deixar os contatos de fora, cada conversa importada traz mesmo assim o próprio contato, sem as notas.
Quando você abre uma importação no Histórico de importações, Sua escolha mostra 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.
Os meus contatos já estão no Deskwoot. A importação usa esses contatos?
Sim. Antes de adicionar um contato, a importação procura a pessoa no Deskwoot: primeiro pelo ID do Tidio, depois pelo endereço de e-mail, esteja ele em maiúsculas ou minúsculas. As conversas dessa pessoa vão então para o contato que você já tem, e o nome, os dados e os campos dele ficam como estão. Para a correspondência por ID, dê a cada contato o ID do Tidio quando você o adicionar ou atualizar pela API, no campo externalId: tidio:, o ID do seu projeto do Tidio (a API do Tidio o chama de project_id), dois-pontos e o ID do contato na API do Tidio, por exemplo tidio:1234567:5f1c2b9e-8a7d-4c3b-9e21-0d4f6a7b8c9d. Se todos os seus contatos já estão no Deskwoot, você pode desmarcar Contatos: cada conversa vai mesmo assim para o contato dela, e um contato que o Deskwoot ainda não tem chega com a conversa.
Como desfaço uma importação?
No Histórico de importações, clique em Excluir ao lado da importação e digite a sua senha. Isso exclui 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, agentes, etiquetas, campos, o conhecimento do Lyro e outras configurações continuam. A exclusão continua depois de um reinício, e você pode iniciar uma nova importação quando ela terminar. Enquanto outra importação está rodando, nenhuma importação pode ser excluída. Se você importou do Tidio mais de uma vez, exclua as importações da mais nova para a mais antiga: enquanto existir uma importação mais nova do Tidio, o Deskwoot pede que você exclua essa primeiro.
Este guia foi útil?
Continue lendo
- 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
- Planos e preços: o que cada plano do Deskwoot incluiPreços, limites e recursos dos planos Hacker, Startup, Business e Enterprise, como as conversas de IA são contadas e o que acontece quando o teste termina ou quando você muda de plano.Ler guia
- Equipes: encaminhe conversas por departamento, idioma ou habilidadeEquipes agrupam agentes para que as conversas cheguem às pessoas certas: como as conversas chegam a uma equipe, quem da equipe recebe, as pastas da equipe, o que os membros veem e relatórios por equipe.Ler guia
Perguntar ao Fynn sobre este guia
Receba uma resposta curta deste guia e do resto da Central de Ajuda.