Despre integrarea Telegram
Telegram e cel mai răspândit canal de comunicare instant din Moldova și România — saloanele, cabinetele medicale, atelierele auto, agențiile imobiliare îl folosesc deja zilnic pentru comunicarea cu clienții. Integrarea Megaforms → Telegram folosește un bot dedicat creat prin @BotFather (proces de 90 secunde) și trimite mesajul în chat-ul echipei (grup privat) sau canal public la fiecare răspuns nou. Mesajul conține numele respondentului, telefonul de contact, primele 3-5 răspunsuri critice (configurabile) și un link direct la profilul complet în panoul de control Megaforms. Notificarea ajunge în mai puțin de 5 secunde de la apăsarea „Trimite” — recepționistul vede contactul pe telefonul personal înainte ca respondentul să închidă pagina de mulțumire, ceea ce permite apel telefonic returnat în primul minut. Pentru organizațiile care au testat reacția în 1 minut vs 1 oră, rata de conversie a contactelor calde crește tipic cu 35-50%. Integrarea e gratuită — Telegram nu taxează API pentru bot-uri folosite în scop legitim. Limita practică e ~30 mesaje/secundă per bot, suficient pentru orice volum realist al unui formular B2B/B2C local. Pentru mai multe canale (recepție + manager + back-office), folosești un singur bot și mai multe chat_id (Megaforms suportă listă) sau bot-uri separate per role.
Pași de setup (5 pași, ~10-15 minute)
- 1Creează un bot prin @BotFather
Deschide Telegram, caută @BotFather, scrie /newbot, alege un nume (ex. „Bot Cabinet Dr. Popescu”) și un username unic terminat în _bot. BotFather îți trimite înapoi un token în format `123456:ABC-DEF…`. Copiază tokenul și păstrează-l în siguranță — e parola bot-ului.
- 2Obține chat_id-ul destinației
Pentru chat privat: scrie un mesaj la bot, apoi vizitează `https://api.telegram.org/bot<TOKEN>/getUpdates` în browser — vei vedea chat.id (un număr pozitiv). Pentru grup: adaugă bot-ul în grup, scrie un mesaj acolo, refă apelul getUpdates — chat.id va fi un număr negativ (ex. -1001234567890).
- 3Adaugă conectorul în Megaforms
În panoul de control Megaforms, deschide formularul, mergi la Integrări → Telegram. Lipește bot_token-ul și chat_id-ul. Apasă „Test” — primești un mesaj de probă în chat. Salvează.
- 4Personalizează șablonul mesajului (opțional)
Implicit, mesajul include toate răspunsurile. Pentru concizie, deschide setarea „Șablon mesaj” și folosește variabile: `{{respondent.name}}`, `{{respondent.phone}}`, `{{answers.urgenta}}`. Markdown e suportat (negrit, italic, cod inline).
- 5Activează integrarea pe live
Salvează formularul publicat. La prima submisie reală vei primi mesajul. Verifică în panoul de control → Integrări → Telegram → Istoric apeluri ca să confirmi că livrarea a reușit.
Câmpuri de configurare (3)
| Câmp | Tip | Obligatoriu | Descriere |
|---|---|---|---|
| bot_token | password | da | Token primit de la @BotFather când ai creat bot-ul. |
| chat_id | text | da | ID-ul chat-ului privat sau grupului. Obține-l prin apel getUpdates. |
| message_template | textarea | nu | Suportă Markdown. Variabilele disponibile: respondent.*, answers.*, form.*, submission.*. |
Scenarii detaliate pentru Telegram (1)
Fiecare scenariu are pagină proprie cu pași concreti, payload-uri reale și exemple de cod pentru implementare rapidă.
Conformitate și securitate pentru Telegram
- ✓Credențialele (1 câmpuri sensibile) sunt criptate la rest cu AES-256 în baza Megaforms.
- ✓Niciodată nu apar în log-uri sau exporturi. Mascate în UI după salvare (afișăm doar ultimele 4 caractere).
- ✓Apelurile către Telegram ies de pe servere UE (OVH Franța). Pentru stack 100% UE, combină cu integrări self-hosted (n8n, Postgres).
- ✓Jurnalul de apeluri reține timestamp, status code și error message — fără date personale ale respondenților (data minimization).
- ✓Retry automat 3 încercări cu backoff exponential (2s, 8s, 30s). Dead-letter queue pentru intervenție manuală după rezolvare problema.