> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Conecte aplicativos (Google, Slack, HubSpot e mais)
> Dê aos seus agentes recursos reais — consultar calendários, atualizar seu CRM, publicar no Slack — em poucos cliques, sem código.
As conexões de aplicativos permitem que um agente de voz atue nas ferramentas que sua equipe já usa durante a conversa: verificar disponibilidade em um calendário, buscar quem liga no seu CRM, adicionar um lead a uma planilha, publicar um resumo no Slack. Você conecta uma conta uma vez em **Conexões → Apps**
(`/dashboard/app-connections`), escolhe o que o agente pode fazer e anexa a conexão a qualquer agente no seu builder.
Seis aplicativos estão disponíveis hoje:
| Aplicativo | O que seu agente pode fazer com ele |
| ------------------- | -------------------------------------------------------------------- |
| **Google Calendar** | Ver disponibilidade e gerenciar eventos do calendário. |
| **Google Sheets** | Adicionar detalhes de leads e resultados de chamadas a uma planilha. |
| **Slack** | Encontrar canais, pesquisar mensagens e publicar com permissão. |
| **HubSpot** | Encontrar contatos, atualizar registros e adicionar notas. |
| **Salesforce** | Pesquisar registros, atualizar leads e registrar atividades. |
| **Cal.com** | Verificar disponibilidade e gerenciar agendamentos. |
Para qualquer item que não esteja nesta lista, crie uma
[conexão de API](/pt/guides/api-connections) personalizada ou adicione um
[servidor MCP](/pt/guides/mcp-servers).
## Conectar uma conta
Um seletor exibe os seis aplicativos. Você pode conectar várias contas
do mesmo aplicativo — cada uma mostra uma contagem de "conectados" depois que você conecta uma.
A maioria dos aplicativos usa OAuth: uma janela pop-up é aberta, você faz login no provedor e
aprova o acesso, e a conexão aparece na página. **Cal.com é
a exceção** — ele se conecta usando uma chave de API. Cole a chave
e clique em **Validar e conectar**; a chave é verificada no Cal.com
antes de ser criptografada e salva.
Uma conexão do Sheets precisa saber em qual planilha e aba gravar.
Logo após conectar, um painel de configuração é aberto — cole a
URL da planilha (ou o ID dela), clique em **Inspecionar planilha** e
escolha a aba. O painel confirma as colunas encontradas. Até que isso seja
feito, o bloco da conexão mostra **Requer configuração**.
A verificação do OAuth do Google do ThunderPhone está atualmente em análise, portanto
o Google mostra um aviso de "aplicativo não verificado" durante o consentimento para o Google
Calendar e o Google Sheets. A caixa de diálogo **Adicionar aplicativo**
orienta você pelos dois cliques para continuar (**Avançado → Ir para o ThunderPhone**).
Conectar e gerenciar conexões de aplicativos exige a função de **administrador** ou **proprietário**
na organização.
## Controlar o que o agente pode fazer
Cada conexão tem controles de permissão por operação — abra um bloco de conexão
para gerenciá-los. As operações de leitura começam ativadas; operações que
gravam ou alteram seus dados começam **desativadas** até que você as ative:
| Aplicativo | Ativado por padrão | Desativado por padrão |
| --------------- | ---------------------------------------------------------------------- | --------------------------------------------------- |
| Google Calendar | Ver eventos e disponibilidade, Criar eventos | Atualizar eventos, Cancelar eventos |
| Google Sheets | Adicionar linhas | — |
| Slack | Ver canais e mensagens recentes, Pesquisar mensagens | Publicar mensagens |
| HubSpot | Pesquisar e ler contatos e empresas | Criar ou atualizar contatos e adicionar notas |
| Salesforce | Pesquisar e ler leads, contatos e oportunidades | Criar ou atualizar registros e registrar atividades |
| Cal.com | Listar tipos de evento e verificar disponibilidade, Criar agendamentos | Reagendar ou cancelar agendamentos |
Uma operação que você desativa simplesmente não fica disponível para o agente — as
ferramentas correspondentes nunca são oferecidas a ele nas chamadas.
## As ferramentas que seu agente recebe
Quando uma conexão é vinculada a um agente, as operações habilitadas ficam disponíveis
como ferramentas acionáveis durante as conversas:
* **Google Calendar** — `calendar_list_events`, `calendar_check_availability`,
`calendar_create_event`, `calendar_update_event`, `calendar_cancel_event`
* **Google Sheets** — `sheets_append_row` (grava na planilha e na aba
que você configurou)
* **Slack** — `slack_list_channels`, `slack_search_messages`,
`slack_post_message`
* **HubSpot** — `hubspot_search_contacts`, `hubspot_get_contact`,
`hubspot_upsert_contact`, `hubspot_add_note`
* **Salesforce** — `salesforce_search_records`, `salesforce_get_record`,
`salesforce_upsert_lead`, `salesforce_log_activity`
* **Cal.com** — `calcom_list_event_types`, `calcom_check_availability`,
`calcom_create_booking`, `calcom_cancel_booking`
Você não precisa escrever esquemas para nenhuma delas — o ThunderPhone define as ferramentas
e direciona as chamadas pela conta conectada.
## Vincule a conexão a um agente
As conexões não fazem nada até que um agente as utilize. Abra o agente no
construtor ([Criar um agente](/pt/guides/build-an-agent)) e adicione a conexão
na seção **Apps conectados**. O cartão de uma conexão na página Apps
mostra quantas operações estão habilitadas e quantos agentes a utilizam.
## Desconectar
Abra o cartão de uma conexão e desconecte-a por lá. Os agentes que a
utilizavam perderão essas ferramentas na próxima chamada.
## Próximas etapas
O assistente de colar cURL para serviços sem uma conexão nativa.
Use seu próprio servidor de ferramentas via HTTP Streamable.