# 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 Slack, pode mandar mensagem no canal certo. Tudo direto do chat, sem você sair para 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 Slack 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, envia. > > Depois: abre o Slack, cola o resumo no canal do time. > > Depois: abre o Drive, 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 resumo no canal #projetos no Slack e atualize o status no documento de acompanhamento." > > IA: *\[escreve, envia, posta, 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. *** ### 🎯 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ê quer usar um **Play** (tarefa automática) que envia email, posta em grupo, cria documento ou atualiza planilha sozinho * 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 Adapta Workspace * Conta no app que você quer conectar (Gmail, Google Drive, Slack, 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. {% tabs %} {% tab title="Jeito A: pelo painel de Integrações" %} **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 nesta workspace No catálogo, navegue pelas categorias (Análise de dados, Comunicação, Agenda, Gestão de Documentos, Produtividade, Design e outras). Use a busca no topo se já souber qual app quer. 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) * Detalhes da integração Clique em **🔗 Conectar**. O fluxo de autenticação abre em uma nova aba. {% endtab %} {% tab title="Jeito B: pedindo no chat" %} **Você sabe o que quer fazer, não sabe nem 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 botão **Conectar ↗** direto na resposta. Você clica, autoriza, volta para o chat e continua de onde parou. {% hint style="warning" %} O link de conexão que aparece no chat expira. Se demorar para clicar, peça um novo pedindo ao agente: "gera novo link de conexão". {% endhint %} {% endtab %} {% endtabs %} *** ### 🔐 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, Slack) 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 Sheets, Google Docs, Slack, Asana, Notion, GitHub, entre outros. #### Chave de API Alguns apps usam chaves de API em vez de login. A Adapta mostra um campo simples pedindo a chave. **Usado em:** Apollo, algumas ferramentas de desenvolvimento e automação. Para pegar a chave: 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 é. **Usado em:** Mixpanel, Datadog, BigQuery, Snowflake, entre outros apps de análise de dados e infraestrutura. {% hint style="info" %} **"Secured by Composio"**: no rodapé da tela de conexão aparece essa frase. 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. 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" * "Poste no canal #lancamentos do Slack que o deploy foi concluído" * "Quantos emails não lidos eu tenho hoje?" O agente mostra o que está fazendo em um bloco estruturado no chat: 1. **Plano de ação**: o que ele entendeu do pedido e como vai resolver 2. **Integrações Encontradas**: qual ação específica está sendo usada (os nomes das ações aparecem em inglês, ex: "connect to Gmail account", "search emails", "send email". Isso é normal.) 3. **Tarefa concluída**: selo verde de confirmação quando a ação terminou
{% hint style="success" %} **Dica de ouro:** 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 na sua workspace com um contador no título (ex: "Conectadas 5"). 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, CRM, 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 * **Slack**: ler canais, enviar mensagens, listar usuários 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: 1. **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". 2. **Revise antes de confirmar**: peça para o agente listar o que será afetado. Confirme item por item se necessário. 3. **Use conta de teste**: se está explorando uma automação nova com alto potencial destrutivo, teste primeiro em uma conta secundária. #### Integrações em Plays (execução autônoma) Um Play que usa integração executa sem você acompanhar em tempo real. A instrução roda sozinha no horário marcado. Isso amplifica o risco de ações destrutivas: o agente pode apagar, enviar ou modificar coisas enquanto você nem está olhando. Para Plays com integração, siga essas regras: * Comece com ações **de leitura apenas** (buscar, listar, resumir) antes de evoluir para ações de escrita * Deixe o Play rodar manualmente algumas vezes (pelo botão "executar agora") antes de ativar a recorrência * Revise a instrução com cuidado para não deixar margem para interpretação perigosa * Evite em Plays expressões vagas como "limpa", "organiza apagando", "remove o que não for importante"
**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 4. Fale com o administrador da sua workspace se a conta for corporativa {% 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 Plays e Skills Integrações ganham outra dimensão quando combinadas com Plays e Skills. * **Play + Integração**: a tarefa recorrente passa a incluir execução real em apps. Briefing diário que chega por email. Relatório semanal postado no canal do time. Evento de alinhamento criado no calendário toda segunda. * **Skill + Integração**: uma habilidade customizada pode usar integrações. A Skill de envio 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. Para combinar, basta que a integração esteja conectada e a instrução do Play ou Skill mencione o que deve acontecer. O agente reconhece e aplica. Exemplos de instrução combinada: * "Todo dia às 8h, pesquise as principais notícias de IA da última semana e envie um email para \[endereço] pelo Gmail com o resumo em formato de tabela." * "Toda sexta às 16h, consolide os resultados da semana e poste o resumo no canal #comercial do Slack." * "Todo dia 1, gere o relatório mensal de operações e salve no Google Drive na pasta \[caminho] com o nome 'Relatório \[mês-ano]'." *** ### 💼 3 Integrações na prática Três exemplos reais para calibrar como cada tipo de integração se comporta no dia a dia. {% tabs %} {% tab title="Gmail" %} #### Executivo que nunca mais perdeu email importante **Situação:** Carla é Diretora Comercial e recebe mais de 200 emails por dia. Perdia emails críticos no meio do volume e gastava 45min por manhã triando a caixa. **O que ela fez:** 1. Conectou o Gmail pela aba Integrações 2. Perguntou no chat: "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." **Como a IA executou:** buscou os emails, avaliou urgência por remetente, assunto e conteúdo, devolveu os 5 em ordem de prioridade com rascunho de resposta para cada um. **Resultado:** 45min → 10min por manhã. Carla só revisa, ajusta e envia. Os rascunhos ficam salvos no Gmail para finalização depois. {% endtab %} {% tab title="Google Drive" %} #### Consultoria que achou 3 anos de material sem abrir uma pasta **Situação:** Pedro é consultor e acumulou 3 anos de documentos no Drive. Todo projeto novo começava com ele gastando 30min procurando o template certo e cases anteriores relevantes. **O que ele fez:** 1. Conectou o Google Drive pelo chat ("se conecta ao meu Drive") 2. Passou a perguntar: "Busca no Drive todos os documentos sobre \[cliente/indústria] dos últimos 3 meses, me devolve em ordem de relevância com resumo de 1 linha de cada." **Como a IA executou:** listou arquivos relacionados, abriu cada um para ler o conteúdo, ranqueou e devolveu com resumos e links diretos. **Resultado:** 30min → 2min. Pedro ganhou de volta o conhecimento que já tinha acumulado. {% endtab %} {% tab title="Slack" %} #### Gerente que parou de ser o mensageiro do time **Situação:** Fernanda é Gerente de Produto e o time inteiro dependia dela para atualizar o canal sobre status de entregas, incidentes e avisos. Gastava 1h por dia transformando updates em mensagens formatadas. **O que ela fez:** 1. Conectou o Slack pela aba Integrações 2. Criou um Play diário às 17h com a instrução: "Consolide as atualizações do dia dos projetos ativos baseado nos chats que rolaram hoje comigo, formate em bullets curtos com emojis por status, e poste no canal #time-produto do Slack." **Como a IA executou:** todo dia às 17h, o resumo aparece no canal sem ela mexer em nada. **Resultado:** 1h → 0min. O time passou a ter visibilidade constante. Ela virou revisora, não mensageira. {% endtab %} {% endtabs %} *** ### ✅ Como saber se funciona {% tabs %} {% tab title="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) {% endtab %} {% tab title="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 {% endtab %} {% endtabs %} *** ### 🚨 Troubleshooting | O que você vê | O que significa | Como corrigir | | ------------------------------------------------------------------------ | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | "O link de conexão expirou" | O link do chat tem validade de 10 minutos | Peça ao agente para gerar um novo: "gera novo link de conexão" | | O agente diz que não está conectado, mas eu conectei | Pode ter havido erro na autorização ou token expirou | Abra a aba **Conectadas**, desconecte o app clicando no plug verde, e conecte de novo | | A tela de conexão pede API Key e eu não sei onde pegar | Cada app tem sua tela de configuração | Entre no app externo, vá em configurações, procure por "API", "Developer" ou "Integrações". Se não encontrar, a própria tela da Adapta mostra uma dica abaixo do campo | | A autorização do Google/Microsoft voltou sem conectar | Pode ser bloqueio de popup ou cancelamento acidental | Tente de novo em outra aba. Se persistir, limpe cache do navegador | | O agente executou mas a ação não aparece no app | Possível problema de sincronização ou permissão | Verifique permissões concedidas na tela do provedor. Desconecte e conecte de novo se necessário | | Os nomes das ações no bloco "Integrações Encontradas" aparecem em inglês | Isso é normal | Os nomes técnicos vêm do parceiro de infraestrutura (Composio) e aparecem em inglês. Não afeta o resultado | | Quero saber exatamente o que a Adapta pode fazer no meu app | A tela de permissões do provedor mostra isso | Revise em myaccount.google.com/permissions (Google) ou no centro de apps conectados do provedor equivalente | *** ### 🎯 Próximos passos {% tabs %} {% tab title="Começando agora" %} **1. Conecte sua primeira integração** Escolha a que você usa mais. 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** Antes de pedir algo com impacto, teste com leitura: "quantos emails não lidos eu tenho hoje?", "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 usar integrações em Plays ou 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á tem integrações ativas" %} **1. Audite sua lista de Conectadas** Abra a aba **Conectadas** e pergunte: ainda uso esta integração? Desconecte o que não serve mais. Menos superfície exposta, menos risco. **2. Combine com Plays** Transforme tarefas recorrentes que usam integração em Plays. Ganho de tempo multiplicado, com a previsibilidade do horário automático. **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: 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/adapta-pass/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.