# Integrações Conheça o catálogo de serviços e diferencie uma opção disponível de uma conexão reconhecida e de uma tarefa testada. Fonte: https://guides.adapta.org/guias/one/recursos-do-one/integracoes/ **TL;DR** · Integrações apresentam serviços externos que podem fornecer informações ou executar ações a partir do One. Você pode consultar o catálogo e os detalhes sem conectar. ![Gravação do Adapta One: o painel de Integrações abre com a busca, os filtros por categoria e o catálogo de serviços, cada cartão descrevendo a ação que a integração executa.](https://guides.adapta.org/media/screenshots/one/integracoes-2026-09-21/one-integracoes-v2.lossless.webp) *Repare no que cada cartão promete fazer, não no nome do serviço: é a descrição da ação que permite julgar se aquele acesso é necessário.* ## Entenda os três estados **Disponível no catálogo:** o serviço aparece em **Integrações**, com descrição e ações anunciadas. É um ponto de partida para avaliar, não uma garantia de que sua conta atende aos requisitos. **Conectada na interface:** o serviço aparece em **Conectadas** e pode mostrar **Desconectar**. **Testada para uma tarefa:** uma ação específica foi executada com entrada autorizada e o resultado foi conferido. Consultar um catálogo ou receber uma resposta escrita no chat não substitui essa verificação. Neste guia, o teste cobre a navegação do catálogo, não ações nos serviços externos. Em 10/09/2026 e novamente em 11/09/2026, o painel de Integrações não chegou a exibir os cartões de serviço: tanto a aba **Integrações** quanto **Conectadas** ficaram travadas nos blocos cinza de carregamento, mesmo depois de mais de 10 segundos, de limpar a busca e de reabrir o painel do zero. Se isso acontecer com você, feche e reabra o painel; persistindo, é uma falha da plataforma, não um passo que faltou no seu pedido. As duas datas diferem num detalhe técnico observado de fora da aplicação, sem inspecionar código: em 10/09/2026, nenhuma chamada de dados chegou a sair do navegador nesse tempo. Em 11/09/2026, a chamada que busca o catálogo (`/api/integrations/v1`) foi vista completando com sucesso, mas os cartões continuaram travados mesmo assim. Isso sugere que, nesta data, o problema estava mais na renderização da resposta do que na ausência dela, mas essa é uma leitura externa, não uma causa confirmada. ![Painel de Integrações travado no carregamento: seis blocos cinza no lugar dos cartões de serviço, nas abas Integrações e Conectadas.](https://guides.adapta.org/media/screenshots/one/integracoes-2026-09-10/catalogo-travado-carregando.png) *Estado capturado em 10/09/2026 e reconfirmado visualmente em 11/09/2026: o catálogo não chegou a carregar em nenhuma das duas datas.* ## O que aparece no catálogo Na inspeção de 09/09/2026, foram observados os serviços abaixo. As finalidades são descrições da interface, não resultados de execução nem uma lista garantida para todas as contas. Essa lista não foi reconfirmada na inspeção mais recente, porque o painel não chegou a carregar. - **Gmail e Outlook:** consulta e organização de e-mails, com ações de resposta descritas. - **Google Calendar:** eventos, lembretes e agendamento. - **Google Sheets e Microsoft Excel:** planilhas, atualização de dados, análises e gráficos. - **Google Drive:** pesquisa e uso de arquivos como fonte. - **Google Docs e Notion:** documentos, páginas e conteúdos. - **Miro:** quadros e conteúdos visuais. - **Metabase:** consulta de dados, métricas e painéis. O painel oferece **Pesquise**, categorias, **Todos** e a aba **Conectadas**. A busca por Google retornou Gmail, Calendar, Sheets, Drive e Docs; o filtro **Agenda** mostrou Google Calendar. Uma pesquisa sem correspondência exibiu **Nenhuma integração encontrada**. Limpe a busca e confira a categoria antes de concluir que um serviço não está disponível. Apesar de os cartões não carregarem em 11/09/2026, a barra de categorias foi renderizada por completo, com paginação por setas. Os nomes lidos diretamente da interface nessa data foram: **Todos, Análise de dados, Comunicação, Agenda, Gestão de Documentos, Produtividade, Design, Desenvolvimento, CRM e Vendas, Marketing, Financeiro, RH, Suporte, Armazenamento, Automação e Outros**. Isso amplia o que havia sido visto em 09/09/2026, quando só o filtro Agenda tinha sido testado. Ainda assim, nenhuma categoria pôde ser conferida de fato: como os cartões não carregaram, não há confirmação de quais serviços pertencem a cada grupo, nem de que clicar numa categoria retorna algum resultado. ## Dois conceitos gerais para avaliar uma integração Catálogos de integração de mercado costumam separar dois papéis. Um **gatilho** é um evento que dispara um fluxo automaticamente a partir do serviço externo, por exemplo quando chega um contato novo. Uma **ação** é uma operação executada sob comando, como ler, criar ou alterar um registro. Também é comum ver dois esquemas de autenticação: **OAuth**, que delega acesso sem compartilhar a senha, e **chave de API**, um token fixo associado a uma aplicação. Essas definições são conceitos gerais do mercado de integrações; não descrevem como o Adapta One implementa esse fluxo por trás dos panos, e nada disso foi confirmado no código do produto. As categorias listadas acima seguem o mesmo padrão de organização por finalidade que ferramentas do gênero costumam adotar, o que pode ajudar a prever em qual grupo procurar um serviço, mas não substitui a pesquisa pelo nome. ## Quando uma integração agrega Imagine a empresa fictícia Aurora IA, que oferece cursos e software. A equipe quer preparar uma reunião semanal a partir de uma planilha de inscrições e de pendências recebidas por e-mail. Antes de conectar, separe duas necessidades: **consultar as fontes** e **alterar os serviços**. Ler uma planilha não exige, por si só, enviar mensagens, compartilhar arquivos ou mudar células. Para uma análise pontual, uma seleção revisada de dados sintéticos no pedido pode ser suficiente. Para avaliar acesso recorrente à fonte, examine o serviço e suas ações. Não conecte todas as ferramentas da empresa apenas para experimentar. Consulte [Confira ações e permissões](https://guides.adapta.org/guias/one/recursos-do-one/integracoes/escolher/) para decidir o que a tarefa realmente precisa. Para percorrer o painel sem conceder acesso, siga [Inspecione antes de conectar](https://guides.adapta.org/guias/one/recursos-do-one/integracoes/conectar-testar/). **Dica dos cursos Adapta:** na aula 12, **Criando credenciais**, de **Automatizando com IA**, o exemplo distingue instruções conforme o ambiente utilizado. Ao pedir ajuda, informe o produto, o serviço e o estado que você vê. ## Limites e cuidados Plano, abrangência dos acessos, limites por serviço, expiração e recuperação precisam ser confirmados no fluxo correspondente. Não há promessa de sincronização automática ou acesso somente de leitura. Não coloque senhas, chaves ou códigos de autenticação no chat. Antes de usar dados da empresa ou de clientes, confirme a autorização e quais informações podem sair do serviço de origem. Dados médicos, jurídicos, financeiros ou pessoais reais não são material de demonstração. Para trabalhar com arquivos escolhidos por você, consulte [Arquivos](https://guides.adapta.org/guias/one/recursos-do-one/arquivos/). Anexo, referência de projeto e integração externa são caminhos diferentes. Quer aplicar o One em outras tarefas? Confira os [casos de uso do Adapta One](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/one/).