Skip to main content

Como iniciar a importação

Abra docs.craft.do/import/quip no navegador e entre na sua conta do Craft, caso ainda não tenha feito isso.

Obtenha seu token de acesso do Quip

O Craft se conecta ao Quip por meio de um token de acesso pessoal que você mesmo gera.
1

Abra a página de tokens do Quip

Acesse quip.com/dev/token com a sessão iniciada na conta do Quip de onde você quer importar.
2

Gere e copie seu token

Clique em Get Personal Access Token e copie o token exibido.
Seu token de acesso dá acesso total a tudo na sua conta do Quip. Não o compartilhe nem o publique em lugar algum.
O token dá ao Craft acesso a tudo que sua conta do Quip enxerga: seus documentos privados, além das pastas compartilhadas e de grupo das quais você participa. Você não precisa liberar o acesso documento por documento.

Importe seus documentos

1

Cole seu token de acesso

Cole o token no campo da página de importação.
2

Escolha o destino

Selecione o Craft Space onde seus documentos do Quip devem aparecer. Se quiser, escolha uma pasta de destino para manter o conteúdo importado junto.
3

Configure as opções

Se quiser, ative Incluir comentários para trazer seus comentários do Quip junto com os documentos.
4

Inicie a importação

Clique em Import. Você verá uma barra de progresso enquanto seus documentos são importados. Pode fechar a página a qualquer momento: a importação continua em segundo plano.
O Quip limita a velocidade com que seus dados podem ser lidos. Se a sua conta for grande, a importação pausa e recomeça sozinha até que tudo seja transferido — algumas centenas de documentos podem levar quinze minutos ou mais. Não é preciso manter a página aberta.

Depois da importação

Ao terminar, você verá uma confirmação com um botão que leva ao Craft, onde encontrará seus documentos importados.

O que o Craft não conseguiu trazer

Algumas coisas do Quip não têm equivalente no Craft e, de vez em quando, um arquivo não é baixado. Em vez de deixar isso para você descobrir sozinho, ao final da importação o Craft lista tudo o que não conseguiu trazer por completo, junto com os documentos afetados, para você conferir. Você pode ver o seguinte:
  • Documentos que não puderam ser importados — chats e apresentações, ou um documento que o Quip não retornou.
  • Imagens ou anexos que não puderam ser baixados — o documento foi importado sem eles.
  • Live Apps importados como tabelas — o conteúdo está lá, mas não é mais interativo.
  • Comentários que não puderam ser importados — o documento chegou sem eles.
  • Arquivos anexados a comentários — o texto do comentário veio, o arquivo anexado não.
  • Comentários que perderam o lugar — ficam ligados ao documento em vez do trecho a que se referiam.
Um resumo assim é normal, especialmente em contas grandes, e seus documentos já estão no Craft. Ele existe para você saber exatamente o que conferir, não para avisar que algo deu errado.
Um chat ou uma apresentação que não foi importado não tem documento no Craft para abrir, então aparece apenas pelo nome. Todo o resto leva direto ao documento importado.

O que é trazido

Títulos, negrito, itálico, tachado, código em linha, links, destaques, listas com marcadores e numeradas, listas de tarefas, tabelas, blocos de código, divisores e citações.O Quip tem sublinhado e o Craft não, então o texto sublinhado chega com um destaque cinza-claro: a ênfase é preservada, mesmo que o estilo exato não seja o mesmo.
Sua estrutura de pastas é recriada no Craft, e os documentos que você marcou com estrela no Quip chegam como favoritos.No Quip, um documento pode estar em várias pastas ao mesmo tempo. O Craft coloca cada documento em uma só, então um documento importado vai para a primeira pasta em que foi encontrado. Pastas vazias não são recriadas.
Imagens e arquivos anexados são baixados e enviados novamente para o Craft, então continuam funcionando depois da importação: não são apenas links de volta para o Quip.
Uma planilha do Quip vira uma tabela do Craft, que você pode ler e editar ali mesmo. O arquivo .xlsx original também é anexado ao documento, então nada do original se perde.
Viram coleções do Craft, com suas colunas como propriedade de status e cada cartão mantendo o seu. As cores das colunas são preservadas.
As menções de data do Quip viram datas de verdade no Craft, em vez de texto simples.
Se você ativar Incluir comentários, os comentários e suas respostas são trazidos com os nomes dos autores e os horários originais, ancorados ao texto sobre o qual foram escritos.

Limitações

A maioria destes casos aparece no resumo depois da importação, indicando os documentos afetados. Os dois marcados abaixo não são sinalizados, porque não há nada faltando para o Craft relatar.
  • Chats e apresentações não são importados. O Craft não tem equivalente para nenhum dos dois, então conversas e apresentações do Quip são ignoradas. Documentos e planilhas são importados.
  • Live Apps que não sejam quadros Kanban e Project Trackers — calendários, por exemplo — são importados como uma tabela simples com o conteúdo. As informações estão lá, mas não são mais interativas.
  • Arquivos anexados a comentários não são importados. O texto do comentário vem; o arquivo anexado não.
  • Alguns comentários podem perder o lugar. Se o texto sobre o qual um comentário foi escrito não existe mais na exportação do Quip, o comentário é ancorado ao documento como um todo em vez daquele trecho. Nada se perde, mas ele pode não estar onde você espera.
  • Modelos são importados como documentos comuns (não sinalizado). Um modelo do Quip chega como um documento normal do Craft, não como um modelo do Craft. Todo o conteúdo está lá — ele só não está configurado como modelo.
  • Documentos na lixeira do Quip não são importados (não sinalizado). O Craft enxerga apenas os documentos que sua conta do Quip mantém fora da lixeira.
A importação apenas lê do Quip. Nada na sua conta do Quip é movido, editado ou excluído, então você pode continuar usando normalmente e repetir a importação se precisar.

Solução de problemas

Confira se você copiou o token inteiro em quip.com/dev/token. Se não tiver certeza de que o token colado é o atual, abra a página de novo e copie o token exibido.
Isso significa que o token funcionou, mas o Craft não conseguiu ver nenhum documento por meio dele. Certifique-se de ter gerado o token com a sessão iniciada na conta certa do Quip: se você tem mais de uma, é fácil criar um token para a errada.
Normalmente são os limites de taxa do Quip, e não um problema. A importação pausa e recomeça sozinha, e continua rodando depois que você fecha a página. Contas grandes podem levar um tempo.
Um documento que está em várias pastas do Quip é colocado na primeira encontrada, então pode não estar onde você espera. Se um documento sumiu por completo, verifique se ele é um chat ou uma apresentação, que não são importados, e se está na lixeira do Quip.
Tente reiniciar a importação. Documentos que já foram trazidos não serão duplicados. Se o problema continuar, entre em contato com o suporte.