Інтеграція Binotel webhook

Цей крок налаштовує Binotel надсилати кожен завершений дзвінок до ReceptionIQ для аналізу. Час налаштування < 10 хвилин. Власник Binotel-акаунта має написати листа в підтримку — нижче готовий текст.

1. URL webhook

https://binotel.aiagens.ch/webhooks/binotel/call-end?company=<COMPANY_ID>

Замініть <COMPANY_ID> на ваш companyID, отриманий від Binotel (наприклад 66827 для Profi Dental).

2. HMAC підпис

• Алгоритм: HMAC-SHA256
• Вхід: повне тіло запиту (raw body)
• Кодування: hex (lowercase)
• Заголовок: X-Binotel-Signature
• Спільний секрет: унікальний для кожного тенанта, видається при створенні акаунта

3. Подія call_end — формат тіла

{
  "generalCallID": "1.1234567",
  "callType": "incoming",
  "startTime": 1714377600,
  "billsec": 245,
  "externalNumber": "+380501234567",
  "internalNumber": "+380441234567",
  "callRecord": "https://rec.binotel.com/r/abc123.mp3"
}

4. Поведінка endpoint

HTTP	Значення
200	Успіх або дублікат (ідемпотентно)
401	Некоректний підпис
4xx / 5xx	Помилка нашого боку — повторіть

5. Готовий лист до Binotel support

Скопіюйте текст нижче і надішліть на support@binotel.ua з вашої зареєстрованої в Binotel пошти.

Тема: Активація PUSH webhook для companyID <ВАШ_ID>

Доброго дня, шановна команда Binotel.

Просимо налаштувати PUSH webhook для нашого акаунта (companyID <ВАШ_ID>) для подій завершених дзвінків.

URL: https://binotel.aiagens.ch/webhooks/binotel/call-end?company=<ВАШ_ID>
Алгоритм: HMAC-SHA256 (raw body, hex, заголовок X-Binotel-Signature)
Спільний секрет: <з кабінету ReceptionIQ>

Дякуємо.