> For the complete documentation index, see [llms.txt](https://docs.adapta.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adapta.org/inicio-rapido/integracoes.md). # Integrações Quando você conecta o Gmail, o Adapta One pode ler e enviar emails por você. Quando conecta o Google Drive, pode buscar e criar documentos. Quando conecta o WhatsApp, pode enviar mensagens para os seus contatos. Tudo direto do chat, sem você precisar abrir outro app. Sem integração, a IA fica presa ao chat. Com integração, ela trabalha junto com as ferramentas da sua rotina. É a diferença entre pedir um conselho e pedir uma execução. {% embed url="" %} ⏱️ Leitura: 7 min · 🛠️ Mão na massa: 2 min · 📊 Nível: Iniciante ### 🎯 O que você vai dominar nesta página * Entender o que muda quando você conecta um app ao Adapta One. * Conectar sua primeira integração em menos de 2 minutos. * Reconhecer os três tipos de autenticação (OAuth, API Key, credenciais avançadas). * Pedir para o agente executar ações em apps conectados usando linguagem natural. * Gerenciar, desconectar e entender os cuidados de segurança. ### ⚡ Por que Integrações mudam o seu jeito de trabalhar Sem integrações, o trabalho é fragmentado. Você abre o chat para pedir um texto, abre o Gmail para enviar, abre o Drive para buscar o arquivo, abre o WhatsApp para avisar o time. Quatro apps, quatro cliques, quatro trocas de contexto. Com integrações, tudo isso acontece em uma conversa. Você descreve o que precisa e o agente executa nos apps certos. O chat deixa de ser um lugar onde você pede conselho e vira um lugar de onde você dispara ações reais. #### Sem Integração × Com Integração {% tabs %} {% tab title="Sem integração" %} Você: "Me ajuda a escrever um email avisando o time sobre o atraso da entrega." IA: gera o texto do email. Você: copia o texto, abre o Gmail, cria novo email, cola, adiciona destinatários e envia. Depois abre o WhatsApp e manda o resumo no grupo do time. Depois abre o Drive e atualiza o status no documento de acompanhamento. {% endtab %} {% tab title="Com integração" %} Você: "Envie para o time pelo Gmail um email avisando sobre o atraso da entrega, mande um aviso no WhatsApp para o grupo e atualize o status no documento de acompanhamento." IA: escreve, envia, posta e atualiza. Devolve o link de cada ação executada. {% endtab %} {% endtabs %} A diferença não é só tempo. É que a IA passa a executar de verdade, não apenas sugerir. Uma mesma mensagem sua pode disparar ações em três apps diferentes.
### 📦 As integrações disponíveis no Gold No plano Gold, você tem acesso a 11 integrações oficiais, organizadas por tipo de uso: | Categoria | Integrações | | -------------------------- | --------------------------------- | | Comunicação | Gmail, Outlook, WhatsApp | | Agenda | Google Calendar | | Documentos e arquivos | Google Docs, Google Drive, Notion | | Planilhas | Google Sheets, Microsoft Excel | | Quadros e análise de dados | Miro, Metabase | ### 🎯 Quando conectar uma integração Conecte uma integração quando: * Você quer que o agente execute ações em um app, não apenas gere texto sobre ele. * Você perde tempo copiando e colando conteúdo entre o chat e o app. * Você usa uma Skill que precisa terminar enviando um email, salvando um arquivo ou atualizando uma planilha. * Você quer que o agente busque informações que estão no seu Gmail, Drive ou Calendar para tomar uma decisão. Se você só quer que a IA gere texto e você mesmo coloque nos apps, pode seguir sem integração. Ela ganha valor quando você quer economizar os passos de copiar, colar, abrir e fechar. {% hint style="info" %} Integração não substitui o app. Ela dá ao agente permissão para usar o app em nome do usuário. O app continua funcionando normalmente para você do lado de fora. {% endhint %} ### 📋 Antes de começar Você vai precisar de: * Conta ativa no plano Gold. * Conta no app que você quer conectar (Gmail, Google Drive, Notion, etc.). * Alguns minutos para autenticar da primeira vez. ### 🛠️ Como conectar uma integração Existem dois caminhos para conectar. O primeiro é mais explícito, o segundo é mais natural. #### Você quer ver tudo que existe disponível Clique em **Integrações** na barra do chat. O painel abre com duas abas: * **Integrações**: catálogo completo dos apps disponíveis. * **Conectadas**: apps que você já ativou. Clique no card do app desejado. A tela **Visualizar Integração** abre com nome e descrição, o que você pode fazer com ele (tags de ações) e os detalhes da integração. Em seguida, clique em 🔗 **Conectar**. O fluxo de autenticação abre em uma nova aba. #### Você sabe o que quer fazer, não precisa saber que existe um painel Este é o caminho mais simples. Digite no chat o que você quer, citando o app: * "Se conecta ao meu Gmail." * "Quero usar o Google Drive." * "Preciso buscar arquivos no Notion." O agente reconhece a necessidade sozinho, identifica a integração certa e devolve um card de conexão com o botão **Conectar ↗** direto na resposta. Você clica, autoriza, volta para o chat e continua de onde parou. {% hint style="info" %} O link de conexão que aparece no chat expira. Se demorar para clicar, peça um novo ao agente: "gera novo link de conexão". {% endhint %} ### 🔐 Tipos de autenticação Cada app tem seu próprio jeito de autorizar acessos. A Adapta respeita o padrão de cada um. Você vai encontrar basicamente três variações na tela de conexão. #### Login social (OAuth) O mais comum. A tela redireciona para a página oficial do provedor (Google, Microsoft) e você faz login com a sua conta. O provedor mostra as permissões que o Adapta One está pedindo e você aceita. Usado em: Gmail, Google Drive, Google Calendar, Google Docs, Google Sheets, Outlook, Microsoft Excel, Notion, Miro. #### Chave de API Alguns apps usam chaves de API em vez de login. A Adapta mostra um campo simples pedindo a chave. Para obtê-la, entre no app externo, vá em configurações, procure por "API Keys" ou "Developer", gere uma nova chave, copie e cole no campo da Adapta. #### Credenciais avançadas Apps mais técnicos podem pedir vários campos de uma vez (secret, username, região). Cada campo tem uma explicação curta do que é. No Gold, isso costuma aparecer em integrações de análise de dados como o Metabase. {% hint style="info" %} No rodapé da tela de conexão aparece a frase "Secured by Composio". O Composio é o parceiro de infraestrutura que gerencia a camada de autenticação. Suas credenciais não ficam expostas para o Adapta. {% endhint %} ### 💬 Como o agente usa uma integração no dia a dia Depois de conectar, a integração vira parte do arsenal do agente. Ele reconhece sozinho quando usar, com base no que você pede. Você pede em linguagem natural e o agente executa. Exemplos reais de pedido: * "Mande um email para o João avisando que atrasei a entrega." * "Busque no meu Drive o documento sobre metas de Q2." * "Crie um evento no meu calendário amanhã às 15h com a Maria." * "Salve um resumo da reunião de hoje em uma página nova no Notion." * "Quantos emails não lidos eu tenho hoje?" O agente mostra o que está fazendo em um bloco estruturado no chat: * **Plano de ação**: o que ele entendeu do pedido e como vai resolver. * **Integrações Encontradas**: qual ação específica está sendo usada. Os nomes das ações aparecem em inglês, por exemplo "connect to Gmail account", "search emails", "send email". Isso é normal. * **Tarefa concluída**: selo verde de confirmação quando a ação terminou. {% hint style="info" %} Quanto mais específico o pedido, melhor o resultado. Em vez de "manda email para o time", diga "manda email pelo Gmail para \[lista], com assunto \[X], avisando que \[Y]". O agente segue exatamente o que você pediu. {% endhint %}
### 🎛️ Gerenciar suas integrações O controle das integrações fica na aba **Conectadas** do painel de Integrações. Ela mostra todos os apps ativos com um contador no título. Cada card de integração conectada tem um ícone de plug verde no canto direito. Para desconectar, clique no ícone de plug verde ao lado do nome da integração. A conexão é encerrada no mesmo clique. Quando você desconecta, o agente perde o acesso ao app imediatamente. Para voltar a usar, basta conectar de novo. {% hint style="warning" %} Desconectar na Adapta encerra o acesso do agente ao app, mas a autorização pode continuar ativa no lado do provedor (por exemplo, em myaccount.google.com). Para uma limpeza completa, revogue também no próprio app. {% endhint %}
### 🔒 Segurança e privacidade Integrações dão ao Adapta One acesso aos seus dados em apps externos. Esse acesso é poderoso e, por isso, merece atenção. Leia esta seção antes de conectar integrações sensíveis (Gmail, Drive, ferramentas financeiras). #### O que o Adapta One passa a acessar Cada integração concede um conjunto específico de permissões. Quando você autoriza, o provedor mostra exatamente o que está sendo liberado. Exemplos: * **Gmail**: ler, buscar, enviar e criar rascunhos de emails. * **Google Drive**: listar, abrir, criar e compartilhar arquivos. * **Google Calendar**: ler, criar e editar eventos. * **Notion**: ler páginas, criar páginas e atualizar bases. Leia a tela de permissões do provedor antes de aceitar. Se algum escopo parecer excessivo para o seu uso, não autorize. #### ⚠️ Cuidado com ações destrutivas O agente pode executar ações que não têm volta se você pedir de forma ampla. Exemplos de pedidos perigosos: "apaga todos os emails sobre \[tema]", "remove todos os arquivos da pasta X", "cancela todos os eventos da semana que vem". Antes de pedir ações de exclusão ou modificação em massa, faça três coisas: * **Seja específico**: em vez de "apaga todos os emails velhos", peça "lista os emails de \[remetente] antes de \[data] e me devolve a lista antes de apagar". * **Revise antes de confirmar**: peça para o agente listar o que será afetado e confirme item por item se necessário. * **Use conta de teste**: se está explorando uma automação nova com alto potencial destrutivo, teste primeiro em uma conta secundária.
**O que fazer se suspeitar de uso indevido** Se você perceber que o agente executou algo que não devia, ou se a conta usada na integração foi comprometida: 1. Desconecte a integração imediatamente pela aba **Conectadas** 2. Revogue o acesso da Adapta no próprio app (ex: [myaccount.google.com/permissions](https://myaccount.google.com/permissions)) 3. Altere a senha do app {% hint style="danger" %} Ações feitas por integração são executadas pela sua conta, não por uma conta da Adapta. Um email enviado pelo agente pelo seu Gmail aparece como enviado por você para o destinatário. Trate isso com a mesma responsabilidade de um envio manual. {% endhint %} *** ### 🔗 Integrações em Skills Integrações ganham outra dimensão quando combinadas com Skills. Uma habilidade customizada pode usar integrações para fechar o trabalho dentro do app certo: * A Skill de follow-up comercial pode terminar mandando o email pelo Gmail. * A Skill de criação de relatório pode salvar o resultado direto no Drive. * A Skill de registro de reunião pode criar a página no Notion já formatada. Para combinar, basta que a integração esteja conectada e a instrução da Skill mencione o que deve acontecer. O agente reconhece e aplica. ### 💼 3 Integrações na prática Três exemplos reais para calibrar como cada tipo de integração se comporta no dia a dia. | Perfil | Integração | Situação | O que pediu ao agente | Resultado | | ---------------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | | Carla, Diretora Comercial | Gmail | Recebe mais de 200 emails por dia, perdia mensagens críticas e gastava 45min por manhã triando a caixa | "Analise meus emails não lidos das últimas 24h e me devolve os 5 mais importantes para responder hoje, com sugestão de resposta curta para cada um" | 45min para 10min por manhã. Só revisa, ajusta e envia | | Pedro, consultor | Google Drive | Acumulou 3 anos de documentos e gastava 30min em cada projeto novo procurando template e cases anteriores | "Busca no Drive todos os documentos sobre \[cliente/indústria] dos últimos 3 meses e me devolve em ordem de relevância com resumo de 1 linha de cada" | 30min para 2min. Recuperou o conhecimento que já tinha acumulado | | Fernanda, Coordenadora de Projetos | Notion, via Skill | O time perdia as decisões das reuniões em anotações soltas e ela reformatava tudo toda semana | "Pegue as anotações que eu colar, resuma em decisões, responsáveis e prazos, e salve como uma página nova no Notion do time" | A base de conhecimento do time fica atualizada sem formatação manual | ### ✅ Como saber se funciona Sinais positivos: * O card da integração aparece na aba Conectadas com o plug verde. * Ao pedir uma ação, o agente mostra o bloco "Tarefa concluída" com selo verde. * A ação aparece de verdade no app (email enviado, arquivo criado, evento marcado). Sinais de alerta: * O agente diz que não tem acesso, mesmo você tendo conectado. * A tela de autenticação volta com erro. * O link de conexão no chat aparece expirado. * A ação é confirmada, mas não aparece no app do lado de fora. ### 🚨 Troubleshooting | O que você vê | O que significa | Como corrigir | | ---------------------------------------------------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | | O agente diz que não tem acesso, mesmo após conectar | A autorização não foi concluída ou expirou | Reconecte pela aba Conectadas ou peça "gera novo link de conexão" no chat | | A tela de autenticação volta com erro | Login não concluído ou permissões recusadas no provedor | Refaça o login e aceite todas as permissões solicitadas na tela do app | | O link de conexão no chat aparece expirado | O link tem validade curta e o tempo passou | Peça ao agente "gera novo link de conexão" e clique em seguida | | A ação é confirmada, mas não aparece no app | Conta errada conectada ou ação feita em local diferente do esperado | Confira qual conta foi autorizada na aba Conectadas e refaça o pedido com mais detalhes | | O app que você quer não está na lista | A integração não faz parte das 11 disponíveis no Gold | Use uma das integrações liberadas no Gold ou fale com o suporte | ### 🎯 Próximos passos {% tabs %} {% tab title="Começando agora" %} **1. Conecte sua primeira integração** Para a maioria, é o Gmail ou o Google Drive. Use o caminho do chat se quiser algo rápido: "se conecta ao meu Gmail". **2. Faça um pedido pequeno e reversível** Teste com leitura: "quantos emails não lidos eu tenho hoje?" ou "me lista os 5 arquivos mais recentes no Drive". Isso valida que a conexão está funcionando. **3. Leia a seção de Segurança antes de escalar** Se pretende pedir ações de escrita, revisite a seção de Segurança desta página. Os cuidados valem muito mais que o tempo de leitura. {% endtab %} {% tab title="Já está usando" %} **1. Audite sua lista de Conectadas** Pergunte para cada app: ainda uso esta integração? Desconecte o que não serve mais. Menos superfície exposta, menos risco. **2. Combine integrações com Skills** Transforme tarefas repetidas em Skills que já entregam no app certo. A Skill de relatório salva no Drive, a de follow-up envia pelo Gmail. **3. Compartilhe boas instruções com o time** Instruções específicas que geram bons resultados merecem virar Skill compartilhada. A próxima pessoa do time não precisa descobrir do zero. {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.adapta.org/inicio-rapido/integracoes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.