> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apollospace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Composio — integrações sem código

> Conecte Notion, Slack, Linear, Gmail, Calendar e mais via OAuth — sem precisar instalar SDK ou configurar webhook.

A Athena, sua agente Chief of Staff, está fechando a semana: ela atualiza
uma página no Notion, deixa um resumo no Slack e move dois tickets no
Linear — tudo nas ferramentas em que seu time já vive. Pra ela alcançar
cada uma delas, normalmente alguém teria que cadastrar um app OAuth, lidar
com token refresh e manter as credenciais seguras — uma integração por vez.
O Composio é como o Apollo Space pula esse trabalho, pra que seus agentes
ajam dentro dos apps que você já usa sem você nunca tocar num SDK ou num
webhook.

## O que é

[Composio](https://composio.dev) é uma camada de **OAuth-as-a-service**
para apps SaaS. Em vez de cada app exigir que você implemente a
integração do zero (cadastrar app, lidar com token refresh, manter
credenciais seguras), o Composio expõe um catálogo amplo de apps
atrás de uma única conexão.

O Apollo Space usa o Composio pra conectar seus agentes às ferramentas
em que sua empresa já roda:

* **Athena** lê + escreve no seu Notion, Slack, Linear, HubSpot, etc.
* **Marcus** pode enviar e-mail via Gmail (em vez de Resend) quando
  você quer manter a thread no seu inbox real
* **Scout** pode buscar em ferramentas internas (Confluence, Notion)
  além da web pública

## Toolkits disponíveis

A lista completa fica em [composio.dev/apps](https://composio.dev/apps).
Os mais usados no contexto do Apollo Space:

<CardGroup cols={2}>
  <Card title="Produtividade" icon="briefcase">
    Notion, Confluence, Google Docs, Google Calendar, Asana, Trello,
    Linear, Jira, ClickUp, Monday, Airtable
  </Card>

  <Card title="Comunicação" icon="comments">
    Slack, Gmail, Outlook, Discord, Telegram, Microsoft Teams
  </Card>

  <Card title="Sales & CRM" icon="users">
    HubSpot, Salesforce, Pipedrive, Zoho CRM, Calendly
  </Card>

  <Card title="Dev & Ops" icon="code">
    GitHub, GitLab, Bitbucket, Vercel, Supabase, Sentry
  </Card>

  <Card title="Social & Marketing" icon="bullhorn">
    LinkedIn, X (Twitter), Reddit, YouTube, Mailchimp, Canva
  </Card>

  <Card title="Comércio" icon="cart-shopping">
    Stripe, QuickBooks, Shopify (em breve)
  </Card>
</CardGroup>

## Como autenticar

A autenticação é via **OAuth do app**, intermediada pelo Composio:

<Steps>
  <Step title="Você escolhe o toolkit no Apollo Space">
    Em **Settings → Integrações**, selecione o app que quer conectar
    (Notion, Slack, etc.).
  </Step>

  <Step title="Apollo Space te redireciona pro OAuth do app">
    Você loga no app (Notion, Slack, Gmail...) e autoriza o Apollo Space a
    ler/escrever conforme os scopes pedidos.
  </Step>

  <Step title="Composio guarda o token criptografado">
    O token de acesso fica armazenado de forma encriptada no Composio.
    O Apollo Space nunca vê o token cru — só pede pro Composio executar
    ações em seu nome.
  </Step>

  <Step title="Agentes ganham o toolkit">
    A partir desse momento, os agentes da org (Athena, Marcus, Scout,
    Twins) podem usar as ferramentas daquele app — conforme as
    permissões de cada agente.
  </Step>
</Steps>

## Escopo: org vs pessoal

Cada conexão Composio pode ser feita em dois escopos diferentes:

<CardGroup cols={2}>
  <Card title="Org-level" icon="building">
    A conexão pertence à organização como um todo. Qualquer agente da
    org pode usar. **Exemplo**: a conta de Slack da empresa que os
    agentes operacionais usam.
  </Card>

  <Card title="Personal" icon="user">
    A conexão pertence a um usuário específico — só os agentes
    operando "em nome dele" (incluindo o [Digital Twin](/pt/agents/digital-twins)
    desse user) podem usar. **Exemplo**: o Notion pessoal de um líder
    que só o Twin dele acessa.
  </Card>
</CardGroup>

O Apollo Space escolhe automaticamente o escopo certo conforme o agente que
está chamando — sem mistura acidental entre conta pessoal e conta
da org.

## Cost cap automático por toolkit

Composio cobra alguns toolkits por chamada (a maioria é gratuita — só
intermediação OAuth). Pra te proteger de explosões de custo:

* O Apollo Space monitora o custo **por (org, toolkit)** ao longo do tempo
* Se a média de custo por chamada exceder um limite seguro, o Apollo Space
  **pausa automaticamente** aquela combinação org+toolkit
* Você é notificado e pode revisar antes de reativar

O objetivo: nunca chegar a uma fatura inesperada porque um agente
ficou em loop com uma ferramenta cara.

## O que cai no seu wallet de Stars

| Onde cai                                                            | Como                                  |
| ------------------------------------------------------------------- | ------------------------------------- |
| **Execução do toolkit**                                             | Stars (intermediação do Apollo Space) |
| **Custo Composio** (alguns toolkits têm custo direto)               | Sua conta Composio (BYO key)          |
| **Fatura do app subjacente** (ex: SMS via Twilio, busca via Tavily) | Sua conta do vendor direto            |

## Limitações conhecidas

* **Quota OAuth do app** — se o app limita 1000 chamadas/dia, o Apollo Space
  também é limitado por isso. Não temos como driblar.
* **Schema changes do app** — quando um app SaaS muda a API, o
  Composio precisa atualizar. Apollo Space herda o lag (raro, mas
  acontece).
* **Sem app não-OAuth** — Composio só cobre apps com OAuth público.
  Apps custom internos da sua empresa precisam de tool customizado.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Athena — quem mais usa Composio" icon="user-tie" href="/pt/agents/athena">
    A Chief of Staff opera o dia-a-dia via as integrações Composio.
  </Card>

  <Card title="Stars" icon="star" href="/pt/billing/stars">
    Como o uso do Composio entra no faturamento.
  </Card>

  <Card title="Trust" icon="shield-check" href="/pt/trust/security">
    Como o Apollo Space protege as credenciais que o Composio guarda.
  </Card>
</CardGroup>