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

# Conexões

> Conecte serviços externos e APIs aos seus agentes.

As conexões permitem que seus agentes interajam com serviços externos como WhatsApp, GitHub, Google Workspace, Notion e muito mais.

## O que são Conexões?

Uma conexão é um conjunto de credenciais (tokens OAuth ou chaves de API) que permitem aos agentes utilizar serviços externos. Uma vez configurados, os agentes podem enviar mensagens, ler dados, criar documentos e muito mais.

## Serviços Suportados

<CardGroup cols={3}>
  <Card title="WhatsApp" icon="whatsapp" iconType="brand">
    Envie e receba mensagens via Evolution API
  </Card>

  <Card title="GitHub" icon="github" iconType="brand">
    Gerencie repositórios, issues, PRs e código
  </Card>

  <Card title="Google" icon="google" iconType="brand">
    Gmail, Calendar, Drive, Docs, Sheets
  </Card>

  <Card title="Notion" icon="n" iconType="brand">
    Leia e escreva páginas e bancos de dados
  </Card>

  <Card title="Slack" icon="slack" iconType="brand">
    Envie mensagens e gerencie canais
  </Card>

  <Card title="HubSpot" icon="hubspot" iconType="brand">
    Contatos, negócios e tickets do CRM
  </Card>
</CardGroup>

## Adicionando uma Conexão

<Steps>
  <Step title="Acesse as Configurações">
    Navegue até **Configurações** e selecione **Conexões**.
  </Step>

  <Step title="Escolha um serviço">
    Clique em **Adicionar Conexão** e selecione o serviço que deseja conectar.
  </Step>

  <Step title="Autentique">
    Para **serviços OAuth** (Google, GitHub, Slack): Clique em "Conectar" e autorize na janela pop-up.

    Para **serviços com chave de API** (WhatsApp, HubSpot): Insira sua chave de API e a URL do endpoint.
  </Step>

  <Step title="Teste a conexão">
    Clique em **Testar** para verificar se a conexão está funcionando corretamente.
  </Step>
</Steps>

## Usando Conexões no Chat

Uma vez configurados, os agentes têm acesso automático aos serviços conectados. Basta perguntar de forma natural:

* "Manda uma mensagem no WhatsApp pro João dizendo que a reunião é às 15h"
* "Cria uma issue no GitHub sobre o bug de login"
* "Adiciona isso no meu Google Calendar para a próxima terça"

O agente identifica qual conexão usar com base na sua solicitação.

## Gerenciando Conexões

* **Editar** credenciais ou configurações de conexões existentes
* **Desativar** uma conexão temporariamente sem removê-la
* **Excluir** para remover permanentemente uma conexão e suas credenciais

<Warning>
  As credenciais são criptografadas em repouso. Nunca compartilhe suas configurações de conexão publicamente.
</Warning>