Вебхуки, API и CRM
Заявки и оплаты в вашу CRM, доступ по API
Агентство›Интеграции связывает OfferUno с вашей CRM: заявки и оплаты приходят туда сами, а подборки можно создавать из своих программ. Раздел видят владелец и администратор на тарифе с API и вебхуками.
Вебхуки — события в CRM
- Укажите адрес (URL), на который отправлять события — его даёт ваша CRM или сервис интеграций.
- Отметьте события: «Новая заявка туриста» (
lead.created), «Турист впервые открыл подборку» (selection.opened), «Турист оплатил тур картой» (payment.succeeded). - Нажмите Отправить проверку — придёт тестовое событие
ping.
Формат — POST-запрос с JSON {event, created_at, agency_id, delivery_id, data}. Подпись запроса — в заголовке X-OfferUno-Signature (HMAC SHA-256 тела запроса с ключом подписи). Сервер должен ответить кодом 2xx за 10 секунд; иначе повторы через 1, 5, 30 минут, 2 и 6 часов. В блоке «Последние отправки» видно, что доставлено.
Ключи API
Ключ даёт доступ к подборкам, вариантам, заявкам и клиентам вашего агентства. Введите название (например, «amoCRM») и нажмите Создать ключ. Ключ показывается один раз — сразу скопируйте его. Можно иметь до 10 ключей; ненужный — Отозвать.
Методы и примеры — в документации API.
Ключ — как пароль от данных агентства. Не публикуйте его и отзовите, если он мог попасть к посторонним.
