Tilda form webhook

Formgong team ·

A Tilda form webhook is the URL Tilda calls for each lead. Add Tilda under Platforms in Formgong and paste that URL into Site Settings, then Forms, then Webhook. Tick Webhook on the form and publish the page again. Tilda's test gets the word ok. The same lead id is stored once. Telegram is instant on the free plan.

What a Tilda form webhook actually sends

Tilda posts the lead as application/x-www-form-urlencoded. The Formgong URL is POST /in/ plus a 64-character token. You copy it once under Platforms after you add Tilda.

Connecting the receiver sends a body whose only field is test=test. Formgong answers with the plain word ok and does not store a lead.

A real lead includes tranid. That id stays the same when Tilda tries again. Formgong stores the lead once. A second POST with the same tranid gets ok and does not create a second row.

formid, formname and COOKIES are Tilda's own fields. They are not shown as answers. When Send cookies is on, TILDAUTM inside COOKIES is read for utm tags.

The page address is taken from the Referer header. The reply is plain text, not JSON. Tilda stops waiting after about five seconds, so Telegram and email are sent after the ok.

The URL is a secret. Anyone who has it can post leads. If it leaks, create a new URL under Platforms. The old one stops at once. A free form can have 3 of these platform URLs.

Tilda forms bot, if you only want Telegram

Tilda's own bot is @TildaFormsBot. Open it, send /start, and copy the API key and the secret key it returns.

In Tilda open Site Settings, then Forms, then Telegram. Paste both keys and save. On the form block, open Content, tick Telegram, and publish the page.

For a group, add the bot, send /start in the group, and use the group key. Tilda says that key starts with a minus, and that each project should get its own keys.

That bot is the right tool when a Telegram message is all you need. It does not give you Formgong's inbox, a status on the lead, or a reminder when a lead sits unanswered.

The free Tilda plan does not deliver form data at all. Telegram, email and webhooks there need Personal or Business. The same limit applies to code in a T123 block.

What Formgong does after the webhook

The lead lands in the same inbox as a form you pasted yourself. Telegram is instant on the free plan.

On the free plan, email is sent for every lead. Telegram is instant too.

The free plan is 250 submissions a month. Leads from the webhook count toward that limit. Auto-reply is not on the free plan. Submission data is stored in the EU.

Support is Formgong at support@formgong.com. A Ukrainian guide to the bot and this webhook is on the Tilda Telegram page.

Заявки з Tilda в Telegram (українською)

HTML in a T123 block, if you skip the webhook

Paste this into Block Library, Other, T123. Replace the placeholder key. The block needs a paid Tilda plan, the same as the webhook.

Use the block when you want Formgong's honeypot in the form. Use the webhook when you want to keep Tilda's form design.

HTML for a T123 block
<form action="https://formgong.com/submit" method="POST">
  <input type="hidden" name="access_key" value="fk_your_access_key">
  <input type="hidden" name="_lang" value="en">
  <label>Name <input type="text" name="name" autocomplete="name" placeholder="Your name" required></label>
  <label>Email <input type="email" name="email" autocomplete="email" placeholder="you@example.com" required></label>
  <label>Message <textarea name="message" placeholder="How can we help?" required></textarea></label>
  <div aria-hidden="true" style="position:absolute;inset-inline-start:0;top:0;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)">
  <label>Leave this field empty<input type="text" name="botcheck" tabindex="-1" autocomplete="off"></label>
</div>
  
  <button type="submit">Send</button>
</form>

How forms work in Tilda

Tilda sends each form lead to a receiver you turn on under Site Settings, then Forms. Receivers include email, Telegram and a webhook. The free Tilda plan turns receivers off, and it turns off code in the T123 block. Both ways on this page need a paid Tilda plan.

The webhook keeps the Tilda form. Add Tilda under Platforms in Formgong and paste the URL into the webhook receiver. Formgong answers the connection test with the word ok, and it stores one lead when Tilda retries. A T123 block is the other way, if you want your own HTML.

Set it up in Tilda

  1. In Formgong open the form, choose Platforms, add Tilda and copy the URL. It is shown only once. The path is /in/ and a long token.
  2. In Tilda open Site Settings, then Forms, then Webhook. Paste the URL and save. Tilda sends a one-field test. Formgong answers with the word ok.
  3. Open every form block, open Content, tick Webhook, and publish the page again. Saving the site settings is not enough.
  4. Send a lead from the published page. Tilda retries with the same tranid. Formgong stores that lead once. If nothing arrives, open the error log under Tilda's Leads.
  5. Or paste the HTML snippet into a T123 block and publish. That block needs a paid Tilda plan, the same as the webhook.

Step-by-step guide in the docs

Formgong or the Tilda forms bot?

If you only want Telegram, start with @TildaFormsBot. Send /start, paste both keys into Site Settings, Forms, Telegram, tick Telegram on the form, and publish.

Use Formgong when the lead should also sit in an inbox, with a status and a reminder if nobody answers. The Tilda bot does not do that. Data is stored in the EU.

Questions and answers

Does this work on Tilda's free plan?

No. The free plan has no form receivers, and code in a T123 block is off. The webhook and the bot both need a paid Tilda plan.

How do I connect the Tilda forms bot?

Open @TildaFormsBot, send /start, and paste both keys into Site Settings, Forms, Telegram. Tick Telegram on the form and publish. That path is Tilda's, not Formgong's.

Will Tilda's retries create two leads?

No. Tilda sends the same tranid when it tries again. Formgong stores that lead once and answers ok.

Why does Tilda say the receiver is connected but nothing arrives?

The Webhook box on the form block is probably unticked, or the page was not published again. The URL is a secret: if it leaks, create a new one under Platforms.

Start free