# Binotel

Connect Binotel so calls flow into Happ with transcription, AI scoring and analytics

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Binotel is the one provider that doesn't hand out API credentials from its admin panel — you request them by email. Binotel support sends you a Key and Secret, you connect them in Happ, and then send Binotel the webhook URL Happ shows on the integration card. Usually within a day.

## Before you start [#before-you-start]

* **Active Binotel account** with provisioned numbers and admin rights — Binotel only acts on requests from account owners.
* **Access to your work mailbox** — the same address you normally use with Binotel. They send credentials only to the account owner.
* **Happ account on a plan that includes voice analytics.** One account covers any number of phone lines.

## Get your credentials [#get-your-credentials]

Email **[support@binotel.ua](mailto:support@binotel.ua)** and ask for an **API Key** and **API Secret** for your account.

## Connect [#connect]

| Field      | Value                                |
| ---------- | ------------------------------------ |
| API Key    | The key Binotel support sends you    |
| API Secret | The secret Binotel support sends you |

1. **Integrations** > **Add Integration** > **Binotel**.
2. Paste the **API Key**, then the **API Secret**, and click **Connect**.
3. Open the connected Binotel card and copy its **webhook URL**.
4. Send that URL to [support@binotel.ua](mailto:support@binotel.ua) and ask them to point the call webhook at it.

Add the client's phone number separately under **Phones** — see [Phone & SIP Setup](/docs/agents/phones).

## How you'll know it's connected [#how-youll-know-its-connected]

The integration card shows a green **Connected** pill, and calls start reaching Happ straight away — with transcription, AI scoring and Voice AI available on them.

## Disconnect and reconnect [#disconnect-and-reconnect]

**To disconnect:** open **Integrations** > **Binotel**, click **…** next to the integration card and choose **Remove**. Optionally email [support@binotel.ua](mailto:support@binotel.ua) asking them to deactivate the webhook on their side.

After disconnecting:

* New Binotel calls stop reaching Happ.
* All past calls, transcripts and AI scores stay in Happ.
* The webhook on the Binotel side may still be active — request deactivation by email if you want it off.
* The API Key and Secret stay valid in Binotel. Ask support to revoke them if needed.

**To reconnect:** open **Integrations** > **Binotel** > **Connect**, paste the saved Key and Secret (or request new ones from support), then attach the integration to the assistant again.

Preserved after reconnecting: integration settings (call direction, who answers, scoring rubric), the assistant binding and its prompt, and all past transcripts, scores and dashboards. If the webhook was deactivated, ask Binotel to turn it back on.

## Next [#next]

* [Telephony Providers](/docs/integrations/telephony) — all supported providers
* [Phone & SIP Setup](/docs/agents/phones) — connect the number
* [Voice Assistant](/docs/agents/voice) — overview and settings