Skip to main content
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: Para qualquer item que não esteja nesta lista, crie uma conexão de API personalizada ou adicione um servidor MCP.

Conectar uma conta

1

Abra Conexões → Apps e clique em Adicionar aplicativo

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.
2

Autorize a conta

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.
3

Somente Google Sheets: escolha a planilha

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: 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 Calendarcalendar_list_events, calendar_check_availability, calendar_create_event, calendar_update_event, calendar_cancel_event
  • Google Sheetssheets_append_row (grava na planilha e na aba que você configurou)
  • Slackslack_list_channels, slack_search_messages, slack_post_message
  • HubSpothubspot_search_contacts, hubspot_get_contact, hubspot_upsert_contact, hubspot_add_note
  • Salesforcesalesforce_search_records, salesforce_get_record, salesforce_upsert_lead, salesforce_log_activity
  • Cal.comcalcom_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) 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

Transforme qualquer API em uma ação do agente

O assistente de colar cURL para serviços sem uma conexão nativa.

Adicione um servidor MCP

Use seu próprio servidor de ferramentas via HTTP Streamable.