Интеграция с Плюсофон

Обзор

Агентика подключается к Плюсофону через Asterisk:

Плюсофон → SIP → Asterisk → ARI и Media WebSocket → Агентика

Asterisk регистрирует SIP-аккаунт у Плюсофона и принимает телефонный звонок. Asterisk заводит звонок в Stasis(agentika), после чего Агентика управляет каналом через ARI и обменивается аудио через Media WebSocket. Настройки Агентики не влияют на SIP-регистрацию в Плюсофоне. Сначала разверните Asterisk по инструкции Asterisk ARI в Docker.

Выберите тариф Плюсофона

Возможность	«Первый» — Облачная АТС	«SIP-транк»
Назначение	Небольшая облачная АТС	Подключение собственной АТС
Абонентская плата тарифа	0 ₽/мес., номера оплачиваются отдельно	0 ₽/мес., номера оплачиваются отдельно
SIP-аккаунты	До 3	Один транк по умолчанию
Входящие и исходящие линии	До 3	До 30
Сценарии вызовов	До 2	Нет
Исходящий АОН	Выбирается у SIP-аккаунта в кабинете	Передаётся через `P-Charge-Info`
Тарификация	Поминутная	Посекундная

Тариф «Первый» подходит для одного голосового агента и небольшого количества одновременных звонков. SIP-транк проще со стороны оператора и рассчитан на собственную АТС с большим количеством линий. Актуальные лимиты и цены проверяйте на страницах Облачной АТС и SIP-транка.

Настройте личный кабинет

Для тарифа «Первый»:

Откройте раздел Номера и назначьте номер нужному SIP-аккаунту.
В SIP-аккаунте выберите этот номер как Исходящий номер (АОН).
В сценарии оставьте включённым дозвон на SIP-аккаунт.
Убедитесь, что баланс положительный, а номер имеет статус «Готов к работе».

Для тарифа «SIP-транк» номер должен находиться на том же договоре, что и транк. Облачные сценарии для этого тарифа не используются. В обоих случаях получите в разделе SIP-аккаунты:

SIP-логин;
SIP-пароль;
домен SIP-сервера.

Плюсофон рекомендует TCP/5060, регистрацию на 300 секунд и G.711 A-law. Полный шаблон опубликован в инструкции для Asterisk.

Настройте PJSIP

Замените содержимое /opt/asterisk-docker/config/pjsip.conf. Не храните реальный пароль в документации или репозитории.

[global]
type = global

[transport-tcp]
type = transport
protocol = tcp
bind = 0.0.0.0:5060

[plusofon]
type = registration
transport = transport-tcp
outbound_auth = plusofon_auth
retry_interval = 60
expiration = 300
auth_rejection_permanent = yes
contact_user = <SIP_LOGIN>
server_uri = sip:<SIP_SERVER>
client_uri = sip:<SIP_LOGIN>@<SIP_SERVER>

[plusofon_auth]
type = auth
auth_type = userpass
username = <SIP_LOGIN>
password = <SIP_PASSWORD>

[plusofon]
type = endpoint
transport = transport-tcp
context = from-plusofon
disallow = all
allow = alaw
outbound_auth = plusofon_auth
aors = plusofon
from_domain = <SIP_SERVER>
from_user = <SIP_LOGIN>
sdp_owner = <SIP_LOGIN>
direct_media = no
ice_support = no
send_rpid = yes
rtp_symmetric = yes
force_rport = yes
timers = no

[plusofon]
type = aor
contact = sip:<SIP_SERVER>

[plusofon-identify]
type = identify
endpoint = plusofon
match = 185.54.49.80
match = 185.54.49.83

Перезапустите контейнер после изменения транспорта:

cd /opt/asterisk-docker
docker compose restart asterisk
docker exec asterisk asterisk -rx "pjsip show registrations"

Рабочий статус регистрации — Registered. При ошибке No response received Asterisk не получил даже ответ для начала SIP-аутентификации. Проверьте активность SIP-аккаунта, баланс, сеть и ограничения публичного IP у Плюсофона.

Настройте dialplan

Входящие звонки

[from-plusofon]
exten => _X.,1,NoOp(Incoming Plusofon call to ${EXTEN})
 same => n,Stasis(agentika)
 same => n,Hangup()

После первого входящего звонка посмотрите ${EXTEN} в журнале Asterisk. Добавьте точно это значение как адрес номера в Агентике и назначьте ему Inbound workflow.

Исходящие на тарифе «Первый»

АОН выбирается в личном кабинете Плюсофона, поэтому дополнительный SIP-заголовок не нужен:

[agentika-plusofon-cloud-out]
exten => _X.,1,NoOp(Outgoing Plusofon call to ${EXTEN})
 same => n,Dial(PJSIP/${EXTEN}@plusofon)
 same => n,Hangup()

Исходящие на тарифе «SIP-транк»

Для SIP-транка передайте номер с договора в формате, указанном Плюсофоном:

[agentika-plusofon-trunk-out]
exten => _X.,1,NoOp(Outgoing Plusofon trunk call to ${EXTEN})
 same => n,Set(PJSIP_HEADER(add,P-Charge-Info)=<sip:${AGENTIKA_P_CHARGE_INFO}@voice.plusofon.ru>)
 same => n,Dial(PJSIP/${EXTEN}@plusofon)
 same => n,Hangup()

Агентика передаёт выбранный А-номер в наследуемой переменной __AGENTIKA_P_CHARGE_INFO. В dialplan она читается без подчёркиваний как ${AGENTIKA_P_CHARGE_INFO}. Использовать можно только номер текущего договора — см. настройку SIP-транка.

Подключите Агентику

Создайте конфигурацию Asterisk ARI на странице /telephony-configurations:

Поле	Тариф «Первый»	Тариф «SIP-транк»
ARI Endpoint	публичный HTTPS-адрес Asterisk	публичный HTTPS-адрес Asterisk
Stasis App Name	`agentika`	`agentika`
ARI Password	пароль из `ari.conf`	пароль из `ari.conf`
websocket_client.conf Name	`agentika`	`agentika`
From Extensions	номер исходящего АОНа	номера текущего договора
Outbound Dialplan Context	`agentika-plusofon-cloud-out`	`agentika-plusofon-trunk-out`

Не публикуйте ARI по обычному HTTP. Используйте HTTPS и ограничьте доступ к нему адресами серверов Агентики или приватной сетью.

Пример текущей установки без секретов

Этот пример фиксирует проверенную конфигурацию одной установки с тарифом «Первый». Пароли намеренно заменены плейсхолдерами.

Параметр	Значение
Asterisk	`23.4.1`, Docker, host network
Каталог	`/opt/asterisk-docker`
Публичный IP Asterisk	`185.96.80.103`
SIP-сервер	`191220.voice.plusofon.ru`
SIP-логин	`21261784116773`
Номер	`78412504180`
Agentika	`https://app.agentika.site`
Stasis/ARI user	`agentika`
Media WebSocket name	`agentika`

`ari.conf`

[general]
enabled = yes
pretty = no

[agentika]
type = user
read_only = no
password = <ARI_PASSWORD>

`http.conf`

До настройки HTTPS-прокси ARI слушает только loopback-интерфейс:

[general]
enabled = yes
bindaddr = 127.0.0.1
bindport = 8088

`websocket_client.conf`

[agentika]
type = websocket_client
uri = wss://app.agentika.site/api/v1/telephony/ws/ari
protocols = media
connection_type = per_call_config
tls_enabled = yes
ca_list_file = /etc/ssl/certs/ca-certificates.crt

`chan_websocket.conf`

[global]
control_message_format = plain-text

`pjsip.conf`

Используйте полный шаблон из раздела «Настройте PJSIP» со значениями:

contact_user = 21261784116773
server_uri = sip:191220.voice.plusofon.ru
client_uri = sip:21261784116773@191220.voice.plusofon.ru
username = 21261784116773
password = <SIP_PASSWORD>
from_domain = 191220.voice.plusofon.ru
from_user = 21261784116773
sdp_owner = 21261784116773
contact = sip:191220.voice.plusofon.ru

`rtp.conf`

[general]
rtpstart = 10000
rtpend = 20000

Проверка

cd /opt/asterisk-docker
docker compose ps
docker exec asterisk asterisk -V
docker exec asterisk asterisk -rx "module show like chan_websocket"
docker exec asterisk asterisk -rx "module show like res_websocket_client"
docker exec asterisk asterisk -rx "pjsip show registrations"
docker exec asterisk asterisk -rx "http show status"

На момент фиксации контейнер был healthy, оба WebSocket-модуля имели статус Running, а Плюсофон не отвечал на REGISTER. Это состояние не связано с ARI или настройками Агентики: SIP-регистрация происходит раньше.

Устранение неполадок

Регистрация не переходит в Registered

Проверьте SIP-логин, пароль и сервер в личном кабинете. Номер должен быть назначен этому SIP-аккаунту, исходящий АОН выбран, баланс положительный. Для No response received передайте поддержке Плюсофона публичный IP Asterisk и точное время попытки.

Входящий звонок не доходит до агента

Проверьте назначение номера SIP-аккаунту в Плюсофоне, контекст from-plusofon, фактический ${EXTEN}, номер в Агентике и назначенный ему Inbound workflow.

Нет звука

Проверьте UDP 10000–20000 между Плюсофоном и Asterisk, работающий chan_websocket, исходящий TCP 443 к Агентике и кодек alaw на SIP endpoint.

Начало работы

Основные понятия

Конфигурации

Конструктор голосовых агентов

Телефония

Интеграции

Интеграция с Плюсофон

Обзор

Выберите тариф Плюсофона

Настройте личный кабинет

Настройте PJSIP

Настройте dialplan

Входящие звонки

Исходящие на тарифе «Первый»

Исходящие на тарифе «SIP-транк»

Подключите Агентику

Пример текущей установки без секретов

`ari.conf`

`http.conf`

`websocket_client.conf`

`chan_websocket.conf`

`pjsip.conf`

`rtp.conf`

Проверка

Устранение неполадок

Дополнительные материалы

​Обзор

​Выберите тариф Плюсофона

​Настройте личный кабинет

​Настройте PJSIP

​Настройте dialplan

​Входящие звонки

​Исходящие на тарифе «Первый»

​Исходящие на тарифе «SIP-транк»

​Подключите Агентику

​Пример текущей установки без секретов

​ari.conf

​http.conf

​websocket_client.conf

​chan_websocket.conf

​pjsip.conf

​rtp.conf

​Проверка

​Устранение неполадок

​Дополнительные материалы

Обзор

Выберите тариф Плюсофона

Настройте личный кабинет

Настройте PJSIP

Настройте dialplan

Входящие звонки

Исходящие на тарифе «Первый»

Исходящие на тарифе «SIP-транк»

Подключите Агентику

Пример текущей установки без секретов

`ari.conf`

`http.conf`

`websocket_client.conf`

`chan_websocket.conf`

`pjsip.conf`

`rtp.conf`

Проверка

Устранение неполадок

Дополнительные материалы