> For the complete documentation index, see [llms.txt](https://docs.allmcp.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.allmcp.co/documentation/providers/binotel.md).
# Binotel
Binotel is the dominant cloud-PBX in Ukrainian sales organizations. AllMCP gives your agent 31 tools for call analysis, recordings, employee management, and outbound dialing.
All providersHow connecting works
***
## Connect
Binotel authenticates with a **key + secret** pair tied to your cabinet (company account).
{% hint style="warning" icon="key" %}
Binotel API credentials are **not self-service**. The cabinet owner must email `support@binotel.ua` to request them. Use the subject line `Получение авторизационных данных для REST API`. Turnaround is about one business day.
{% endhint %}
{% stepper %}
{% step %}
#### Request your REST API credentials
Have the cabinet owner email `support@binotel.ua` with the subject line `Получение авторизационных данных для REST API`. Turnaround is about one business day. You will receive a **key** and a **secret**.
{% endstep %}
{% step %}
#### Ask your agent to connect Binotel
Tell your agent to connect Binotel and give it the two values you received:
* **key** — your Binotel REST API key
* **secret** — your Binotel REST API secret
{% endstep %}
{% step %}
#### Connect per user
Each AllMCP user who needs Binotel connects with their own key + secret pair.
{% endstep %}
{% endstepper %}
***
## Tools by category
Binotel's tools are grouped into five categories: Calls, Stats, Employees, Customers, and Outbound. Your agent can browse what is available and use any tool once Binotel is connected.
{% tabs %}
{% tab title="Calls" %}
Point lookups, recording URLs, and live call status.
| Tool | What it does |
| ---------------------------------- | ----------------------------------------------------------------------- |
| `binotel_get_calls` | Fetches one or more calls by their internal call IDs. |
| `binotel_search_calls_by_phone` | Finds calls associated with a given phone number. |
| `binotel_search_calls_by_customer` | Finds all calls linked to a specific customer. |
| `binotel_get_recording_url` | Returns a downloadable URL for a call recording (valid for 15 minutes). |
| `binotel_list_online_calls` | Lists all calls that are currently in progress. |
| `binotel_list_lost_calls_today` | Lists today's unanswered (missed) calls. |
| {% endtab %} | |
{% tab title="Stats" %}
Call history and period-based statistics.
| Tool | What it does |
| ---------------------------------------- | ------------------------------------------------------------------------------ |
| `binotel_list_calls_for_employee` | Returns a single employee's call history over a window of up to 7 days. |
| `binotel_list_calls_for_period` | Returns calls in a time period, filtered to all, incoming, or outgoing. |
| `binotel_list_calls_per_day` | Lists every call for a single day in the cabinet's local timezone. |
| `binotel_list_calls_since` | Returns calls that occurred after a given timestamp, for polling new activity. |
| `binotel_list_recent_calls_for_employee` | Returns an employee's most recent calls (about the last 50, within 14 days). |
| `binotel_list_calltracking_for_period` | Returns call-tracking records for a given period. |
| {% endtab %} | |
{% tab title="Employees" %}
Extension directory, call routing, voice files, and presence.
| Tool | What it does |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `binotel_list_employees` | Lists every employee in the cabinet with their name, email, extensions, and presence; run this first to find the extensions other tools need. |
| `binotel_list_routes` | Lists the call-routing rules configured in the cabinet. |
| `binotel_list_voice_files` | Lists the voice files (announcements and IVR prompts) uploaded to the cabinet. |
| `binotel_change_employee_presence_state` | Updates an employee's presence (availability) state. |
| {% endtab %} | |
{% tab title="Customers" %}
Binotel's built-in mini-CRM for managing customer records and labels.
| Tool | What it does |
| --------------------------------- | ------------------------------------------------------------- |
| `binotel_list_customers` | Lists customer records stored in Binotel's mini-CRM. |
| `binotel_get_customers` | Fetches one or more customers by their ID. |
| `binotel_search_customers` | Searches customer records by name or phone number fragment. |
| `binotel_list_customers_by_label` | Lists all customers tagged with a specific label. |
| `binotel_create_customer` | Creates a new customer record. |
| `binotel_update_customer` | Updates the details of an existing customer. |
| `binotel_delete_customers` | Deletes one or more customer records (this cannot be undone). |
| `binotel_list_customer_labels` | Lists the cabinet's set of customer labels (tags). |
| {% endtab %} | |
{% tab title="Outbound" %}
Click-to-call, transfer, hangup, IVR, and announcements.
| Tool | What it does |
| -------------------------------------------- | ------------------------------------------------------------------------------------ |
| `binotel_initiate_internal_to_external` | Places a click-to-call from an employee's internal extension to an external number. |
| `binotel_initiate_external_to_external` | Connects two external numbers together through the cabinet's phone line. |
| `binotel_initiate_external_to_incoming_call` | Dials an external number and routes the answered call into the incoming-call flow. |
| `binotel_hangup_call` | Ends a call that is currently in progress. |
| `binotel_transfer_call` | Transfers an active call to another external number. |
| `binotel_call_with_announcement` | Dials an external number and plays a pre-recorded announcement when answered. |
| `binotel_call_with_ivr` | Dials an external number and presents an interactive voice menu (IVR) when answered. |
{% hint style="warning" icon="phone" %}
Outbound dialing tools require an explicit confirmation before they run, so a call is never placed by accident.
{% endhint %}
{% endtab %}
{% endtabs %}
***
## Common workflows
{% tabs %}
{% tab title="Call analysis" %}
A typical call-review flow:
1. List employees to get their extension numbers.
2. Pull a chosen employee's call history for the last 7 days.
3. Get the recording URL for any calls worth listening to.
{% endtab %}
{% tab title="Daily lost calls" %}
Ask your agent to list today's unanswered calls and group them by employee.
{% endtab %}
{% tab title="Outbound campaign" %}
Ask your agent to place a call from a given extension to a customer's number. It will confirm before dialing.
{% endtab %}
{% endtabs %}
***
## Notes
{% hint style="warning" icon="circle-question" %}
**Limits and expiry to keep in mind.**
* Recording URLs expire after **15 minutes** — download or use them promptly.
* Listing calls for a period with direction set to all is capped at **24 hours** per request.
* Listing calls for an employee is capped at **7 days** per request.
* A period list returns at most **2,000 records** per request.
{% endhint %}
***
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.allmcp.co/documentation/providers/binotel.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.