Conectores

Como as integrações de terceiros funcionam e o que está conectado atualmente.

O que é um conector

Um conector é um wrapper tipado em torno de uma API de terceiros. Em vez de o agente fazer chamadas HTTP brutas com seus tokens, cada integração passa por uma pequena interface auditada que:

Mantém suas credenciais em um armazenamento de segredos separado e com escopo definido.
Valida entradas e saídas em relação aos esquemas.
Exibe um cartão de aprovação na primeira vez que uma nova superfície (chat, Console, site público) tenta usá-lo.
Registra cada chamada.

Isso significa que uma página do Console chamando o Slack é algo diferente e aprovado separadamente do agente de chat chamando o Slack, mesmo que o token subjacente possa ser compartilhado.

O que está disponível hoje

Agrupado pelo que as pessoas geralmente criam com cada um.

SEO e conteúdo (Ahrefs)

Site Explorer, Keywords Explorer, Content Explorer, Rank Tracker, Site Audit, Brand Radar, integração com GSC, Web Analytics, Competitive Analysis, SEO local, Reports Builder, Alerts, Batch Analysis, AI Content Helper, gerenciamento de redes sociais, Dashboard. O pacote completo da Ahrefs está conectado.

Solicitações típicas: - "Extraia as 50 principais palavras-chave orgânicas de competitor.com e agrupe-as por tópico principal." - "Configure uma verificação diária do Brand Radar para nossos 10 prompts prioritários e me envie uma mensagem no Slack sobre as mudanças."

Comunicação e operações

Slack. Mensagens, DMs, leituras de canais, reações, uploads de arquivos. Dois tokens (bot, usuário) para que o agente possa postar como bot ou como você, dependendo do caso de uso.
Notion. Páginas, bancos de dados, pesquisa, tópicos de comentários.
Linear. Problemas, projetos, comentários, gatilhos em mudanças de estado.
GitHub. Repositórios, PRs, problemas, lançamentos, gatilhos de webhook.

CRM e receita

HubSpot. Contatos, empresas, negócios, tickets, listas, fluxos de trabalho, propriedades.
Stripe. Clientes, assinaturas, faturas, cobranças, eventos.
Gong. Chamadas, transcrições, trechos, scorecards.
Fathom. Gravações de reuniões, resumos, itens de ação.

Marketing e e-mail

Mailchimp. Campanhas, listas, segmentos, automações, relatórios.
Resend. Envios transacionais, modelos, públicos.
Airtable. Bases, tabelas, registros, esquemas.

Web e dados

WordPress. Posts, páginas, mídia, taxonomias (leitura e gravação).
Apify. Execute qualquer um dos scrapers deles como um bloco de construção.
Firehose. Fluxo de eventos interno.

Como adicionar um novo conector à sua área de trabalho

Se você solicitar algo que não está na lista, o caminho é:

O agente verifica se existe um conector que se encaixa.
Caso contrário, solicite o novo conector entrando em contato com nossa equipe de suporte. Todos os novos conectores são revisados e aprovados antes de serem adicionados ao Letaido, então as novas integrações chegam por um caminho verificado em vez de wrappers HTTP brutos.
Enquanto você aguarda, o agente geralmente pode recorrer a uma chave de API genérica mais uma lista de permissões de domínio de saída para trabalho somente leitura, mas um conector adequado é sempre preferível (ele fornece entradas tipadas, registro, credenciais com escopo definido e aprovação por superfície prontos para uso).

Você também pode perguntar "X está disponível como conector?" e ele verificará antes de definir o escopo do trabalho.

Aprovações: uma observação para proprietários e administradores

Você verá cartões de aprovação para:

Adicionar uma nova credencial (uma área de trabalho do Slack, um portal do HubSpot, uma conta da Ahrefs).
Conceder essa credencial a uma nova superfície (agente de chat, página do Console, site público).
Permitir HTTPS de saída para um novo domínio.
Instalar um novo pacote Python.
Agendar um trabalho recorrente.

O padrão é sempre: a ferramenta exibe um cartão, você clica uma vez, o agente de IA tenta novamente. Os cartões não expiram automaticamente, então você pode levar um dia para revisar sem que o agente de IA pare.

Nos bastidores. Os conectores têm versão e listas de escopo explícitas. Quando o agente solicita um token do Slack, ele solicita todos os escopos que possa precisar em todos os usos planejados no momento, para que você não receba cartões de aprovação aos poucos. O token fica em um armazenamento de segredos tipado que o agente pode nomear, mas não ler diretamente.