Integrações

Integração é a ponte entre o Adapta One e os apps que você já usa no dia a dia.

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.

⏱️ 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

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.

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.

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.

📋 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.

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.

🔐 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.

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.

"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.

💬 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:

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, ex: "connect to Gmail account", "search emails", "send email". Isso é normal.)
Tarefa concluída: selo verde de confirmação quando a ação terminou

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.

🎛️ 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.

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.

🔒 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:

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. 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.

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:

Desconecte a integração imediatamente pela aba Conectadas
Revogue o acesso da Adapta no próprio app (ex: myaccount.google.com/permissions)
Altere a senha do app
Fale com o administrador da sua workspace se a conta for corporativa

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.

🔗 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.

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:

Conectou o Gmail pela aba Integrações
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.

✅ Como saber se funciona

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)

🚨 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

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.

AnteriorPlays PróximoONE

Atualizado há 1 mês

Isto foi útil?

Integrações