# Під’єднайте свій канал у HAPP

> Вхідний вебхук плюс вихідний ендпоінт — і будь-яка платформа отримує AI-асистента за 10 хвилин.

- **Інтеграція:** Custom Messenger (Месенджери)
- **Сторінка:** https://happ.tools/uk/integrations/custom-messenger
- **Інструкція з підключення:** https://docs.happ.tools/uk/docs/integrations/webhooks — покрокове підключення, довідник помилок і керування з’єднанням — у документації, а не на цій сторінці.
- **Дія:** [Відкрити HAPP Dashboard](https://my.happ.tools/)

## Ключові можливості

*Можливості*

Усе, що вам і так приносить Custom Messenger, — з відповіддю, оцінкою і в потрібній папці, без менеджера, який стежить за скринькою.

- **Одна скринька, усі гілки** — Маркетплейс, хелпдеск, віджет, який ви написали самі, — усе це звичайні гілки в HAPP.
- **Відповідь менш ніж за секунду** — Асистент читає, вирішує і відповідає — о третій ночі так само охоче, як опівдні.
- **Передавання в один клік** — Менеджер відповідає в HAPP, а ваш ендпоінт доставляє відповідь туди, де є клієнт.
- **Кожна розмова оцінена й розсортована** — Те саме оцінювання, що й у вбудованих каналів, — на каналі, про який HAPP ніколи не чув.
- **Ніщо не чекає до ранку** — Відповідь у будь-яку годину доби, зокрема в ті, на які нікого не поставили в графік.
- **Захист даних** — Шифрування AES-256, відповідність GDPR, резервні копії цілодобово.
- **Завжди на зв’язку** — Без онбордингу й вигорання. Готовий з першого дня, пам’ятає кожну розмову.

## Один асистент, усі канали

*Усе інше*

Це одна з двох десятків інтеграцій. Решта під’єднується так само — без коду і без міграцій.

- **Месенджери** (5 каналів) — Telegram, Viber, Instagram, Facebook, WhatsApp
- **Телефонія** (5 операторів) — Binotel, Ringostat, Phonet, UniTalk, StreamTelecom
- **CRM-системи** (5 інтеграцій) — SalesDrive, keyCRM, NetHunt, Odoo, Google Sheets

А також Altegio, Shifio, Zadarma, Qdrant, Custom Messenger і вебхуки для всього іншого, чим ви користуєтесь.

## Що потрібно для під’єднання

*Перш ніж почати*

Чотири речі — і все з’єднання зводиться до двох HTTP-викликів.

1. **Акаунт HAPP** — Активний акаунт із налаштованим асистентом. Ще немає акаунта? Зареєструйтеся на my.happ.tools.
2. **Вихідний HTTPS-ендпоінт** — URL вашого сервера, куди HAPP надсилатиме POST із відповідями AI. Лише HTTPS — HTTP не підтримується з міркувань безпеки.
3. **Доступ до коду вашої платформи** — Потрібно додати POST-запит на URL вебхука HAPP, коли надходить повідомлення від вашого користувача.
4. **HMAC-секрет (необов’язково)** — HAPP підписує кожен запит через HMAC-SHA256. Перевіряйте підпис на своєму боці — це захист від підроблених запитів.

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

*FAQ*

Відповіді на найчастіші запитання про інтеграцію Custom Messenger.

### Які поля обов’язкові у вхідному запиті?

Обов’язкові: sender_id (унікальний ідентифікатор відправника у вашій системі) і text (текст повідомлення). Необов’язкові: sender_name (відображуване ім’я) і metadata (об’єкт із довільними даними, який HAPP поверне у відповіді).

### Що HAPP надсилає на вихідний ендпоінт?

POST-запит із JSON, що містить to, text, channel_id і metadata. Заголовок X-HAPP-Signature містить HMAC-SHA256-підпис тіла запиту.

### Як перевірити підпис HMAC-SHA256?

Обчисліть HMAC-SHA256 від тіла запиту (сирі байти), використовуючи HMAC-секрет із налаштувань каналу HAPP. Порівняйте hex-результат зі значенням заголовка X-HAPP-Signature. Використовуйте порівняння за сталий час, щоб уникнути атак за таймінгом.

### Скільки каналів можна під’єднати?

Кількість каналів Custom Messenger не обмежена. Кожен канал отримує власний URL вхідного вебхука, HMAC-секрет і може мати власного асистента чи команду операторів.

### Чи підтримуються медіафайли (зображення, файли)?

Так. Передайте у вхідному запиті поле attachments — масив об’єктів із type (image/file/audio) і url. HAPP передає медіа асистенту і зберігає їх у журналі розмови.

### Що буде, якщо мій ендпоінт поверне помилку?

Якщо вихідний ендпоінт повертає HTTP 4xx чи 5xx або не відповідає протягом 10 секунд, HAPP повторює спробу ще 3 рази — через 5, 15 і 60 секунд. Усі невдалі спроби потрапляють у журнал.

### Як протестувати інтеграцію локально?

Скористайтеся ngrok або Cloudflare Tunnel, щоб отримати публічний HTTPS-URL для локального сервера. Після під’єднання натисніть «Надіслати тест» у налаштуваннях каналу HAPP — HAPP надішле справжній запит на ваш ендпоінт.

## Готові під’єднати власний канал?

Два ендпоінти й HMAC-секрет — ваша платформа отримує того самого асистента, що й будь-який рідний канал.

[Відкрити HAPP Dashboard](https://my.happ.tools/)