> For the complete documentation index, see [llms.txt](https://docs.mikopbx.com/mikopbx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mikopbx.com/mikopbx/modules/miko/integraciya-s-megapbx-ot-megafon.md).
# Интеграция с Megapbx от Мегафон
Модуль загружает историю звонков и записи разговоров из MegaPBX и может передавать события звонков в 1С в реальном времени.
Стандартный раздел **Телефония → История вызовов** после включения интеграции будет содержать историю звонков из MegaPBX. Для отвеченных звонков будут доступны записи разговоров.
### Кому будет полезно?
Если есть разъездные сотрудники, кому удобнее использовать мобильные телефоны и не требуется интеграция с 1С - в этом случае руководитель получит доступ к истории звонков и записям разговоров сотрудника в АТС и в 1С.
### Настройки модуля
Настройки модуля
* **Ключ для авторизации API** — ключ для загрузки истории звонков и записей разговоров. Инструкции по его получению приведены на сайте [api.megapbx.ru](https://api.megapbx.ru).
* **Адрес АТС Мегафон** — адрес ВАТС без указания протокола, например `example.megapbx.ru`.
* **Сдвиг времени** — позволяет скорректировать время звонков на указанное количество часов, например `+3`.
* **Какой номер отображать в истории** — определяет, какой номер сотрудника будет показан в истории вызовов: внутренний или мобильный.
* **CRM-токен (из ЛК ВАТС МегаФон, для приёма событий звонков)** — токен для проверки входящих событий от ВАТС. Он должен совпадать с CRM-токеном в личном кабинете ВАТС МегаФон.
* **Сопоставление сотрудников ВАТС с пользователями 1С** — определяет способ поиска пользователя 1С: по внутреннему номеру, по мобильному номеру либо сначала по внутреннему и, при отсутствии совпадения, по мобильному.
* **Перекодировать загруженные записи в 32 kbps** — преобразует MP3-файлы ВАТС из 16 kbps в формат, совместимый с сервисом распознавания речи. Размер записи при этом увеличивается примерно вдвое.
* **Исключённые номера (не импортировать)** — звонки с участием любого указанного номера не попадут в историю MikoPBX. Указывайте по одному номеру в строке; также поддерживаются запятые и точки с запятой. Формат произвольный: сравнение выполняется по последним 10 цифрам, поэтому `79194071111`, `+7 919 407-11-11` и `8 (919) 407-11-11` считаются одним номером.
В разделе **Конфликты сопоставления в 1С** проверьте, не указан ли один внутренний или мобильный номер у нескольких пользователей. События для таких номеров не будут отправлены в 1С, пока конфликт не будет устранён.
После заполнения параметров нажмите **Сохранить**.
### Интеграция с 1С
* [Расширенный журнал звонков 1.0](https://wiki.miko.ru/astpanel:statistic) - журнал будет загружать историю звонков MegaPBX автоматически, дополнительных настроек не потребуется
* [Панель телефонии 4.0](https://docs.telefon1c.ru/user-guides/journal/calls-and-records/) - для загрузки истории звонков потребуется в 1С подключить дополнительную внешнюю обработку
### События звонков в 1С в реальном времени
Загрузка истории звонков и передача событий в реальном времени — независимые функции. История загружается модулем периодически, а события о начале, соединении и завершении звонка передаются в 1С сразу после их получения от ВАТС МегаФон.
Для настройки передачи событий:
1. Убедитесь, что **Панель телефонии 4.0 для 1С** установлена, включена и настроена в MikoPBX.
2. В личном кабинете ВАТС МегаФон настройте интеграцию с CRM и укажите публичный HTTPS-адрес MikoPBX:
`https://YOUR_PBX_HOST/pbxcore/mega-pbx/event`
Замените `YOUR_PBX_HOST` на доменное имя или публичный адрес вашей MikoPBX. Адрес должен быть доступен со стороны ВАТС МегаФон.
3. Скопируйте CRM-токен из личного кабинета ВАТС МегаФон и укажите его в поле **CRM-токен (из ЛК ВАТС МегаФон, для приёма событий звонков)** в настройках модуля MikoPBX.
4. В поле **Сопоставление сотрудников ВАТС с пользователями 1С** выберите подходящий способ:
* **По внутреннему номеру (рекомендуется)**;
* **По мобильному номеру**;
* **По внутреннему, при отсутствии — по мобильному**.
5. Проверьте раздел **Конфликты сопоставления в 1С**. Если один внутренний или мобильный номер указан у нескольких пользователей 1С, события для него передаваться не будут. Устраните дубликаты, чтобы каждому номеру соответствовал только один пользователь.
6. Сохраните настройки, выполните тестовый звонок и убедитесь, что его состояния отображаются в 1С.
{% hint style="info" %}
**Ключ для авторизации API** и **CRM-токен** выполняют разные задачи. Ключ API используется для загрузки истории звонков и записей разговоров, а CRM-токен — для проверки входящих событий от ВАТС МегаФон.
{% endhint %}
Действие, выполняемое при получении звонка, зависит от используемой конфигурации 1С и настроек интеграции. В **1С:УНФ**, **1С:УТ** или **1С:CRM** может открываться **карточка клиента**, документ **«Событие»** либо другая сущность, предусмотренная конкретной конфигурацией или реализованная в рамках кастомизации клиента.
---
# 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.mikopbx.com/mikopbx/modules/miko/integraciya-s-megapbx-ot-megafon.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
