Integrazione webhook Binotel

Questo passaggio configura Binotel per inoltrare ogni chiamata terminata a ReceptionIQ per l'analisi. Setup < 10 minuti. Il titolare dell'account Binotel manda un'email al supporto — il testo è pronto qui sotto.

1. URL del webhook

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

Sostituisci <COMPANY_ID> con il companyID rilasciato da Binotel (es. 66827 per Profi Dental).

2. Firma HMAC

• Algoritmo: HMAC-SHA256
• Input: corpo completo della richiesta (raw)
• Codifica: hex (lowercase)
• Header: X-Binotel-Signature
• Segreto condiviso: univoco per tenant, generato alla creazione dell'account

3. Payload evento call_end

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

4. Comportamento dell'endpoint

HTTP	Significato
200	Successo o duplicato (idempotente)
401	Firma non valida
4xx / 5xx	Errore nostro — riprovare

5. Email pronta per Binotel support

Copia il testo sotto e invialo a support@binotel.ua dalla tua email registrata in Binotel.

Oggetto: Attivazione webhook PUSH per companyID 

Buongiorno team Binotel,

vi chiediamo di attivare un webhook PUSH per il nostro account (companyID ) sull'evento di fine chiamata.

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

Grazie.