Доставка заявок у вашу CRM чи пошту

Для розробників, у коді: надсилання кожного контакту, який лишив відвідувач, на ваш власний сервер — POST-інструмент як точка доставки, плейсхолдери {{handoff.*}}, що записується і що показує демо-скринька.

Коли відвідувач лишає контакт — через форму в чаті або попросивши людину, — заявка зберігається на екрані «Заявки» панелі й надсилається на адресу підтримки сайту. Доставка додає третє призначення: ваш власний сервер — CRM, службу підтримки, таблицю, — викликаний у момент, коли заявка з’явилася.

Доставка входить у тариф Growth і вищі.

У панелі: Агент → Ескалація → Надсилати звернення у вашу систему (Агент).

Налаштування

Створіть власний інструмент із методом POST, URL вашого сервера, вашим токеном як секретом у заголовку і шаблоном тіла з полями заявки:

POST https://crm.example.com/leads
Authorization: Token {{secret.crm}}
Content-Type: application/json

{ "email": "{{handoff.contact}}", "kind": "{{handoff.contact_kind}}",
  "question": "{{handoff.question}}", "comment": "{{handoff.comment}}",
  "page": "{{handoff.page}}", "language": "{{handoff.language}}",
  "source": "{{handoff.source}}", "ref": "{{handoff.ref}}", "id": "{{handoff.id}}" }

На картці Ескалація помічника оберіть його в Надсилати кожну заявку у вашу систему.

Інструмент вилучається з інструментів моделі: доставка — справа системи на шляху передачі, а не рішення помічника в розмові.

Плейсхолдери

Плейсхолдер	Значення
`{{handoff.contact}}`	контакт, який лишив відвідувач, розшифрований для цього виклику
`{{handoff.contact_kind}}`	`email` або `phone`, визначено автоматично
`{{handoff.question}}`	питання, що призвело до заявки
`{{handoff.comment}}`	коментар відвідувача, якщо був
`{{handoff.page}}`	сторінка, на якій зроблено заявку
`{{handoff.language}}`	мова розмови
`{{handoff.source}}`	`agent` (помічник здався), `asked` (відвідувач попросив), `menu` (кнопка «Зв’язатися з нами»)
`{{handoff.ref}}`	посилання, яке можна процитувати у відповідь; ніколи не id розмови
`{{handoff.id}}`	id заявки в панелі

Percent-кодуються, коли потрапляють в URL; сирими в заголовках і тілі; керівні символи вилучаються. {{user}} і {{screen.*}} на цьому шляху порожні — заявка може прийти набагато пізніше за розмову. Один прохід підстановки: коментар відвідувача ніколи не розгорнеться у ваш секрет.

Як іде виклик

У фоні, у власній сесії, після того, як відвідувачу вже відповіли, — ваш сервер може взяти всі десять секунд, і ніхто не чекає. Без кешу, без повторів. Та сама політика вихідних з’єднань, що й у кожного інструмента: https, публічний хост, без редиректів.

Що записується

`delivery_status`	Коли
`off`	інструмент доставки не задано — майже кожна заявка
`sent`	ваш сервер відповів 2xx
`failed`	усе інше: політика відхилила хост, виклик вийшов за таймаут, статус не 2xx, інструмент вимкнений чи належить іншому сайту, тариф не включає доставку

Короткий delivery_error називає причину — статус, ніколи не тіло вашої відповіді. Екран «Заявки» показує попередження на невдалому рядку, і контакт усе одно там: замінений токен перетворює кожну заявку на мовчазний 401 з вашого боку, і саме це робить його видимим.

Спробуйте

Рантайм постачає макет скриньки саме для цього: POST /_demo/leads приймає заявку з bearer-токеном і відповідає 401 без нього, а GET /_demo/leads читає їх назад. За замовчуванням вимкнено (DEMO_ENDPOINTS_ENABLED), бо там справжні заявки з відкритими контактами; на dev-стеку manage.py seed_handoff_demo під’єднує до нього інструмент lead_delivery, щоб можна було побачити обидва шляхи — sent і failed.