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

# Integração

> Conecte Alter com seus aplicativos Mac e serviços externos

<Info>
  **Alter não apenas bate papo – ele realmente faz coisas.** Conecte-se com 17+ aplicativos locais do Mac e serviços externos de 2000+.
</Info>

## Local Tools

Alter fornece **17+ poderosas Tools locais** que se integram diretamente com seus aplicativos Mac. Ao contrário de outros assistentes de IA, Alter realmente controla seu Mac através da linguagem natural.

<CardGroup cols={2}>
  <Card title="100% Livre" icon="gift">
    Todas as Tools locais estão disponíveis para todos sem custo
  </Card>

  <Card title="Funciona Desligado" icon="wifi-off">
    Não é necessário internet – completamente privado
  </Card>

  <Card title="Controle Nativo" icon="command">
    Na verdade, controla seus aplicativos, não apenas lê sobre eles
  </Card>

  <Card title="Privacy First" icon="shield">
    Seus dados nunca deixam seu Mac
  </Card>
</CardGroup>

### Como utilizar Local Tools

<Steps>
  <Step title="Abrir o Tools Manager">
    Clique nos três pontos em Alter → **Tools Manager**
  </Step>

  <Step title="Habilitar Tools">
    Na seção **Local Tools**, procure e habilite Tools (Calendar, Mapas, etc.)
  </Step>

  <Step title="Usar linguagem natural">
    Pergunte ao Alter para executar ações:

    * Manda uma mensagem ao John a dizer que estou atrasado.
    * "Adicione uma reunião ao meu calendário para amanhã às 14h"
    * "Mostra-me os meus e-mails não lidos"
  </Step>
</Steps>

<Note>
  Activa ou desactiva todas as Tools com o interruptor global no Tools Manager (Configurações > Tools)
</Note>

### Demonstração de Vídeo

<Frame>
  <div className="embed-container">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/qL9iiHihYOU" title="Leitor de vídeo do YouTube" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
  </div>
</Frame>

### Apps disponíveis para Mac

<AccordionGroup>
  <Accordion icon="briefcase" title="Produtividade & Organização">
    * **Notas:** Acesse e gerencie suas notas
    * **Lembranças:** Gerencie seus lembretes
    * **Calendar:** Criar, editar, remover e listar eventos
    * **Finder:** Listar e abrir aplicativos
  </Accordion>

  <Accordion icon="settings" title="& Automação do Sistema">
    * **Alter:** Usar ações rápidas como Tools, copiar para a área de transferência
    * \*\* Configurações do sistema:\*\* Enviar notificações do sistema
    * **Atalhos:** Chamar atalhos Apple com resposta IA como entrada
    * \*\* Editor de scripts:\*\* Execute scripts da Apple
  </Accordion>

  <Accordion icon="compass" title="& Navegação Web">
    * **Maps:** Procure lugares, obtenha direções, pontos de interesse
    * **Safari:** Google - Web search powered by buenaventura
  </Accordion>

  <Accordion icon="message-circle" title="Comunicação">
    * **Contactos:** Gerenciar e pesquisar contatos
    * **Mail:** Rascunho de e- mail
    * \*\* Mensagens: \*\* Enviar mensagens
  </Accordion>
</AccordionGroup>

***

## Serviços externos

Conecte-se com **2000+ aplicações externas** para automação avançada.

<Warning>
  **Acesso inicial:** As integrações externas estão em pré-visualização para assinantes anuais e vitalícios
</Warning>

### Integração Popular

<CardGroup cols={4}>
  <Card title="Noção" icon="book">
    Notas e bases de dados
  </Card>

  <Card title="Linear" icon="git-branch">
    Gestão de projectos
  </Card>

  <Card title="GitHub" icon="github">
    Repositórios de códigos
  </Card>

  <Card title="Slack" icon="hash">
    Mensagens de equipe
  </Card>

  <Card title="Calendário Google" icon="calendar">
    Agendamento
  </Card>

  <Card title="Gmail" icon="mail">
    Email
  </Card>

  <Card title="Salesforce" icon="bar-chart">
    CRM
  </Card>

  <Card title="HubSpot" icon="users">
    Comercialização
  </Card>
</CardGroup>

E 2000+ mais através de plataformas de integração!

### Vídeo: Integração Externa

<Frame>
  <div className="embed-container">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/ltYMIKf6nV8" title="Leitor de vídeo do YouTube" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
  </div>
</Frame>

***

## Fluxos de trabalho de automação

### Webhooks

Configurar integrações webhook para fluxos de trabalho personalizados:

<CardGroup cols={2}>
  <Card title="Fluxos de trabalho personalizados" icon="webhook">
    Conecte-se com qualquer serviço compatível com webhook
  </Card>

  <Card title="Acções externas" icon="zap">
    Serviços de gatilho de conversas Alter
  </Card>
</CardGroup>

### Atalhos da Apple

Conecte-se com milhares de atalhos da Apple:

<Steps>
  <Step title="Ativar a Tool de atalhos">
    No Tools Manager, ligue a Tool Atalhos
  </Step>

  <Step title="Criar um atalho">
    No aplicativo Atalhos, crie automação
  </Step>

  <Step title="Configurar entrada">
    Faça-o aceitar a última mensagem da IA como entrada
  </Step>

  <Step title="Ativador de Alter">
    "Executa o meu atalho"
  </Step>
</Steps>

### Acções Rápidas

Crie ações personalizadas para suas integrações:

<CardGroup cols={2}>
  <Card title="Inserir ação" icon="corner-down-left">
    Colocar automaticamente as respostas de IA em aplicações activas
  </Card>

  <Card title="Ações do Webhook" icon="send">
    Enviar dados para serviços externos
  </Card>

  <Card title="Programa Apple" icon="terminal">
    Executar scripts personalizados
  </Card>

  <Card title="Construtor de Formulários" icon="layout">
    Criar formulários interativos
  </Card>
</CardGroup>

<Frame>
  <div className="embed-container">
    <iframe width="560" height="315" src="https://www.youtube.com/embed/m2i7PC7n9JE" title="Leitor de vídeo do YouTube" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
  </div>
</Frame>

***

## Integração x-callback-url

Alter suporta o \[x-callback-url]\(protocolo [https://x-callback-url.com/](https://x-callback-url.com/)) para comunicação interaplicativo.

### O que é x-callback-url?

Um padrão que permite que os aplicativos acionem ações uns nos outros usando URLs especiais. Passe dados, execute ações e retorne sem problemas.

### Ativando Alter de Outros Apps

<Steps>
  <Step title="Obter o URL">
    Em Editor de Ação, selecione uma ação → "URL Callback" seção
  </Step>

  <Step title="Copiar esquema">
    Copiar o URL do `alter://` para essa ação
  </Step>

  <Step title="Usar em qualquer lugar">
    Colar em Atalhos, Notas, navegador, etc.
  </Step>
</Steps>

\*\* Exemplo:\*\*

```
alter://action/ask-web?input=What+is+Alter+MacOS
```

### Ativando outros aplicativos do Alter

Criar links clicáveis usando os esquemas de URL do aplicativo alvo:

## Aplicativo , URL de exemplo , Ação

Ursinho, `bear://x-callback-url/create?title=Demo`, Criar nota

* Coisas \* `things://add?title=Task` \* Adicionar tarefa \*
  □ Rascunhos > Criar rascunho

<Card title="Aplicações Suportadas" icon="check-circle">
  Urso, coisas, rascunhos, OmniFocus, 1 Escritor, Agenda e centenas mais
</Card>

<Info>
  Ver o Guia [URL Callbacks](/workflows/url-callbacks) para documentação completa
</Info>

***

## Configuração

### Acesso ao Tools Manager

<Steps>
  <Step title="Abrir o Alter">
    Use seu atalho global ou mouse
  </Step>

  <Step title="Abrir o menu">
    Clique em três pontos à direita
  </Step>

  <Step title="Selecionar Tools Manager">
    Ativar/desactivar integrações conforme necessário
  </Step>
</Steps>

### Privacidade e Segurança

<CardGroup cols={3}>
  <Card title="Local Tools" icon="shield-check">
    Os dados permanecem no Mac – completamente offline
  </Card>

  <Card title="External Tools" icon="lock">
    Ativar apenas o que necessita
  </Card>

  <Card title="Sem Fundo" icon="eye-off">
    Alter só acessa dados quando solicitado
  </Card>
</CardGroup>

***

## Solução de problemas

### Questões comuns

<AccordionGroup>
  <Accordion icon="x-circle" title="Tool Não Funciona">
    Verifique quais parâmetros são necessários. Crie prompts personalizados ou adicione explicadores ao seu perfil para melhor uso da Tool.
  </Accordion>

  <Accordion icon="cpu" title="Assistente que não utiliza o Tools">
    Certifique-se de que seu modelo suporta Tools. Recomendado:

    * Alter Best
    * Gemini 2.0 Flash
    * Sonnet Claude
  </Accordion>

  <Accordion icon="shortcut" title="Problemas com os Atalhos da Apple">
    Garantir que os atalhos aceitem a última mensagem assistente como parâmetro de entrada
  </Accordion>
</AccordionGroup>

### Obter Ajuda

<CardGroup cols={2}>
  <Card title="Pergunte ao Alter" icon="help-circle">
    "Como uso a Tool Calendário?"
  </Card>

  <Card title="Comunidade" icon="users">
    Junte-se à Discord para suporte de equipe e comunidade
  </Card>
</CardGroup>

<Tip>
  \*\* Dica Pro:\*\* Comece com Tools locais para se familiarizar antes de configurar serviços externos
</Tip>

***

## Recursos Relacionados

<CardGroup cols={2}>
  <Card title="Gestor Tool" icon="tool" href="/how-to/tool-manager-guide">
    Configuração detalhada da Tool
  </Card>

  <Card title="URL Callbacks" icon="link" href="/workflows/url-callbacks">
    Mergulho profundo em x-callback-url
  </Card>

  <Card title="Solução de problemas" icon="wrench" href="/common-issues/tool-not-working">
    Corrigir problemas de Tools
  </Card>

  <Card title="Acções" icon="zap" href="/getting-started/core-features#alter-actions-workflows">
    Criar fluxos de trabalho personalizados
  </Card>
</CardGroup>