> For the complete documentation index, see [llms.txt](https://docs.jedidesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.jedidesk.com/znaiomstvo/api-integraciya-jedidesk.md). # API-інтеграція JediDesk Підключіть JediDesk до вашої системи через REST API та отримуйте події в реальному часі через Webhooks. *** ### Для чого потрібна API-інтеграція API дозволяє вашій системі (сайту, CRM, ERP, мобільному додатку) автоматично взаємодіяти з JediDesk: * Синхронізація клієнтів — передача даних між системами * Управління замовленнями — створення, оновлення та відстеження * Робота з діалогами — створення чатів і відправка повідомлень * AI-запити — використання AI JediDesk у вашому продукті * Оновлення каталогу — масове оновлення цін і наявності * Реакція на події — отримання сповіщень через Webhooks *** ### Як підключити API 1. Перейдіть у розділ Інтеграції → API в кабінеті JediDesk 2. Натисніть «Згенерувати API-токен» 3. Скопіюйте токен — він використовується для всіх запитів *** ### Аутентифікація Кожен API-запит повинен містити заголовок: ``` Authorization: Bearer ВАШ_ТОКЕН ``` Якщо токен відсутній або неправильний — API поверне помилку 401 Unauthorized. *** ### Базова інформація Base URL: ``` https://app.jedidesk.com/api/v1 ``` *** ### Основні можливості API **Клієнти**\ Отримання, пошук і оновлення даних (телефон, email, теги, кастомні поля) **Замовлення**\ Створення, оновлення та видалення замовлень **Діалоги**\ Перегляд, створення та отримання історії чатів **Повідомлення**\ Відправка повідомлень у діалоги **AI**\ Запити до AI-асистента на основі бази знань **Товари**\ Масове оновлення цін і залишків Документація:\ *** ### Webhooks Webhooks — це автоматичні HTTP-сповіщення про події. *** #### Як налаштувати Webhook 1. Перейдіть у Інтеграції → API 2. У блоці Webhooks натисніть «Додати webhook» 3. Вкажіть URL вашого сервера 4. Оберіть події 5. Збережіть Можна створювати кілька webhook-ів для різних задач. *** ### Події Webhook #### Клієнти customer.created — створено нового клієнта\ customer.updated — оновлено дані клієнта\ customer.deleted — клієнта видалено *** #### Діалоги chat.created — створено діалог\ chat.updated — оновлено діалог\ chat.deleted — діалог видалено *** #### Повідомлення message.created — нове повідомлення\ message.updated — повідомлення змінено\ message.deleted — повідомлення видалено *** #### AI ai.func\_call — AI викликав функцію *** ### Формат Webhook-запиту JediDesk надсилає POST-запит з JSON: ``` { "event": "message.created", "data": {}, "timestamp": "2024-03-15T10:00:00Z", "token": "ваш_api_токен", "request_id": "унікальний_id" } ``` *** ### Логування Усі webhook-запити зберігаються в логах: * подія * тіло запиту * статус відповіді * відповідь сервера Доступно в розділі Інтеграції → API. *** ### Типові сценарії використання Інтернет-магазин\ Передача замовлень у JediDesk та автоматичні повідомлення клієнтам CRM-система\ Синхронізація клієнтів і створення лідів через webhook Мобільний додаток\ Інтеграція AI-асистента у чат додатку Автоматизація\ Використання ai.func\_call для запуску бізнес-логіки --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.jedidesk.com/znaiomstvo/api-integraciya-jedidesk.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.