PochutСпробувати безкоштовноСпробувати

API і вебхуки: звʼязок Pochuto з вашою CRM

Оновлено 18 листопада 2026≈ 11 хв

Щоб CRM сама створювала персональне посилання після візиту і одразу дізнавалася про скаргу клієнта, їй потрібні ключ API і вебхук. Обидва налаштовуються в кабінеті, у розділі профілю "API і вебхуки", і доступні на тарифі Business

Що це і кому потрібно

API - це спосіб, яким ваша CRM, облікова система або власний сервіс звертається до Pochuto без вашої участі: створює персональне посилання, читає статистику чи скарги. Вебхук працює у зворотний бік: коли в Pochuto щось відбувається, ми самі надсилаємо подію на адресу вашого сервера

Типовий приклад: адміністратор закрив візит у CRM, CRM створила персональне посилання і відправила його клієнтові. Якщо клієнт лишив скаргу, вебхук одразу створює тікет у вашій системі. Налаштувати інтеграцію зазвичай допомагає розробник або підрядник: ця сторінка для власника, а технічний опис методів - у документації для розробника

Не пропонуйте клієнтам винагороду за відгук, ні вручну, ні через інтеграцію. Правила Google забороняють платні й заохочені відгуки, а профіль, який їх збирає, можуть обмежити

На яких тарифах працює

  • Business - усе без обмежень пробного періоду: ключі й вебхуки працюють повністю
  • Пробний період - працює повністю, але з обмеженнями для перевірки інтеграції: до 2 ключів, до 2 вебхуків, 100 доставок вебхуків на добу, 20 запитів на хвилину на читання і 5 на запис. Після оплати Business обмеження зникають
  • Після закінчення Business - 14 днів ключі працюють лише на читання, потім API відповідає помилкою. Вебхуки одразу перестають надсилатися, нові події (і ще не надіслані) лишаються в журналі з позначкою "Доступ закінчився"
  • Start - API і вебхуків немає. У розділі кабінету буде пропозиція перейти на Business

Якщо оплата Business не пройшла, ключі продовжують читати дані, але змінювати їх не можуть, доки оплату не оновлено. Вебхуки при цьому надсилаються як зазвичай. Про оплату - у розділі про тарифи

Ключі API

Ключі створюються в кабінеті: Профіль → "API і вебхуки" (адреса /profile/api), картка "Ключі API". Кнопка "Створити ключ" просить назву (наприклад, назву вашої CRM), доступ і, за бажання, локацію

Розділ "API і вебхуки" в кабінеті Pochuto: картка "Ключі API" з двома ключами (початок ключа, права, локація, останнє використання) і картка "Вебхуки" з однією адресою
Кабінет, листопад 2026

Ключ показується один раз, одразу після створення. Скопіюйте його в налаштування CRM до закриття вікна: потім у списку лишаються тільки початок ключа, дата створення і дата останнього використання. Загубили - створіть новий і відкличте старий

Доступ до певних даних

Ключ отримує лише ті права, які ви обрали, і не більше. Спробує зробити зайве - отримає відмову. Нижче - що означає кожне право

  • Локації і статистика - бачити ваші локації, сторінки відгуків, місця розміщення, співробітників і цифри воронки за період
  • Посилання: перегляд і Посилання: створення - шукати персональні посилання і створювати нові або вимикати існуючі
  • Скарги: перегляд і Скарги: зміна статусу - читати скарги з форми й позначати їх опрацьованими
  • Відгуки Google: перегляд і Відгуки Google: відповідь - читати публічні відгуки з підключеного профілю Google і публікувати відповіді на них. Відповідь - окреме право: без нього ключ лише читає
  • Підписки на вебхуки (webhooks:manage) - створювати й видаляти вебхуки самим ключем, без кабінету: так працюють інтеграційні платформи на кшталт Zapier і Make. Деталі - в розділі про вебхуки нижче
Вікно "Новий ключ API" в кабінеті Pochuto: назва ключа і список прав з галочками, внизу перемикач передачі імені й телефону клієнта
Кабінет, листопад 2026

Один заклад або весь акаунт

За замовчуванням ключ бачить усі локації акаунта. Якщо обрати одну локацію, ключ працюватиме тільки з її даними: чужі локації для нього наче не існують. Для мережі зручно випустити окремий ключ на кожну точку. Привʼязку до локації після створення змінити не можна

Імʼя і телефон клієнтів

Імʼя і телефон клієнта ключ отримує лише з окремою опцією "Передавати ім'я і телефон клієнта". Увімкнути її можна тільки після підтвердження: система з таким ключем зможе зберігати й передавати далі контакти ваших клієнтів, і відповідальність за неї на вас. Без цієї опції імен і телефонів у відповідях немає, а пошук скарг чи посилань за імʼям або телефоном відхиляється

Назву, права й доступ до контактів можна змінити пізніше, у налаштуваннях ключа: сам ключ лишається тим самим, а зміни діють з наступного запиту. Хоча б одне право має лишитися

Відкликання

"Відкликати ключ" в налаштуваннях ключа вимикає його одразу і назавжди: система, що ним користується, перестане працювати. Скасувати відкликання не можна, потрібен новий ключ. Ключами керує лише власник в кабінеті; сам ключ не може створити чи відкликати інший ключ

Що можна робити через API

  • Локації та сторінки - читати перелік закладів, сторінок відгуків, місць розміщення й співробітників; сам список співробітників змінити через API не можна
  • Статистика - ті самі цифри воронки, що у розділі "Статистика": перегляди, вибір оцінки, перехід на Google, відправлені скарги. Окремих клієнтів у статистиці немає
  • Персональні посилання - створити посилання з імʼям клієнта, співробітником і вашим внутрішнім id, знайти за id чи статусом, вимкнути. Повторний запит із тим самим ключем ідемпотентності не створює другого посилання, а сам ключ діє 24 години. Посилання з API веде клієнта тим самим шляхом, що й створене в кабінеті
  • Скарги - читати скарги з форми і змінювати статус "опрацьовано" або "нова". Статус збігається з тим, що ви бачите у відгуках, а реакція в Telegram ставиться так само, як і з кабінету
  • Відгуки Google - читати відгуки підключеного профілю Google і публікувати відповідь (до 4096 байт). Імені й фото автора Google у відповідях немає. Без підключеного профілю відгуків немає, тож список порожній. Помилку "Google не підключено" побачите, лише якщо відповідаєте на вже імпортований відгук, а профіль потім відключили

Ліміти для звичайного Business - 120 запитів на хвилину на читання і 30 на запис на кожен ключ; ключі одного акаунта не заважають одне одному. Тарифи, оплату і керування підпискою ці методи не зачіпають

Вебхуки

Вебхук - це адреса вашого сервера, на яку Pochuto надсилає подію. Налаштовується в тому ж розділі профілю, у картці "Вебхуки", кнопкою "Додати вебхук"

Які події приходять

  • Нова скарга - клієнт надіслав приватну форму. Сюди ж потрапляє скарга клієнта, який вибрав "все одно в Google", якщо він залишив текст або телефон
  • Персональне посилання використано - клієнт скористався одноразовим посиланням: надіслав скаргу або перейшов на Google. Саме відкриття сторінки подією не вважається. Подія надходить один раз
  • Новий відгук Google - імпорт знайшов новий публічний відгук локації. Перший імпорт відгуків локації подій не створює, як і сповіщення в Telegram. Імені й фото автора в тілі немає

Події з воронки (перегляди сторінки, вибір оцінки) у вебхуки не входять: їх можна читати через API у статистиці

Як додати адресу

Вкажіть адресу сервера і оберіть події, хоча б одну. Адреса має бути https і доступною з інтернету: без логіна й пароля в адресі, на порту 443 (інший порт кабінет відхилить). Адреси у приватній мережі не приймаються, а відповідь-перенаправлення вважається невдалою доставкою

Вікно "Налаштування вебхука" в кабінеті Pochuto: адреса сервера, вибір подій, перемикач передачі імені й телефону клієнта і кнопки "Видалити", "Вимкнути", "Зберегти"
Кабінет, листопад 2026

Секрет підпису показується один раз, після додавання вебхука. Ним ваш сервер перевіряє, що подію надіслав саме Pochuto. Збережіть його в налаштуваннях сервера: якщо не скопіювали, вебхук доведеться видалити і додати знову. Як перевірити підпис, описано в документації для розробника

Імʼя і телефон в подіях

За замовчуванням у події немає контактів клієнта. Передача імені й телефону вмикається окремо для кожного вебхука і потребує підтвердження, як і в ключі. Якщо ви змінюєте адресу сервера на інший хост, згоду знімаємо: контакти не надсилатимуться, доки ви не підтвердите дозвіл для нової адреси. Вимкнули опцію - наступні події йдуть уже без контактів

Затримка, повтори і журнал

Подія зазвичай доходить протягом хвилини. Якщо сервер не відповів успіхом (2xx) протягом 10 секунд, ми повторюємо доставку з наростаючою паузою, усього до 8 спроб за добу. Після останньої невдалої спроби подія помічена як недоставлена

Усе видно в "Журналі доставок" вебхука (кнопка в налаштуваннях): подія, відповідь вашого сервера, час, кількість спроб і стан. Записи зберігаються 30 днів. Недоставлену подію можна надіслати ще раз кнопкою "Надіслати ще раз". Тіл подій і секретів у журналі немає

Журнал доставок вебхука в кабінеті Pochuto: два записи зі станом "Доставлено" і один "Не доставлено" після 8 спроб, біля нього кнопка повторної відправки
Кабінет, листопад 2026

Події, пропущені під час збою, самі не надсилаються: після того як ви виправили сервер, надішліть їх із журналу вручну

Підписка вебхука ключем

Інтеграційні платформи (Zapier, Make) створюють і видаляють вебхуки самі, ключем із правом Підписки на вебхуки (webhooks:manage). Запит POST /public/v1/webhooks з адресою (url) і списком подій (events, хоча б одна) повертає 201 і поля id, url, events, secret, createdAt. Секрет підпису показується один раз, у цій відповіді: пізніше його не отримати, окрім повтору з тим самим Idempotency-Key (нижче). Адреса перевіряється за тими самими правилами, що й у кабінеті

  • Контактів клієнтів у такій підписці немає. Поле згоди на передачу імені й телефону в запиті - зайве, API відповідає 400. Згоду вмикаєте ви в кабінеті, з підтвердженням: до того події йдуть без контактів
  • Ключ, привʼязаний до локації, отримує події тільки цієї локації
  • Видалення - DELETE /public/v1/webhooks/{id}, відповідь 204; повторний запит теж 204. Підписка з кабінету, з іншого ключа чи з іншого акаунта, як і неіснуючий номер, дає 404 і не видаляється
  • Ключ без цього права отримує 403
  • Повтор запиту. Заголовок Idempotency-Key необовʼязковий. Якщо ключ із тим самим Idempotency-Key повторить запит з тим самим тілом протягом 24 годин (платформа повторює запит після збою мережі), API поверне ту саму підписку з тим самим секретом (201) і не займе ліміт. Те саме значення з іншим тілом дає 409 з кодом idempotency_conflict. Значення Idempotency-Key спільне зі створенням персональних посилань тим самим ключем API. Якщо підписку за цей час видалили, повтор створить нову
  • Ліміт - до 10 підписок, створених ключами, на пробному періоді і до 50 на платному тарифі. Понад ліміт API відповідає 403 з кодом plan_limit_reached і полем limit. Видалена підписка звільняє місце. Вебхуки, додані в кабінеті, в цей ліміт не входять, а підписки ключів не займають 2 вебхуки пробного періоду
  • Відкликання ключа видаляє його підписки: події на них більше не надходять, у кабінеті вони зникають. Вебхуки з кабінету й інших ключів це не зачіпає

Автоматичне вимкнення

Якщо 3 доби поспіль усі доставки вебхука невдалі, ми його вимикаємо і надсилаємо вам лист. У кабінеті вебхук показано як вимкнений, з кнопкою "Увімкнути". Увімкніть його, коли сервер знову приймає запити. На пробному періоді доставки понад добовий ліміт не надсилаються, у журналі вони з позначкою "Ліміт тарифу"

Вебхук можна змінити (адресу, події, згоду на контакти) або видалити. Секрет при зміні лишається тим самим; при видаленні журнал доставок стирається

Документація для розробника

Технічний опис усіх методів, кодів помилок, лімітів і перевірки підпису вебхука з прикладом - на окремому сайті: developers.pochuto.com. Передайте посилання тому, хто підключає CRM. Ключ і секрет підпису передавайте окремо від листування і не публікуйте

Якщо акаунт видалено, у вікні відновлення ключі не працюють, а вебхуки мовчать; після відновлення ключі й вебхуки знову працюють, але події за цей час не надсилаються. Видалення вимикає автопродовження Business, а відновлення його не вмикає: після відновлення увімкніть автопродовження на екрані підписки (кнопка "Відновити підписку"), інакше після закінчення оплаченого періоду API перейде в режим лише читання. Остаточне видалення стирає ключі й вебхуки

Часті питання

Чи потрібен розробник, щоб користуватися API?
Для готової інтеграції - зазвичай так: CRM чи сервіс має вміти звертатися до API. Ви самі створюєте ключ і вебхук в кабінеті, а розробник чи підрядник вставляє їх у налаштування і підключає перевірку підпису
Що робити, якщо ключ потрапив не в ті руки?
Відкличте його в налаштуваннях ключа: він перестане працювати одразу. Потім створіть новий ключ для своєї системи
Чому CRM не бачить імен клієнтів?
Контакти клієнтів ключ чи вебхук отримують лише з окремою згодою, яку власник вмикає з підтвердженням. Перевірте опцію "Передавати ім'я і телефон клієнта" в налаштуваннях ключа або вебхука
Чому вебхук вимкнувся?
Три доби поспіль сервер не приймав жодної події. Виправте його, увімкніть вебхук у кабінеті і надішліть пропущені події з журналу доставок