Binotel webhook integration

This step lets Binotel push every completed call into ReceptionIQ for analysis. Setup takes < 10 minutes. The Binotel account owner sends one email to their support — the exact text is ready below.

1. Webhook URL

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

Replace <COMPANY_ID> with the companyID Binotel issued you (e.g. 66827 for Profi Dental).

2. HMAC signature

• Algorithm: HMAC-SHA256
• Input: entire request body (raw bytes)
• Encoding: hex (lowercase)
• Header: X-Binotel-Signature
• Shared secret: unique per tenant, issued when you create your account

3. call_end event payload

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

4. Endpoint behaviour

HTTP	Meaning
200	Success or duplicate (idempotent)
401	Invalid signature
4xx / 5xx	Our error — retry safely

5. Ready-to-send email to Binotel support

Copy the text below and send it to support@binotel.ua from your Binotel-registered email.

Subject: Activate PUSH webhook for companyID 

Hello Binotel team,

Please activate a PUSH webhook for our account (companyID ) on call_end events.

URL: https://binotel.aiagens.ch/webhooks/binotel/call-end?company=
Algorithm: HMAC-SHA256 (raw body, hex, header X-Binotel-Signature)
Shared secret: 

Thank you.