Cosa posso fare con la Telegram CRM API?
+
Elencare e cercare chat Telegram, leggere la cronologia dei messaggi, gestire contatti e campi personalizzati, creare e aggiornare ticket con priorità e assegnatario, avviare broadcast verso segmenti taggati, aggiungere e rimuovere tag e aggiornare i valori dei campi personalizzati. Ogni endpoint è limitato al workspace e registrato nel log di audit.
Quali scope sono disponibili?
+
workspace.read · members.read · accounts.read · contacts.read · chats.read · chats.write · custom_fields.read · custom_fields.write. Scegli il minimo necessario alla tua integrazione: il privilegio minimo limita i danni se una chiave viene esposta. Gli stessi scope valgono per l'API, il server MCP e l'integrazione con Make.com.
Esempi concreti: cosa costruiscono i team reali?
+
Un team di trading sincronizza ogni ora tutte le chat Telegram in BigQuery, così gli analisti possono incrociarle con i dati on-chain. Un team di supporto SaaS usa un cron job che recupera i ticket non risolti del giorno prima e li invia in un riepilogo su Slack. Un team growth invia un broadcast Telegram da un webhook ogni volta che arriva un evento di upgrade da Stripe. Un team operations ha costruito una dashboard su Retool con il tempo di risposta per commerciale, il volume di ticket e la distribuzione per stage della pipeline, tutto basato sull'API di Entergram.
Come creo e gestisco le chiavi API?
+
Vai alla scheda Developers del tuo workspace Entergram. Fai clic su 'Create key', seleziona gli scope necessari, imposta facoltativamente un TTL più breve e una allowlist IP, e copia la chiave. La chiave in chiaro viene mostrata una sola volta, quindi conservala in modo sicuro. Le chiavi sono salvate con hash irreversibile. Puoi revocare qualsiasi chiave all'istante dalla stessa scheda.
Come sostituisco una chiave esposta?
+
Scheda Developers → trova la chiave dal suo prefisso → Revoca (immediata). Poi crea una nuova chiave con gli stessi scope e la stessa allowlist IP, distribuiscila nella tua integrazione e controlla le informazioni sull'ultimo utilizzo della vecchia chiave per confermare che non riceve più traffico.
L'API può vedere i dati di un altro workspace?
+
No. Ogni chiamata API è limitata al workspace che ha emesso la chiave. Una chiave del workspace A non può in alcun modo leggere il workspace B: il vincolo è applicato lato server su ogni query.
Quali errori HTTP posso ricevere?
+
401 = la chiave è scaduta, revocata o non valida per il workspace. 403 = la chiave non ha lo scope necessario, oppure la richiesta arriva da un IP fuori dalla allowlist. 429 = hai raggiunto un limite di frequenza; attendi e riprova rispettando l'header Retry-After.
Che differenza c'è tra l'API e il server MCP?
+
Entrambi accedono agli stessi dati del workspace con gli stessi scope. L'API è per il tuo codice: cron job, webhook, strumenti interni, pipeline di sincronizzazione. Il server MCP è per gli agenti IA (Claude, ChatGPT, Cursor) che scoprono e chiamano gli strumenti in automatico tramite il Model Context Protocol. Usa l'API quando a consumare i dati è il codice; usa il server MCP quando è l'IA.
L'API supporta i webhook?
+
I webhook in uscita sono nella roadmap. Oggi il modello è di tipo pull: chiami l'API a intervalli regolari o in risposta ai tuoi eventi. L'app di Make.com ha anche trigger sugli eventi del workspace; controlla l'elenco dentro Make prima di progettare uno scenario attorno a uno di essi.
