Skip to content
Aelo Docs

Connecting IP Telephony

Aelo ingests completed calls from Ukrainian IP-telephony providers via webhook, and historical calls via CDR backfill. Three verified providers are supported: Unitalk, Binotel, Stream Telecom.

General flow

Section titled “General flow”
  1. Under Sources → Telephony, pick a provider and enter its credentials.
  2. Copy the issued webhookUrl into the provider’s settings.
  3. Click Test connection — Aelo calls the provider’s CDR API.

Unitalk

Section titled “Unitalk”
  • Credentials: project API key (sent in the Authorization header).
  • Setup: after saving, Aelo generates a webhook secret. Paste it into the Authorization header of the Unitalk event handler — otherwise every webhook is rejected.
  • Timezone: Unitalk timestamps have no offset; defaults to Europe/Kyiv (editable in the form).
  • Event: CALL_END. The recording becomes available after ~10–15 min (Aelo waits for it).

Binotel

Section titled “Binotel”
  • Credentials: key + secret (issued by support@binotel.ua, bound to your IP).
  • Event: apiCallCompleted (form-urlencoded). The webhook carries no recording URL — Aelo fetches it on demand right before download (the link lives ~15 min).
  • IP allowlist: Binotel’s public IPs are allowed by default.
  • Aelo always responds 200 to avoid provider re-deliveries.

Stream Telecom

Section titled “Stream Telecom”
  • Credentials: username + password + api_key (Administration → Company Profile → API KEY). Not a Bearer token.
  • Webhook: an event stream; the terminal event is Hangup with a synchronous recordUrl. Configured by emailing support@streamtele.com.
  • CDR backfill: window ≤30 days.