Cum încorporezi formularul Megaforms pe orice site prin iframe

Pe scurt

Megaforms generează automat un snippet iframe pentru fiecare formular publicat. Copiezi codul HTML (un singur tag `<iframe>` cu atribute width, height, sandbox și src către forms.megapromoting.com/q/[slug]) și îl lipești unde vrei: pagină WordPress, post HubSpot, site Webflow, magazin Shopify, blog Ghost, document Notion (cu blocul Embed), pagină Wix sau orice CMS care permite cod HTML custom. Iframe-ul rulează izolat (sandbox-ul previne JavaScript din formular să afecteze site-ul gazdă), se redimensionează automat în funcție de înălțimea conținutului (mecanism postMessage), suportă tematizare custom via parametri URL (culoare brand, font, ascundere antet) și transmite UTM parameters și referrer la submisie pentru analiza completă a sursei contactului. Pentru organizațiile care nu vor să migreze site-ul pe Megaforms dar vor o experiență chestionar de calitate, iframe-ul e cel mai rapid mod de implementare (5 minute) cu zero compromis pe funcționalitatea formularului (voce, AI follow-up, conditional logic, plată Stripe — toate funcționează la fel ca pe pagina nativă).

Caz de utilizare tipic

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

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

1. 1
   Conectează cont Google prin OAuth

   În Megaforms → Integrări → Google Sheets → „Conectează cont Google”. Browser-ul deschide consent screen Google, autorizezi Megaforms cu scope `spreadsheets`. Token-ul se păstrează criptat în Megaforms.

2. 2
   Alege spreadsheet și sheet

   Megaforms listează spreadsheet-urile disponibile în contul Google. Alege spreadsheet țintă și sheet (fila) în interior. Sau creează nou („+ Spreadsheet nou pentru acest formular”).

3. 3
   Auto-detect coloane

   Apasă „Auto-create headers” — Megaforms scrie rândul 1 cu numele coloanelor: Timestamp, Form Name, urmate de un nume per câmp formular.

4. 4
   Mapează câmpuri (opțional, dacă vrei custom)

   Implicit, toate câmpurile formularului apar ca coloane în ordine. Pentru custom (ex. ascunde câmpuri sensibile, redenumește coloane), folosește interfața de mapare.

5. 5
   Test și activează

   Submisie de probă — rândul apare în Sheets în mai puțin de 5 secunde. Activează pe live.

Exemplu cod / payload

<!-- Snippet iframe generat automat -->
<iframe
  src="https://forms.megapromoting.com/q/your-form-slug?theme=light&primary=%23007aff"
  width="100%"
  height="600"
  frameborder="0"
  allow="microphone; camera"
  sandbox="allow-scripts allow-forms allow-same-origin allow-popups"
  loading="lazy"
  title="Formular contact"
></iframe>

<!-- Script opțional pentru auto-resize -->
<script>
window.addEventListener("message", (e) => {
  if (e.origin !== "https://forms.megapromoting.com") return;
  if (e.data?.type === "megaforms:resize") {
    document.querySelector("iframe").style.height = e.data.height + "px";
  }
});
</script>

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 Google Sheets ș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 Google Sheets 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 Google Sheets. Megaforms reîncearcă automat. Verifică status page-ul Google Sheets dacă persistă.

Conformitate și securitate

• ✓Apelurile către Google Sheets 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 Google Sheets 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.