Материалы к видеоуроку
Повторяйте шаги по порядку вместе с видео. Всё, что нужно вставить, — в серых блоках с кнопкой «Копировать».
Шаг 1
Бесплатный проект засыпает, если к нему неделю не обращались. Данные не пропадают: зайдите в дашборд и нажмите Restore project.
Шаг 2
Схема базы
-- Учебный кейс «Запись на услугу»: схема данных 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
Генератор ключа
[...crypto.getRandomValues(new Uint8Array(24))].map(b => b.toString(16).padStart(2, '0')).join('')Name
TILDA_WEBHOOK_SECRET
Не берите ключ с сайтов-генераторов. Никому не показывайте свой ключ: ни в скриншотах, ни в переписке.
Шаг 4
Имя функции
tilda-webhook
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");
}
});Имя второго файла
logic.ts
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),
},
};
}Вставьте этот код в 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
Без этого сайт будет получать отказ на каждую заявку. Функция при этом остаётся защищённой: заявки проверяет ваш секретный ключ.
Шаг 6
Заголовок 1 — имя
Content-Type
Заголовок 1 — значение
application/x-www-form-urlencoded
Заголовок 2 — имя
x-api-key
Заголовок 2 — значение
ваш ключ из менеджера паролей
Пробная заявка
Name=Пробный Клиент&Email=demo@example.com&Phone=89990001122&Service=Консультация&consent=yes&tranid=demo-001
| Запрос | Ответ |
|---|---|
| С ключом | 200 ok |
| Без ключа | 401 Unauthorized |
Шаг 7
API NAME
x-api-key
Проверочный запрос подтверждает только, что адрес правильный. Ключ он не проверяет: ошибку в ключе покажет первая настоящая заявка.
| Поле | Имя переменной |
|---|---|
| Имя (обязательное) | name |
| Email (обязательное) | |
| Телефон (обязательное) | phone |
| Чекбокс согласия (обязательный) | consent |
| Услуга, выпадающий список | service |
Варианты услуги
Консультация Аудит сайта Настройка под ключ
| В webhook_log | Что исправить |
|---|---|
| unauthorized | API METHOD, API NAME или API KEY в настройках webhook |
| invalid | имена переменных у полей или не отмечено согласие |
| ничего нет | выключен ли Verify JWT (шаг 5), отмечен ли webhook в блоке формы, опубликована ли страница |
Ключ хранится только в двух местах: в Supabase и в настройках webhook в Tilda. Не вставляйте его в скрытое поле формы, в блок T123 или в код страницы: там его увидит любой посетитель.