Integrazioni

Le integrazioni collegano il bot a servizi esterni. Ogni integrazione è una configurazione salvata (con i segreti cifrati) che viene poi utilizzata dalle azioni delle reazioni. La sezione si trova nel menu a sinistra: Integrazioni; usa il pulsante Aggiungi integrazione, l'interruttore di connessione e il pulsante Configura su ogni scheda.

Servizi disponibili

  • AI — modello linguistico (API compatibile OpenAI). Vedi Risposte AI.
  • Google Sheets — aggiunta di righe a un foglio di calcolo.
  • Google Drive — caricamento di file in una cartella.
  • GetCourse — invio di utenti e trattative a GetCourse.
  • Webhook — invio universale di dati via HTTP a qualsiasi servizio.
  • Gestore esterno — connessione del tuo backend tramite WebSocket: la reazione viene gestita dal tuo server. Vedi Gestore esterno.

Configurazione

Quando aggiungi un'integrazione, scegli il Servizio, inserisci un Nome e compila i campi di configurazione specifici per tipo:

Webhook

  • URL del webhook — indirizzo del ricevitore.
  • Firma HMAC (segreto) — per la verifica dell'autenticità; la richiesta viene firmata con l'header X-Signature: sha256=....

GetCourse

  • Account e Chiave segreta.
  • Oggetto — «Utenti» o «Trattative».

Google Sheets

  • ID del foglio e Intervallo.
  • JSON dell'account di servizio (segreto) — chiave del service account Google.

Google Drive

  • ID della cartella.
  • JSON dell'account di servizio (segreto).

AI

  • Base URL, Modello, Prompt di sistema, Chiave API (segreto). Per maggiori dettagli — Risposte AI.

Gestore esterno

Integrazione WebSocket: il tuo server si connette a GetMyBot e gestisce le reazioni rispondendo con comandi nel formato Telegram Bot API.

  • Indirizzo WebSocket — al quale si connette il tuo servizio.
  • Token di connessione (segreto) — mostrato una sola volta alla creazione; è disponibile il pulsante di rinnovo.

Dettagli, protocollo ed esempi del servizio — Gestore esterno.

Utilizzo nelle reazioni

  • AI e Webhook sono disponibili immediatamente come azioni/canali: aggiungi l'azione AI oppure invia dati con l'azione Richiesta web all'indirizzo del webhook.
  • Le azioni GetCourse, Google Sheets, Google Drive nel costruttore di reazioni sono contrassegnate come «prossimamente» — le integrazioni stesse possono già essere configurate ora.

Sicurezza

Tutte le richieste in uscita passano attraverso la protezione SSRF (accesso alla rete interna vietato) e la risposta è limitata in dimensione. I segreti delle integrazioni sono conservati in forma cifrata.

Prossimi passi