Cum primești notificare pe Telegram la fiecare răspuns nou

Pe scurt

Setezi un bot Telegram (@BotFather) și conectezi chat_id-ul echipei. Megaforms trimite mesaj în secunda când respondentul apasă „Trimite”, cu numele, telefonul și primele 3 răspunsuri critice. Recepția vede contactul nou pe telefon înainte să închidă pagina de mulțumire.

Caz de utilizare tipic

Pași de implementare (pe baza setup-ului Telegram)

Scenariul refolosește configurarea de bază a integrării Telegram, cu ajustări specifice descrise mai jos. Dacă nu ai configurat încă integrarea, parcurge întâi pașii standard:

1. 1
   Creează 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.

2. 2
   Obț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).

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

4. 4
   Personalizează ș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).

5. 5
   Activează 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.

Exemplu cod / payload

// Exemplu payload trimis de Megaforms
{
  "event": "submission.created",
  "title": "Programare nouă — Dr. Popescu",
  "respondent": "Maria Ionescu · +373 69 123 456",
  "answers": [
    { "q": "Tip vizită", "a": "Consult inițial" },
    { "q": "Urgență", "a": "În următoarele 24h" },
    { "q": "Asigurare", "a": "ASP-Moldsana" }
  ]
}

Variabilele între acolade duble (ex. `{{submission.email}}`) sunt înlocuite automat de Megaforms la fiecare submisie. Lista completă a variabilelor în Setări → Integrări → Documentație variabile.

Erori frecvente și depanare

• ⚠401 Unauthorized — credențialele sunt invalide sau au fost revocate. Regenerează în panoul Telegram și re-introdu în Megaforms.
• ⚠404 Not Found — endpoint-ul țintă (chat_id, database_id, webhook URL) nu există sau nu e accesibil. Verifică în panoul Telegram că destinația e validă.
• ⚠422 Unprocessable Entity — payload-ul nu respectă schema așteptată (ex. valoare Multiple Select care nu există ca opțiune predefinită). Verifică maparea câmpurilor.
• ⚠429 Too Many Requests — rate limit atins. Megaforms reîncearcă automat cu backoff. Pentru volume mari, considerează rutarea prin webhook generic + n8n self-hosted.
• ⚠500/502/503 — eroare temporară pe serverul Telegram. Megaforms reîncearcă automat. Verifică status page-ul Telegram dacă persistă.

Conformitate și securitate

• ✓Apelurile către Telegram sunt jurnalizate cu timestamp, status code și error message — fără date personale ale respondenților.
• ✓Credențialele sunt criptate AES-256 la rest. Nu apar în log-uri sau exporturi.
• ✓Apelurile către Telegram ies de pe servere Megaforms situate în UE (OVH Franța). Destinația finală depinde de provider — vezi pagina de bază a integrării pentru detalii.
• ✓Retry automat 3 încercări (2s, 8s, 30s). Dead-letter queue cu retry manual din panoul de control.

Următorii pași

După ce ai configurat scenariul, recomandăm să monitorizezi primele 50-100 apeluri în Setări → Integrări → Istoric apeluri pentru a confirma că rata de succes e peste 99% și că payload-ul ajunge formatat corect la destinație. Pentru ajustări fine (filtre adiționale, mapare câmpuri, șabloane custom), editarea se face direct în conectorul integrării fără a re-configura tot scenariul.

Pentru scenarii compuse (ex. același formular trimite la Slack + Notion + Mailchimp în paralel), poți activa mai multe integrări per formular și folosi logica condițională pentru a alege care se declanșează la fiecare submisie. Vezi documentația despre rutare condițională în articolele de ajutor.