Skip to content

Contact form and leads

The contact form opens from Send us a message on your button’s start screen. Visitors leave their details and a message, so you can reply later, even outside business hours. New sites start with it on; you choose its fields under Widget → Channels → Message form.

Your own questions

Under Message form → More questions, add up to 5 questions of your own: a short text, a list to choose from (such as “Which service?”), a date (such as “Preferred day”) or a checkbox. Each one can be required or optional, and written in each of your widget’s languages. The answers appear with the message everywhere it goes.

Where each lead came from

Each message keeps the page the visitor first landed on, the site that sent them (such as Google or Instagram), the campaign tags in your ad links (utm_source, utm_medium, utm_campaign, utm_term and utm_content), and their country and device. You see it on each lead, in the alerts and in the CSV export, so you know which ads and pages bring customers.

In your dashboard

Every message is kept under Leads, newest first. Mark each one New, Contacted, Won or Lost, delete the ones you don’t need, and use Export CSV to open them in a spreadsheet. If you’ve connected an AI key, each message also gets a one-line summary and a rating (hot, warm or cold), which the alerts below include too.

By email

Each message is emailed to your account’s address right away. To send it somewhere else, or to several people, list the addresses under Leads → Where messages go. Reply straight to the visitor from the email.

Telegram

On paid plans, each message can also arrive in Telegram, on your phone or in a team group:

  1. Under Leads → Where messages go, choose Connect Telegram.
  2. Choose Open Telegram and press Start. For a team group, use the link to add the bot to the group instead.
  3. The dashboard shows the chat as connected within a few seconds. Use Send a test message to try it.

Each site can send alerts to up to 5 chats. To stop them, send /stop in the chat, or choose Disconnect in the dashboard.

Google Sheets

On paid plans, each message can also become a row in a Google Sheet:

  1. Create a sheet, then open Extensions → Apps Script.
  2. Replace the code with the script below and save.
  3. Deploy → New deployment, type Web app, execute as Me, access Anyone. Copy the web app address.
  4. Paste it under Where messages go → Google Sheets, save, and use Send a test message.
function doPost(e) {
  var data = JSON.parse(e.postData.contents);
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  if (sheet.getLastRow() === 0) {
    sheet.appendRow(['Date', 'Name', 'Email', 'Phone', 'Message', 'Page', 'Site', 'Answers', 'Landing page', 'Referrer',
      'UTM source', 'UTM medium', 'UTM campaign', 'UTM term', 'UTM content', 'Country', 'Device']);
  }
  var l = data.lead;
  var c = l.context || {};
  var u = c.utm || {};
  var answers = (l.fields || []).map(function (f) { return f.label + ': ' + f.value; }).join('\n');
  var row = [l.createdAt, l.name, l.email, l.phone, l.message, l.page, data.site.name, answers, c.landing, c.referrer,
    u.source, u.medium, u.campaign, u.term, u.content, c.country, c.device];
  sheet.appendRow(row.map(function (v) {
    v = v == null ? '' : String(v);
    return /^[=+\-@]/.test(v) ? "'" + v : v;
  }));
  return ContentService.createTextOutput('ok');
}

Webhooks (Zapier, Make, n8n, your own server)

On paid plans, each message can be posted as JSON to any address you choose:

{
  "event": "lead.created",
  "site": { "id": "k3j9x2m7qa", "name": "Cedar Dental" },
  "lead": {
    "id": "q8r2m5t1vx7c",
    "name": "Sara",
    "email": "sara@example.com",
    "phone": null,
    "message": "Do you have appointments on Saturday?",
    "page": "https://cedar.example/prices",
    "source": "form",
    "consent": false,
    "summary": "Wants a Saturday appointment for a checkup",
    "score": "warm",
    "fields": [
      { "id": "service", "label": "Service", "value": "Checkup" },
      { "id": "day", "label": "Preferred day", "value": "2026-10-17" }
    ],
    "context": {
      "landing": "https://cedar.example/prices",
      "referrer": "https://www.google.com",
      "utm": { "source": "google", "medium": "cpc", "campaign": "autumn" },
      "country": "EG",
      "device": "mobile"
    },
    "createdAt": "2026-10-11T09:30:00.000Z"
  }
}

source is form for the contact form. summary and score (hot, warm or cold) come from your AI key and are null without one. fields holds the answers to your own questions (empty without them), and context where the visitor came from, or null when unknown. Each request carries an X-Signature-256 header: sha256= followed by the HMAC-SHA256 of the raw body, keyed with the signing secret shown in your dashboard next to the webhook address. Check it before trusting a request:

import { createHmac, timingSafeEqual } from 'node:crypto';

// rawBody: the request body exactly as received, before any JSON parsing.
function isFromReachly(rawBody, signatureHeader, secret) {
  const expected = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(signatureHeader ?? '');
  const b = Buffer.from(expected);
  return a.length === b.length && timingSafeEqual(a, b);
}

Use Send a test message in the dashboard to see each route’s result.

Spam

The form only accepts messages from your own website address, ignores what simple bots fill in, and limits how many messages one visitor can send in a few minutes.