Migrar sua organização do Google Workspace para o Google Chat
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
Esta página oferece uma visão geral dos apps do Google Chat que ajudam as organizações do Google Workspace a migrar para o Google Chat de outras plataformas de mensagens.
Como administrador do Google Workspace, você pode criar um app de chat que importe dados de mensagens de outras plataformas. Para importar dados, o app do Chat cria recursos da API Chat com base nas mensagens, anexos, reações, associações e espaços da sua organização.
Por que importar dados ao migrar para o Chat
A importação de dados para o Chat oferece uma experiência melhor para os usuários da sua organização, porque eles podem preservar o histórico e o contexto das plataformas de mensagens que usam. Em comparação com a cópia de dados de origem para espaços comuns, o uso de espaços do modo de importação tem as seguintes vantagens:
Preservação de carimbos de data/hora de criação de recursos. Você pode definir um tempo histórico para as datas/horas de criação de recursos de espaços e mensagens. Isso permite que os apps do Chat retenham o contexto histórico enquanto o usuário adota o Google Chat. Para mais informações, consulte Importar dados de mensagens para o Google Chat.
Os usuários finais não podem acessar ou visualizar espaços no modo de importação. Para evitar a interferência do usuário em um espaço que está passando pela importação de dados ou para evitar que o usuário confunda a visualização de uma importação de dados em andamento, os espaços no modo de importação ficam ocultos para os usuários finais. Quando a transferência for concluída e o espaço sair do modo de importação, você vai poder adicionar usuários a ele.
O Chat desativa as notificações durante o modo de importação para que os usuários evitem alertas desnecessários sobre a migração.
Recursos da API Google Chat que podem ser criados para importar dados de mensagens
Para importar dados de mensagens, crie recursos da API Chat com base nos dados de outra plataforma de mensagens. Crie esses recursos nos espaços do Chat no modo de importação. Só é possível usar espaços do modo de importação durante o processo de importação.
É possível criar os seguintes recursos da API Chat nos espaços do modo de importação:
Os anexos podem ser enviados para espaços no modo de importação com a API Google Chat, mas recomendamos o uso da API Google Drive para fazer upload de arquivos e vincular os URIs dos arquivos às respectivas mensagens nos espaços no modo de importação para evitar o limite interno do Google Chat para upload de anexos.
As associações históricas precisam ser importadas quando um espaço está no modo de importação. Não é possível importar associações históricas depois que o espaço sai do modo de importação.
As outras associações atuais na plataforma de mensagens original vão precisar ser criadas depois que um espaço sair do modo de importação.
Os membros precisam ser usuários dentro do mesmo domínio.
Espaços. Somente SpaceType.SPACE e SpaceType.GROUP_CHAT são aceitos.
Mapear dados de origem para recursos do Google Chat
Ao importar dados de plataformas de mensagens de origem para o Google Chat, consulte os recursos compatíveis que podem ser criados no Chat. Em seguida, determine as entidades de origem que você quer importar e mapeie cada uma delas para um recurso do Chat. Depois de planejar os mapeamentos de recursos, leia as entidades da plataforma de mensagens de origem e as grave nos espaços do modo de importação.
Temas relacionados
Para saber como fazer a autenticação com a API Chat ao usar espaços no modo de importação, consulte Autorizar apps do Google Chat.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-12-03 UTC."],[[["\u003cp\u003eGoogle Chat apps can import messaging data (messages, attachments, reactions, memberships, spaces) from other platforms to Google Chat for Google Workspace users.\u003c/p\u003e\n"],["\u003cp\u003eImporting data preserves historical context and provides a better user experience during migration.\u003c/p\u003e\n"],["\u003cp\u003eImport mode spaces are used for data import and are hidden from end-users until the import is complete to prevent interference.\u003c/p\u003e\n"],["\u003cp\u003eChat apps have 90 days to import data into an import mode space before it's automatically deleted.\u003c/p\u003e\n"],["\u003cp\u003eGoogle recommends using Google Drive API for uploading attachments during import to avoid hitting Google Chat's internal limits.\u003c/p\u003e\n"]]],["Google Workspace administrators can create Chat apps to import data from other messaging platforms into Google Chat. These apps create Chat API resources like messages, attachments, reactions, memberships, and spaces within import mode spaces. This preserves historical context and user experience, hiding spaces during the import process and disabling notifications. Admins map data from the source platform to Chat resources and must complete the import within 90 days; otherwise, spaces are deleted. It is recommended to use the Google Drive API to handle attachment upload.\n"],null,["This page provides an overview about Google Chat apps that help\nGoogle Workspace organizations migrate to Google Chat from other\nmessaging platforms.\n\nAs a Google Workspace administrator, you can create a\nChat app that imports messaging data from\nother messaging platforms. To import data, the Chat app\ncreates [Chat API resources](/workspace/chat/api/reference/rest)\nbased on existing messages, attachments, reactions, memberships,\nand spaces in your organization.\n\nWhy import data when migrating to Chat\n\nImporting data to Chat provides a better experience for users\nin your organization because they can preserve history and context from\nexisting messaging platforms that they use. In comparison to copying source data\ninto regular spaces, the use of import mode spaces have the following\nadvantages:\n\n- Preservation of resource creation timestamps. You can set a historical time for the creation times of space and message resources, letting Chat apps retain historical context during user adoption of Google Chat. For more information, see [Import messaging data to Google Chat](/workspace/chat/import-data).\n- End users can't view or access spaces in import mode. To prevent user interference of a space undergoing data import, or to avoid possible user confusion as a result of viewing an in-progress data import, spaces in import mode are hidden from end users. After a space has completed import mode, you can add users to the space.\n- Chat turns off notifications during import mode, so that users can avoid unnecessary alerts about the migration.\n\nGoogle Chat API resources that you can create to import messaging data\n\nTo import messaging data, you create Chat API resources based on data\nfrom another messaging platform. You create these resources in *import mode*\nChat spaces. You can only use import mode spaces during the\nimport process.\n| **Warning:** After you've created an import mode\n| space, Chat apps have 90 days to complete the import of data for\n| a space. After 90 days, if the space is still in import mode, it's automatically\n| deleted and will be inaccessible and unrecoverable.\n\nYou can create the following Chat API resources in import mode spaces:\n\n- [Messages](/workspace/chat/api/reference/rest/v1/spaces.messages)\n- [Attachments](/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) with the following considerations:\n - Attachments can be uploaded to import mode spaces with Google Chat API, **however we highly recommend using\n [Google Drive API](https://developers.google.com/drive/api/reference/rest/v3)\n to upload files and link the file URIs to the respective messages in\n the import mode spaces instead to avoid hitting Google Chat internal\n limit for attachment upload.**\n- [Reactions](/workspace/chat/api/reference/rest/v1/spaces.messages.reactions)\n- [Memberships](/workspace/chat/api/reference/rest/v1/spaces.members)\n with the following considerations:\n\n - [Historical memberships](/workspace/chat/import-data#historical_memberships) must be imported when a space is in import mode. You can't import historical memberships after the space completes import mode.\n - Other existing memberships from the source messaging platform must be created after a space completes import mode.\n - Members must be users within the same domain.\n- [Spaces](/workspace/chat/api/reference/rest/v1/spaces).\n Only `SpaceType.SPACE` and `SpaceType.GROUP_CHAT` are supported.\n\nMap source data to Google Chat resources\n\nWhen importing data from source messaging platforms into Google Chat, review\nthe supported resources that you can create in\nChat. Then, determine the source entities that you want to import\nand map each one to a Chat resource. After you've planned the\nresource mappings, read the entities from the source messaging platform, and\nwrite them into import mode spaces.\n\nRelated topics\n\n- To learn how to authenticate with Chat API when using import mode spaces, see [Authorize Google Chat apps](/workspace/chat/authorize-import).\n- To learn how to start importing resources using import mode spaces, see [Import messaging data to Google Chat](/workspace/chat/import-data)."]]
