Supabase: материалы к видеоуроку

Материалы к видеоуроку

Supabase: база и функция для заявок

Повторяйте шаги по порядку вместе с видео. Всё, что нужно вставить, — в серых блоках с кнопкой «Копировать».

Шаг 1

Аккаунт и проект

  1. Откройте supabase.com → Start your project.
  2. Зарегистрируйтесь по почте и подтвердите адрес по ссылке из письма Confirm your signup.
  3. Если Supabase предложит Create a new organization: в поле Name впишите любое название (например, Учёба), Plan оставьте Free, вопросы ниже можно пропустить → Create organization.
  4. Нажмите New project. Name — любое имя.
  5. Database Password → Generate a password. Сразу сохраните пароль в менеджер паролей: потом его не посмотреть.
  6. Region — Европа.
  7. Блок Security не меняйте. Supabase советует снять галочку Automatically expose new tables — не снимайте: без неё функция не сможет записывать заявки в таблицы.
  8. Create new project. Подождите 1–2 минуты.

Бесплатный проект засыпает, если к нему неделю не обращались. Данные не пропадают: зайдите в дашборд и нажмите Restore project.

Шаг 2

Таблицы

  1. Слева SQL Editor.
  2. Скопируйте схему ниже и вставьте в редактор.
  3. Нажмите Run. Ответ Success. No rows returned — всё получилось.
  4. Проверьте в Table Editor: четыре таблицы, в services три строки.

Схема базы

-- Учебный кейс «Запись на услугу»: схема данных MVP.
-- Применение: Supabase Dashboard → SQL Editor → вставить и выполнить,
-- или `supabase db push` из папки project/.

-- ─── Справочник услуг ───────────────────────────────────────────────
create table public.services (
  id          bigint generated always as identity primary key,
  code        text not null unique,             -- машинное имя: 'consult'
  title       text not null,                    -- как в выпадающем списке Tilda
  price       numeric(10, 2),
  is_active   boolean not null default true,
  created_at  timestamptz not null default now()
);

-- ─── Клиенты (пользователи, оставившие заявку) ─────────────────────
create table public.clients (
  id          bigint generated always as identity primary key,
  email       text not null unique,
  name        text not null,
  phone       text,
  created_at  timestamptz not null default now()
);

-- ─── Статусы заявки ────────────────────────────────────────────────
create type public.request_status as enum ('new', 'confirmed', 'done', 'cancelled');

-- ─── Заявки ────────────────────────────────────────────────────────
create table public.requests (
  id            bigint generated always as identity primary key,
  client_id     bigint not null references public.clients (id),
  service_id    bigint references public.services (id),   -- null, если услуга не распознана
  preferred_date date,
  comment       text,
  status        public.request_status not null default 'new',
  source        text,                                     -- скрытое поле / UTM
  tilda_tranid  text unique,                              -- защита от дублей
  created_at    timestamptz not null default now()
);

create index requests_client_id_idx on public.requests (client_id);
create index requests_status_idx    on public.requests (status);

-- ─── Журнал входящих webhook-запросов ──────────────────────────────
create table public.webhook_log (
  id          bigint generated always as identity primary key,
  received_at timestamptz not null default now(),
  result      text not null check (result in ('ok', 'duplicate', 'invalid', 'unauthorized', 'error', 'test')),
  http_status int  not null,
  message     text,
  payload     jsonb,          -- тело запроса без секретного ключа
  request_id  bigint references public.requests (id)
);

-- ─── Безопасность ──────────────────────────────────────────────────
-- RLS включён и политик для anon/authenticated нет. Значит, через публичный
-- anon-ключ ни прочитать, ни записать ничего нельзя. Пишет только Edge
-- Function с service_role-ключом, а он хранится в секретах Supabase,
-- а не на странице Tilda.
alter table public.services    enable row level security;
alter table public.clients     enable row level security;
alter table public.requests    enable row level security;
alter table public.webhook_log enable row level security;

-- Справочник услуг можно показывать публично (например, в каталоге).
create policy "services are public" on public.services
  for select to anon, authenticated using (is_active);

-- ─── Стартовые данные ──────────────────────────────────────────────
insert into public.services (code, title, price) values
  ('consult', 'Консультация',        2000),
  ('audit',   'Аудит сайта',         7500),
  ('setup',   'Настройка под ключ', 15000);

Ошибка already exists при повторном запуске значит, что таблицы уже созданы. Второй раз запускать не нужно.

Шаг 3

Секретный ключ

  1. Откройте консоль браузера: F12, на Mac Cmd+Option+J.
  2. Вставьте строку ниже и нажмите Enter. Появится ключ из 48 символов.
  3. Скопируйте ключ без кавычек и сохраните в менеджер паролей.

Генератор ключа

[...crypto.getRandomValues(new Uint8Array(24))].map(b => b.toString(16).padStart(2, '0')).join('')
  1. В Supabase: Edge Functions → Secrets.
  2. В форме Add or replace secrets: Name — имя ниже, Value — ваш ключ.
  3. Нажмите на глазок и проверьте, что ключ вставился целиком и без пробела в конце.
  4. Save. После сохранения значение больше не показывается.

Name

TILDA_WEBHOOK_SECRET

Не берите ключ с сайтов-генераторов. Никому не показывайте свой ключ: ни в скриншотах, ни в переписке.

Шаг 4

Функция

  1. Edge Functions → Deploy a new function → Via Editor.
  2. Имя функции — ниже. Без опечаток: имя войдёт в адрес функции.

Имя функции

tilda-webhook
  1. В файле index.ts удалите всё и вставьте код ниже.

index.ts

// Supabase Edge Function: приёмник webhook из Tilda.
//
// Цепочка: Tilda-форма → POST на эту функцию → проверка ключа → валидация
//          → запись в Postgres → запись в webhook_log → ответ Tilda.
//
// Деплой:  Dashboard → Edge Functions → Deploy a new function → Via Editor,
//          имя функции tilda-webhook, файлы index.ts и logic.ts, затем
//          в настройках функции выключить Verify JWT
//          (Tilda не умеет слать Supabase JWT, доступ закрыт своим ключом).
// Секрет:  Dashboard → Edge Functions → Secrets:
//          TILDA_WEBHOOK_SECRET = <длинная случайная строка>.
// Пошагово: ../../dashboard-setup.md
//
// SUPABASE_URL и SUPABASE_SERVICE_ROLE_KEY Supabase передаёт функции сам.
// service_role-ключ обходит RLS, поэтому он живёт только здесь, на сервере.

import { createClient } from "npm:@supabase/supabase-js@2";
import {
  extractKey,
  type Fields,
  isTildaTest,
  parseBody,
  redact,
  safeEqual,
  validate,
} from "./logic.ts";

const supabase = createClient(
  Deno.env.get("SUPABASE_URL")!,
  Deno.env.get("SUPABASE_SERVICE_ROLE_KEY")!,
  { auth: { persistSession: false } },
);
const SECRET = Deno.env.get("TILDA_WEBHOOK_SECRET") ?? "";

type LogResult = "ok" | "duplicate" | "invalid" | "unauthorized" | "error" | "test";

async function log(
  result: LogResult,
  httpStatus: number,
  message: string | null,
  payload: Fields | null,
  requestId: number | null = null,
) {
  const { error } = await supabase.from("webhook_log").insert({
    result,
    http_status: httpStatus,
    message,
    payload: payload ? redact(payload) : null,
    request_id: requestId,
  });
  // Сбой журнала не должен ломать ответ Tilda. Пишем в логи функции.
  if (error) console.error("webhook_log insert failed:", error.message);
}

function reply(status: number, body: string) {
  return new Response(body, {
    status,
    headers: { "Content-Type": "text/plain; charset=utf-8" },
  });
}

async function findServiceId(value: string | null): Promise<number | null> {
  if (!value) return null;
  // В выпадающем списке Tilda передаётся текст пункта, поэтому ищем и по code, и по title.
  const { data, error } = await supabase
    .from("services")
    .select("id, code, title")
    .eq("is_active", true);
  if (error) throw error;
  const needle = value.trim().toLowerCase();
  const hit = data.find((s) => s.code.toLowerCase() === needle || s.title.toLowerCase() === needle);
  return hit?.id ?? null;
}

Deno.serve(async (req) => {
  if (req.method !== "POST") return reply(405, "Method Not Allowed");

  let fields: Fields = {};
  try {
    fields = parseBody(req.headers.get("content-type"), await req.text());

    // 1. Проверочный запрос Tilda при подключении webhook. Ключ в нём может
    //    не прийти, поэтому отвечаем «ok» и ничего не записываем в заявки.
    if (isTildaTest(fields)) {
      await log("test", 200, "Tilda connection test", fields);
      return reply(200, "ok");
    }

    // 2. Ключ доступа
    const key = extractKey(req.headers, fields, new URL(req.url));
    if (!SECRET || !key || !safeEqual(key, SECRET)) {
      await log("unauthorized", 401, "missing or wrong api key", fields);
      return reply(401, "Unauthorized");
    }

    // 3. Серверная валидация
    const check = validate(fields);
    if (!check.ok) {
      await log("invalid", 400, check.errors.join("; "), fields);
      return reply(400, "Bad Request: " + check.errors.join("; "));
    }
    const d = check.data;

    // 4. Клиент: создать или обновить по email
    const { data: client, error: clientErr } = await supabase
      .from("clients")
      .upsert({ email: d.email, name: d.name, phone: d.phone }, { onConflict: "email" })
      .select("id")
      .single();
    if (clientErr) throw clientErr;

    // 5. Заявка. Уникальный tilda_tranid отсекает повторную доставку
    const { data: request, error: reqErr } = await supabase
      .from("requests")
      .insert({
        client_id: client.id,
        service_id: await findServiceId(d.service),
        preferred_date: d.preferredDate,
        comment: d.comment,
        source: d.source,
        tilda_tranid: d.tranid,
      })
      .select("id")
      .single();

    if (reqErr?.code === "23505") { // unique_violation
      await log("duplicate", 200, `tranid ${d.tranid} already stored`, fields);
      return reply(200, "ok");
    }
    if (reqErr) throw reqErr;

    await log("ok", 200, null, fields, request.id);
    return reply(200, "ok");
  } catch (e) {
    // Ошибки supabase-js — обычные объекты с полем message, а не Error.
    const message = (e as { message?: string })?.message ?? String(e);
    console.error("tilda-webhook failed:", message);
    await log("error", 500, message, fields);
    return reply(500, "Internal Server Error");
  }
});
  1. Добавьте второй файл. Имя — ровно такое:

Имя второго файла

logic.ts
  1. Вставьте в него код ниже.

logic.ts

// Чистая логика обработки заявки из Tilda: разбор тела, проверка ключа,
// валидация и нормализация полей. Здесь нет обращений к сети и БД, поэтому
// модуль одинаково работает в Deno (Edge Function) и в Node (тесты).

export type Fields = Record<string, string>;

export interface RequestData {
  name: string;
  email: string;
  phone: string;
  service: string | null;
  preferredDate: string | null; // YYYY-MM-DD
  comment: string | null;
  source: string | null;
  tranid: string | null;
}

export type ValidationResult =
  | { ok: true; data: RequestData }
  | { ok: false; errors: string[] };

// Служебные поля Tilda и поле с ключом: их не пишем в журнал как есть.
export const SECRET_FIELD = "api_key";

/**
 * Tilda по умолчанию шлёт application/x-www-form-urlencoded, но тело может
 * прийти и в JSON (другие источники, ручные тесты). Имена полей приводим
 * к нижнему регистру: «Name» и «name» считаем одним полем.
 */
export function parseBody(contentType: string | null, raw: string): Fields {
  const fields: Fields = {};
  const type = (contentType ?? "").toLowerCase();

  if (type.includes("application/json")) {
    const obj = JSON.parse(raw);
    if (obj === null || typeof obj !== "object" || Array.isArray(obj)) {
      throw new Error("JSON body must be an object");
    }
    for (const [k, v] of Object.entries(obj)) {
      if (v !== null && v !== undefined) fields[k.toLowerCase()] = String(v);
    }
    return fields;
  }

  for (const [k, v] of new URLSearchParams(raw)) {
    fields[k.toLowerCase()] = v;
  }
  return fields;
}

/** При подключении webhook Tilda отправляет проверочный запрос test=test. */
export function isTildaTest(fields: Fields): boolean {
  return fields.test === "test";
}

/** Сравнение строк за постоянное время, чтобы ключ нельзя было подобрать по таймингу. */
export function safeEqual(a: string, b: string): boolean {
  const enc = new TextEncoder();
  const x = enc.encode(a);
  const y = enc.encode(b);
  let diff = x.length ^ y.length;
  for (let i = 0; i < Math.max(x.length, y.length); i++) {
    diff |= (x[i] ?? 0) ^ (y[i] ?? 0);
  }
  return diff === 0;
}

/** Ключ может прийти в заголовке, в поле тела или в query-параметре URL. */
export function extractKey(headers: Headers, fields: Fields, url: URL): string | null {
  return (
    headers.get("x-api-key") ??
    fields[SECRET_FIELD] ??
    url.searchParams.get("key") ??
    null
  );
}

/** Копия полей для журнала: без секретного ключа. */
export function redact(fields: Fields): Fields {
  const copy = { ...fields };
  if (SECRET_FIELD in copy) copy[SECRET_FIELD] = "***";
  return copy;
}

const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;

/** Оставляет цифры и ведущий «+». Российские 8XXXXXXXXXX → +7XXXXXXXXXX. */
export function normalizePhone(input: string): string | null {
  const trimmed = input.trim();
  let digits = trimmed.replace(/\D/g, "");
  if (digits.length === 11 && digits.startsWith("8")) digits = "7" + digits.slice(1);
  if (digits.length === 10 && !trimmed.startsWith("+")) digits = "7" + digits;
  if (digits.length < 10 || digits.length > 15) return null;
  return "+" + digits;
}

/** Принимает ДД.ММ.ГГГГ, ДД-ММ-ГГГГ, ДД/ММ/ГГГГ и ГГГГ-ММ-ДД. Возвращает ГГГГ-ММ-ДД. */
export function normalizeDate(input: string): string | null {
  const s = input.trim();
  let y: number, m: number, d: number;
  let match = s.match(/^(\d{4})-(\d{2})-(\d{2})$/);
  if (match) {
    [y, m, d] = [Number(match[1]), Number(match[2]), Number(match[3])];
  } else if ((match = s.match(/^(\d{2})[.\-/](\d{2})[.\-/](\d{4})$/))) {
    [d, m, y] = [Number(match[1]), Number(match[2]), Number(match[3])];
  } else {
    return null;
  }
  const date = new Date(Date.UTC(y, m - 1, d));
  if (date.getUTCFullYear() !== y || date.getUTCMonth() !== m - 1 || date.getUTCDate() !== d) {
    return null; // например, 31.02.2026
  }
  return date.toISOString().slice(0, 10);
}

function clean(value: string | undefined, max: number): string | null {
  const v = (value ?? "").trim();
  return v === "" ? null : v.slice(0, max);
}

/**
 * Серверная валидация. Проверки на странице Tilda обходятся прямым
 * POST-запросом, поэтому здесь проверяется всё заново.
 */
export function validate(fields: Fields): ValidationResult {
  const errors: string[] = [];

  const name = clean(fields.name, 100);
  if (!name) errors.push("name: обязательное поле");

  const email = clean(fields.email, 254)?.toLowerCase() ?? null;
  if (!email) errors.push("email: обязательное поле");
  else if (!EMAIL_RE.test(email)) errors.push("email: неверный формат");

  const rawPhone = clean(fields.phone, 40);
  const phone = rawPhone ? normalizePhone(rawPhone) : null;
  if (!rawPhone) errors.push("phone: обязательное поле");
  else if (!phone) errors.push("phone: неверный формат");

  const rawDate = clean(fields.date, 20);
  const preferredDate = rawDate ? normalizeDate(rawDate) : null;
  if (rawDate && !preferredDate) errors.push("date: неверный формат");

  const consent = (fields.consent ?? "").trim().toLowerCase();
  if (!["yes", "on", "true", "1", "да"].includes(consent)) {
    errors.push("consent: нет согласия на обработку данных");
  }

  if (errors.length > 0) return { ok: false, errors };

  return {
    ok: true,
    data: {
      name: name!,
      email: email!,
      phone: phone!,
      service: clean(fields.service, 100),
      preferredDate,
      comment: clean(fields.comment, 2000),
      source: clean(fields.source, 200),
      tranid: clean(fields.tranid, 100),
    },
  };
}
  1. Нажмите Deploy function.
Не получается добавить второй файл? Запасной вариант одним файлом

Вставьте этот код в index.ts вместо двух файлов. Файл logic.ts тогда не нужен.

index.ts — одним файлом

// ОДНИМ ФАЙЛОМ для Dashboard → Edge Functions → Deploy a new function → Via Editor,
// если в редакторе не получается добавить второй файл.
//
// Файл собран скриптом supabase/make-single-file.mjs из logic.ts и index.ts.
// Источник правды — те два файла; после их правки пересоберите склейку.
// Вставлять целиком, начиная с первой строки, в файл index.ts редактора.

import { createClient } from "npm:@supabase/supabase-js@2";

// ═══════════════════════ часть 1: logic.ts ═══════════════════════

// Чистая логика обработки заявки из Tilda: разбор тела, проверка ключа,
// валидация и нормализация полей. Здесь нет обращений к сети и БД, поэтому
// модуль одинаково работает в Deno (Edge Function) и в Node (тесты).

export type Fields = Record<string, string>;

export interface RequestData {
  name: string;
  email: string;
  phone: string;
  service: string | null;
  preferredDate: string | null; // YYYY-MM-DD
  comment: string | null;
  source: string | null;
  tranid: string | null;
}

export type ValidationResult =
  | { ok: true; data: RequestData }
  | { ok: false; errors: string[] };

// Служебные поля Tilda и поле с ключом: их не пишем в журнал как есть.
export const SECRET_FIELD = "api_key";

/**
 * Tilda по умолчанию шлёт application/x-www-form-urlencoded, но тело может
 * прийти и в JSON (другие источники, ручные тесты). Имена полей приводим
 * к нижнему регистру: «Name» и «name» считаем одним полем.
 */
export function parseBody(contentType: string | null, raw: string): Fields {
  const fields: Fields = {};
  const type = (contentType ?? "").toLowerCase();

  if (type.includes("application/json")) {
    const obj = JSON.parse(raw);
    if (obj === null || typeof obj !== "object" || Array.isArray(obj)) {
      throw new Error("JSON body must be an object");
    }
    for (const [k, v] of Object.entries(obj)) {
      if (v !== null && v !== undefined) fields[k.toLowerCase()] = String(v);
    }
    return fields;
  }

  for (const [k, v] of new URLSearchParams(raw)) {
    fields[k.toLowerCase()] = v;
  }
  return fields;
}

/** При подключении webhook Tilda отправляет проверочный запрос test=test. */
export function isTildaTest(fields: Fields): boolean {
  return fields.test === "test";
}

/** Сравнение строк за постоянное время, чтобы ключ нельзя было подобрать по таймингу. */
export function safeEqual(a: string, b: string): boolean {
  const enc = new TextEncoder();
  const x = enc.encode(a);
  const y = enc.encode(b);
  let diff = x.length ^ y.length;
  for (let i = 0; i < Math.max(x.length, y.length); i++) {
    diff |= (x[i] ?? 0) ^ (y[i] ?? 0);
  }
  return diff === 0;
}

/** Ключ может прийти в заголовке, в поле тела или в query-параметре URL. */
export function extractKey(headers: Headers, fields: Fields, url: URL): string | null {
  return (
    headers.get("x-api-key") ??
    fields[SECRET_FIELD] ??
    url.searchParams.get("key") ??
    null
  );
}

/** Копия полей для журнала: без секретного ключа. */
export function redact(fields: Fields): Fields {
  const copy = { ...fields };
  if (SECRET_FIELD in copy) copy[SECRET_FIELD] = "***";
  return copy;
}

const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;

/** Оставляет цифры и ведущий «+». Российские 8XXXXXXXXXX → +7XXXXXXXXXX. */
export function normalizePhone(input: string): string | null {
  const trimmed = input.trim();
  let digits = trimmed.replace(/\D/g, "");
  if (digits.length === 11 && digits.startsWith("8")) digits = "7" + digits.slice(1);
  if (digits.length === 10 && !trimmed.startsWith("+")) digits = "7" + digits;
  if (digits.length < 10 || digits.length > 15) return null;
  return "+" + digits;
}

/** Принимает ДД.ММ.ГГГГ, ДД-ММ-ГГГГ, ДД/ММ/ГГГГ и ГГГГ-ММ-ДД. Возвращает ГГГГ-ММ-ДД. */
export function normalizeDate(input: string): string | null {
  const s = input.trim();
  let y: number, m: number, d: number;
  let match = s.match(/^(\d{4})-(\d{2})-(\d{2})$/);
  if (match) {
    [y, m, d] = [Number(match[1]), Number(match[2]), Number(match[3])];
  } else if ((match = s.match(/^(\d{2})[.\-/](\d{2})[.\-/](\d{4})$/))) {
    [d, m, y] = [Number(match[1]), Number(match[2]), Number(match[3])];
  } else {
    return null;
  }
  const date = new Date(Date.UTC(y, m - 1, d));
  if (date.getUTCFullYear() !== y || date.getUTCMonth() !== m - 1 || date.getUTCDate() !== d) {
    return null; // например, 31.02.2026
  }
  return date.toISOString().slice(0, 10);
}

function clean(value: string | undefined, max: number): string | null {
  const v = (value ?? "").trim();
  return v === "" ? null : v.slice(0, max);
}

/**
 * Серверная валидация. Проверки на странице Tilda обходятся прямым
 * POST-запросом, поэтому здесь проверяется всё заново.
 */
export function validate(fields: Fields): ValidationResult {
  const errors: string[] = [];

  const name = clean(fields.name, 100);
  if (!name) errors.push("name: обязательное поле");

  const email = clean(fields.email, 254)?.toLowerCase() ?? null;
  if (!email) errors.push("email: обязательное поле");
  else if (!EMAIL_RE.test(email)) errors.push("email: неверный формат");

  const rawPhone = clean(fields.phone, 40);
  const phone = rawPhone ? normalizePhone(rawPhone) : null;
  if (!rawPhone) errors.push("phone: обязательное поле");
  else if (!phone) errors.push("phone: неверный формат");

  const rawDate = clean(fields.date, 20);
  const preferredDate = rawDate ? normalizeDate(rawDate) : null;
  if (rawDate && !preferredDate) errors.push("date: неверный формат");

  const consent = (fields.consent ?? "").trim().toLowerCase();
  if (!["yes", "on", "true", "1", "да"].includes(consent)) {
    errors.push("consent: нет согласия на обработку данных");
  }

  if (errors.length > 0) return { ok: false, errors };

  return {
    ok: true,
    data: {
      name: name!,
      email: email!,
      phone: phone!,
      service: clean(fields.service, 100),
      preferredDate,
      comment: clean(fields.comment, 2000),
      source: clean(fields.source, 200),
      tranid: clean(fields.tranid, 100),
    },
  };
}

// ═══════════════════════ часть 2: index.ts ═══════════════════════

// Supabase Edge Function: приёмник webhook из Tilda.
//
// Цепочка: Tilda-форма → POST на эту функцию → проверка ключа → валидация
//          → запись в Postgres → запись в webhook_log → ответ Tilda.
//
// Деплой:  Dashboard → Edge Functions → Deploy a new function → Via Editor,
//          имя функции tilda-webhook, файлы index.ts и logic.ts, затем
//          в настройках функции выключить Verify JWT
//          (Tilda не умеет слать Supabase JWT, доступ закрыт своим ключом).
// Секрет:  Dashboard → Edge Functions → Secrets:
//          TILDA_WEBHOOK_SECRET = <длинная случайная строка>.
// Пошагово: ../../dashboard-setup.md
//
// SUPABASE_URL и SUPABASE_SERVICE_ROLE_KEY Supabase передаёт функции сам.
// service_role-ключ обходит RLS, поэтому он живёт только здесь, на сервере.


const supabase = createClient(
  Deno.env.get("SUPABASE_URL")!,
  Deno.env.get("SUPABASE_SERVICE_ROLE_KEY")!,
  { auth: { persistSession: false } },
);
const SECRET = Deno.env.get("TILDA_WEBHOOK_SECRET") ?? "";

type LogResult = "ok" | "duplicate" | "invalid" | "unauthorized" | "error" | "test";

async function log(
  result: LogResult,
  httpStatus: number,
  message: string | null,
  payload: Fields | null,
  requestId: number | null = null,
) {
  const { error } = await supabase.from("webhook_log").insert({
    result,
    http_status: httpStatus,
    message,
    payload: payload ? redact(payload) : null,
    request_id: requestId,
  });
  // Сбой журнала не должен ломать ответ Tilda. Пишем в логи функции.
  if (error) console.error("webhook_log insert failed:", error.message);
}

function reply(status: number, body: string) {
  return new Response(body, {
    status,
    headers: { "Content-Type": "text/plain; charset=utf-8" },
  });
}

async function findServiceId(value: string | null): Promise<number | null> {
  if (!value) return null;
  // В выпадающем списке Tilda передаётся текст пункта, поэтому ищем и по code, и по title.
  const { data, error } = await supabase
    .from("services")
    .select("id, code, title")
    .eq("is_active", true);
  if (error) throw error;
  const needle = value.trim().toLowerCase();
  const hit = data.find((s) => s.code.toLowerCase() === needle || s.title.toLowerCase() === needle);
  return hit?.id ?? null;
}

Deno.serve(async (req) => {
  if (req.method !== "POST") return reply(405, "Method Not Allowed");

  let fields: Fields = {};
  try {
    fields = parseBody(req.headers.get("content-type"), await req.text());

    // 1. Проверочный запрос Tilda при подключении webhook. Ключ в нём может
    //    не прийти, поэтому отвечаем «ok» и ничего не записываем в заявки.
    if (isTildaTest(fields)) {
      await log("test", 200, "Tilda connection test", fields);
      return reply(200, "ok");
    }

    // 2. Ключ доступа
    const key = extractKey(req.headers, fields, new URL(req.url));
    if (!SECRET || !key || !safeEqual(key, SECRET)) {
      await log("unauthorized", 401, "missing or wrong api key", fields);
      return reply(401, "Unauthorized");
    }

    // 3. Серверная валидация
    const check = validate(fields);
    if (!check.ok) {
      await log("invalid", 400, check.errors.join("; "), fields);
      return reply(400, "Bad Request: " + check.errors.join("; "));
    }
    const d = check.data;

    // 4. Клиент: создать или обновить по email
    const { data: client, error: clientErr } = await supabase
      .from("clients")
      .upsert({ email: d.email, name: d.name, phone: d.phone }, { onConflict: "email" })
      .select("id")
      .single();
    if (clientErr) throw clientErr;

    // 5. Заявка. Уникальный tilda_tranid отсекает повторную доставку
    const { data: request, error: reqErr } = await supabase
      .from("requests")
      .insert({
        client_id: client.id,
        service_id: await findServiceId(d.service),
        preferred_date: d.preferredDate,
        comment: d.comment,
        source: d.source,
        tilda_tranid: d.tranid,
      })
      .select("id")
      .single();

    if (reqErr?.code === "23505") { // unique_violation
      await log("duplicate", 200, `tranid ${d.tranid} already stored`, fields);
      return reply(200, "ok");
    }
    if (reqErr) throw reqErr;

    await log("ok", 200, null, fields, request.id);
    return reply(200, "ok");
  } catch (e) {
    // Ошибки supabase-js — обычные объекты с полем message, а не Error.
    const message = (e as { message?: string })?.message ?? String(e);
    console.error("tilda-webhook failed:", message);
    await log("error", 500, message, fields);
    return reply(500, "Internal Server Error");
  }
});

Шаг 5

Выключить Verify JWT

  1. Edge Functions → tilda-webhook → Settings.
  2. Выключите переключатель Verify JWT (в другой версии интерфейса — Enforce JWT Verification).
  3. Save.

Без этого сайт будет получать отказ на каждую заявку. Функция при этом остаётся защищённой: заявки проверяет ваш секретный ключ.

Шаг 6

Проверка

  1. На странице функции нажмите Test.
  2. Если есть поле с токеном авторизации — очистите его.
  3. Метод POST.
  4. В Headers добавьте два заголовка.

Заголовок 1 — имя

Content-Type

Заголовок 1 — значение

application/x-www-form-urlencoded

Заголовок 2 — имя

x-api-key

Заголовок 2 — значение

ваш ключ из менеджера паролей

  1. В тело запроса вставьте пробную заявку.

Пробная заявка

Name=Пробный Клиент&Email=demo@example.com&Phone=89990001122&Service=Консультация&consent=yes&tranid=demo-001
  1. Send Request. Ответ 200 и ok.
  2. В Table Editor: заявка в requests, клиент в clients, строка ok в webhook_log.
  3. Удалите заголовок x-api-key и отправьте ещё раз. Ответ 401 Unauthorized, в webhook_log — строка unauthorized.
ЗапросОтвет
С ключом200 ok
Без ключа401 Unauthorized

Шаг 7

Подключить форму Tilda

Что взять из Supabase

  • Адрес функции: Edge Functions → tilda-webhook → адрес вида https://….supabase.co/functions/v1/tilda-webhook, рядом кнопка копирования.
  • Секретный ключ: из вашего менеджера паролей.

Подключить webhook в Tilda

  1. Tilda → Мои сайты → ваш сайт → Настройки сайта → Формы → Webhook.
  2. WEBHOOK URL: вставьте адрес функции.
  3. Ниже три поля в ряд. API METHOD: выберите HEADER.
  4. API NAME: вставьте имя ниже.

API NAME

x-api-key
  1. API KEY: ваш ключ из менеджера паролей.
  2. НАЗВАНИЕ В СПИСКЕ можно не менять.
  3. Сохраните. Tilda отправит проверочный запрос, в таблице webhook_log появится строка test.

Проверочный запрос подтверждает только, что адрес правильный. Ключ он не проверяет: ошибку в ключе покажет первая настоящая заявка.

Настроить форму на странице

  1. Добавьте на страницу блок формы из библиотеки (категория Форма) или откройте уже готовый.
  2. Блок → Контент. Проверьте имена переменных у полей: они должны быть такими, как в таблице. Большие или маленькие буквы — неважно.
ПолеИмя переменной
Имя (обязательное)name
Email (обязательное)email
Телефон (обязательное)phone
Чекбокс согласия (обязательный)consent
Услуга, выпадающий списокservice
  1. В выпадающем списке «Услуга» варианты ответа — ровно такие, по одному на строке:

Варианты услуги

Консультация
Аудит сайта
Настройка под ключ
  1. Там же, в Контент → Сервисы приёма данных, отметьте подключённый webhook.
  2. Сохранить → Закрыть → Опубликовать. В режиме предпросмотра форма заявки не отправляет.

Проверить

  1. Откройте опубликованную страницу и отправьте заявку с выдуманными данными: не своё имя, телефон и почта.
  2. В Supabase → Table Editor: новая заявка в requests, строка ok в webhook_log.
В webhook_logЧто исправить
unauthorizedAPI METHOD, API NAME или API KEY в настройках webhook
invalidимена переменных у полей или не отмечено согласие
ничего нетвыключен ли Verify JWT (шаг 5), отмечен ли webhook в блоке формы, опубликована ли страница

Ключ хранится только в двух местах: в Supabase и в настройках webhook в Tilda. Не вставляйте его в скрытое поле формы, в блок T123 или в код страницы: там его увидит любой посетитель.

Made on
Tilda