Как подключить Тильду
Петген сам в Тильду не заходит. После оплаты Тильда присылает заказ на адрес ниже. CRM при этом остаётся: в корзине можно отметить и CRM, и этот адрес. Заказ уйдёт в оба места.
Поле «URL-адрес веб-крючка»
https://lk.petgen.ru/api/v1/integrations/tilda/webhook
Это адрес кабинета владельца. Админка на admin.lk.petgen.ru Тильде не нужна. Пока домен не смотрит на сервер, вебхук сохранять рано: Тильда не достучится до этого компьютера.
1. Товары в каталоге Тильды
У каждого товара в поле артикула (SKU) стоит ровно такой код. По нему Петген понимает, какой набор создать.
| Товар | Артикул в Тильде |
|---|---|
| PET GEN «Максимум» | SKU0001 |
| PET GEN «Базовый» | SKU0002 |
| PET GEN «Порода+» | SKU0003 |
| PET GEN «Кошачий рай» | SKU0004 |
Две штуки в одном заказе — два набора. Если артикула нет, система создаст один набор «Максимум».
В настройках Webhook галочку «Передавать товары массивом» не включайте. Нужна обычная строка вида Название (SKU0001) x 1.
2. Доставка в корзине Тильды
Человек выбирает способ на Тильде. Заказ в СДЭК создаёт сама Тильда. Если в вебхуке есть номер отправления, он появляется в строке «К отправлению». Если номера нет, строка всё равно отмечается кнопкой «Отдали в СДЭК».
В название способа впишите слово, по которому очередь понятна сама:
- СДЭК — в названии есть «СДЭК», «СДЕК» или CDEK.
- Самовывоз — в названии есть «самовывоз».
- Срочная доставка — в названии есть «срочн».
Если название другое, его один раз дописывают в ЛИМС: Доставка → Названия из магазина. Строка должна совпасть с Тильдой буква в букву. Потом «Сохранить и разобрать заказы».
3. Экран «Подключение сервиса приёма данных Webhook»
- URL-адрес веб-крючка. Настоящий https-адрес Петгена, строка заканчивается на
/api/v1/integrations/tilda/webhook. - Метод API. Оставьте Off, пока в
platform/.envпустая строкаTILDA_WEBHOOK_SECRET. Если секрет там вписан, метод ставят в заголовок: имяX-Tilda-Secret, ключ — тот же секрет. В чат секрет не присылайте. - Посылать Cookies — выключено. Передавать данные по товарам массивом — выключено. Отправлять только после оплаты — включено.
- Сохраните. Тильда сразу пошлёт проверку. Ответ должен прийти за несколько секунд. Ошибка видна в Тильде: Заявки → Журнал ошибок.
4. Корзина и оплата
- На странице магазина откройте блок корзины ST100 → Контент → Приём данных.
- Оставьте галочку вашей CRM. Рядом включите Webhook. Опубликуйте страницу.
- В настройках платёжной системы проверьте галочку «Отправлять данные в сервисы приёма данных только после оплаты». Неоплаченный заказ в Петген не придёт.
Поля корзины лучше не переименовывать. Петген читает стандартные имена Тильды: номер заказа, email, телефон, получатель, сумма, товары, адрес доставки и название доставки.
5. Как проверить
- На опубликованной странице оформите тестовый заказ и оплатите его.
- В ЛИМС откройте Заказы. Строка с номером заказа из Тильды должна быть со статусом «Оплачен».
- Код набора появляется сразу. Он виден в К отправлению.
- Способ доставки виден в К отправлению: СДЭК, самовывоз или срочная. Там отмечают, что коробка ушла со склада. Пока отметки нет, код с коробки нельзя активировать.
Повтор той же оплаты не плодит наборы: тот же номер заказа обновляет уже созданный заказ.
Что делает сотрудник после заказа
- СДЭК. Тильда уже создала отправление. Коробку упаковывают и отдают в СДЭК. В ЛИМС ставят отметку, что коробка ушла.
- Самовывоз. Человек приезжает и забирает. Отметку ставят в этот момент.
- Срочная доставка. Курьер забирает коробку. Отметку ставят, когда он уехал.
Если заказ не появился
- В Тильде в журнале ошибок есть запись — адрес недоступен, нет https или проверка не дождалась ответа.
- Адрес указан как
127.0.0.1илиlocalhost. С серверов Тильды его не видно. - В корзине ST100 не стоит галочка Webhook, или страница не опубликована после галочки.
- Заказ не оплачен, а у платёжной системы включена отправка только после оплаты.
- Секрет в Тильде и в
TILDA_WEBHOOK_SECRETразный. На боевом сервере пустой секрет адрес закрывает. - Заказ есть, а очередь «Способ ещё не выбран» — название доставки не совпало. Допишите его в «Названия из магазина».