TruForms
Integrations

Integrations

Wire up Slack, Discord, Telegram, Google Sheets, and custom webhooks.

Last updated

Each form has its own integrations. Open Forms → your form → Integrations in the dashboard.

The pattern is the same for every connector: paste a URL or token, hit Save, then click Send test to push a fake submission through and confirm it landed. Integrations are per-form, so set them up on each form you want them on.

Integration secrets are encrypted at rest with AES-256-GCM. Neither our support team nor anyone reading the database directly can recover them without the instance's master key.

Webhook

The most flexible option. We POST JSON to any URL; you do whatever you want with it.

  • URL — your endpoint. Must respond with 2xx to acknowledge.
  • Signing secret — auto-generated. Verify incoming signatures with this.

Retries: 8 attempts, exponential backoff. Each attempt is logged in the delivery panel.

Slack

  1. In Slack: Apps → Incoming Webhooks → Add to channel, copy the URL (starts with hooks.slack.com/services/...).
  2. In TruForms: Slack → paste URL → Save → Send test to confirm.

Each submission arrives as a Block Kit message with a header for the form name and a two-column layout of every field.

Discord

  1. In Discord channel settings: Integrations → Webhooks → New Webhook, copy the URL.
  2. In TruForms: Discord → paste URL → Save → Send test.

Messages use Discord embed fields (up to 25 fields per submission).

Telegram

Telegram requires a bot:

  1. Talk to @BotFather → /newbot → copy the token.
  2. Add the bot to your group or channel; promote it so it can post.
  3. Find your chat ID — DM the bot and fetch https://api.telegram.org/bot<TOKEN>/getUpdates, or use @getidsbot.
  4. In TruForms: Telegram → bot token + chat ID → Save.

Messages are MarkdownV2-formatted.

Google Sheets

Each submission appends a row: [timestamp, submission_id, form_name, ...payload fields].

  1. Create a Google Sheet, note the spreadsheet ID from its URL (docs.google.com/spreadsheets/d/<ID>/edit).
  2. In Google Cloud Console:
    • Create a project (or reuse one).
    • Enable Google Sheets API.
    • Service Accounts → Create, then Keys → Add key → JSON, download the JSON.
  3. Share the spreadsheet with the service account's email ([email protected]) as Editor.
  4. In TruForms: paste the spreadsheet ID, sheet name (default Sheet1), and the full JSON contents into the Service account JSON field.

The JSON is encrypted before storage. We never log or return its contents.

Test-fire and delivery log

Every integration has a Send test button that fires a synthetic payload ({"test":true,"name":"Test","email":"[email protected]","message":"Hello from TruForms"}) through the real pipeline. Useful for verifying connectivity without generating a fake submission.

The Delivery log panel on the Webhook integration lists the last 50 attempts: status, HTTP code, error string, relative timestamp. It auto-refreshes every 10 seconds while open.

Enabling and disabling

Each integration has an Enabled toggle. Disabled integrations are preserved but skipped — submissions still hit the form, they just don't fan out here. Flip the switch back and new submissions resume delivery.

Further reading

Integrations — TruForms