Integrações

Integrações conectam o bot a serviços externos. Cada integração é uma configuração salva (com segredos criptografados) que depois é usada pelas ações das reações. A seção fica em Integrações no menu lateral; use o botão Adicionar integração, o toggle de conexão e o botão Configurar em cada cartão.

Serviços disponíveis

  • IA — modelo de linguagem (API compatível com OpenAI). Veja Respostas com IA.
  • Google Sheets — adiciona linhas a uma planilha.
  • Google Drive — faz upload de arquivos para uma pasta.
  • GetCourse — envia usuários e negócios para o GetCourse.
  • Webhook — envio universal de dados via HTTP para qualquer serviço.
  • Processador externo — conecta seu próprio backend via WebSocket: a reação é processada pelo seu servidor. Veja Processador externo.

Configuração

Ao adicionar, você escolhe o Serviço, define um Nome e preenche os campos de configuração, que variam conforme o tipo:

Webhook

  • URL do webhook — endereço do receptor.
  • Assinatura HMAC (segredo) — para verificação de autenticidade; a requisição é assinada com o cabeçalho X-Signature: sha256=....

GetCourse

  • Conta e Chave secreta.
  • Objeto — "Usuários" ou "Negócios".

Google Sheets

  • ID da planilha e Intervalo.
  • JSON da conta de serviço (segredo) — chave do Google service account.

Google Drive

  • ID da pasta.
  • JSON da conta de serviço (segredo).

IA

  • Base URL, Modelo, System prompt, Chave de API (segredo). Saiba mais em Respostas com IA.

Processador externo

Integração via WebSocket: seu servidor se conecta ao GetMyBot e processa as reações respondendo com comandos no formato Telegram Bot API.

  • Endereço WebSocket — pelo qual seu serviço se conecta.
  • Token de conexão (segredo) — exibido uma única vez na criação; há um botão para reemissão.

Detalhes, protocolo e exemplos de serviço em Processador externo.

Uso nas reações

  • IA e Webhook estão disponíveis como ações/canais imediatamente: adicione a ação IA ou envie dados com a ação Requisição web para o endereço do webhook.
  • As ações GetCourse, Google Planilhas e Google Drive no construtor de reações estão marcadas como "em breve" — mas as integrações em si já podem ser configuradas agora.

Segurança

Todas as requisições de saída passam pela proteção contra SSRF (acesso à rede interna é bloqueado), e o tamanho da resposta é limitado. Os segredos das integrações são armazenados de forma criptografada.

Próximos passos