Интеграциялар

FreeSWITCH станциясын AutoCall.kz платформасына қалай қосуға болады

← Барлық мақалалар

FreeSWITCH қоңырау платформасына бір SIP-профильмен қосылады. Осыдан кейін қоңырау науқандары сіздің станцияңыз арқылы жүреді: өз нөмірлеріңізден, операторыңыз арқылы және байланысқа арналған өз тарифіңізбен, ал платформа сценарийлерге, сөйлеуді тануға, ЖИ-агентке және есептерге жауап береді.

Қоңырау қалай жүреді

Қоңырауды біз бастаймыз. Платформа FreeSWITCH станцияңызға INVITE жібереді, онда шақырылатын нөмір абоненттің нөмірі болады. Диалпланыңыз бұл қоңырауды операторыңыздың шлюзі (gateway) арқылы сыртқа жіберуі керек. Егер сценарий абонентті операторға ауыстырса, сол транк арқылы ішкі нөмірге қоңырау келеді.

Тіркеу қажет емес: станцияңызды оның статикалық жария IP мекенжайы бойынша танимыз, ал сіз бізді ACL бойынша танисыз.

Қосылым параметрлері

Сигн. мекенжайы pbx.autocall.kz
Файрвол үшін IP 109.233.108.218
Біз жақтағы порт 5060 — UDP, 5061 — TLS
Дауыс (RTP) 109.233.108.208/28 ішкі желісі, 10000–20000 порттары
Кодек OPUS немесе PCMA (alaw)
Нөмір форматы +7XXXXXXXXXX

1-қадам. Файрвол

Сигнализация бір мекенжайдан, дауыс ішкі желіден келеді. Төменде келесі қадамда құратын профиль порты 5070 көрсетілген; профильді стандартты портта қалдырсаңыз, ережені түзетіңіз.

# autocall профиліне сигнализация
udp dport 5070 ip saddr 109.233.108.218 accept
# дауыс
udp dport 10000-20000 ip saddr 109.233.108.208/28 accept

2-қадам. ACL

conf/autoload_configs/acl.conf.xml ішіндегі тізім бойынша профиль біздің қоңырауларды авторизациясыз өткізеді:

<list name="autocall" default="deny">
  <node type="allow" cidr="109.233.108.218/32"/>
</list>

Қолдану: fs_cli -x "reloadacl". Тізімнің көрінетінін тексеру: fs_cli -x "acl autocall list".

3-қадам. Бөлек SIP-профиль

conf/sip_profiles/autocall.xml. external профилін түзетудің орнына бөлек профиль жасаймыз, сонда жұмыс істеп тұрған пирлеріңіздің әрекеті өзгермейді.

<profile name="autocall">
  <settings>
    <param name="sip-ip"      value="$${local_ip_v4}"/>
    <param name="rtp-ip"      value="$${local_ip_v4}"/>
    <!-- станция NAT артында болса, өз жария мекенжайыңызды көрсетіңіз -->
    <param name="ext-sip-ip"  value="СІЗДІҢ_ЖАРИЯ_IP"/>
    <param name="ext-rtp-ip"  value="СІЗДІҢ_ЖАРИЯ_IP"/>
    <param name="sip-port"    value="5070"/>
    <param name="context"     value="from-autocall"/>
    <param name="dialplan"    value="XML"/>
    <!-- қоңыраулар сенімді мекенжайдан келеді, құпиясөз сұралмайды -->
    <param name="auth-calls"  value="false"/>
    <param name="apply-inbound-acl" value="autocall"/>
    <!-- OPUS mod_opus жүктелген болса (стандартты жинақта бар), әйтпесе тек PCMA -->
    <param name="inbound-codec-prefs"  value="OPUS,PCMA"/>
    <param name="outbound-codec-prefs" value="OPUS,PCMA"/>
    <param name="inbound-codec-negotiation" value="generous"/>
    <param name="rtp-timeout-sec" value="300"/>
  </settings>
</profile>

Профильді іске қосу: fs_cli -x "sofia profile autocall start", тексеру: fs_cli -x "sofia status". АТС қосқанда кабинетте 5070 портын көрсету керек болады.

external профилімен де шектелуге болады: оған apply-inbound-acl қосыңыз, ал public контекстінің диалпланында біздің қоңырауларды ${network_addr} шарты бойынша іріктеңіз. Бөлек профиль жай ғана жұмыс істеп тұрған жүйеңізбен азырақ қиылысады.

4-қадам. Диалплан

conf/dialplan/from-autocall.xml ішінде екі жазба бар: ішкі нөмірлер және сыртқа шығатын қалғанының бәрі.

<include>
  <context name="from-autocall">

    <!-- сценарийден ішкі нөмірге ауыстыру -->
    <extension name="autocall_internal">
      <condition field="destination_number" expression="^(\d{3,4})$">
        <action application="bridge" data="user/$1@$${domain}"/>
      </condition>
    </extension>

    <!-- қоңырау науқаны: абонент нөмірі операторыңыз арқылы шығады -->
    <extension name="autocall_outbound">
      <condition field="destination_number" expression="^\+?(7\d{10})$">
        <!-- платформаның қызметтік белгісінің орнына сіздің нөміріңіз -->
        <action application="set" data="effective_caller_id_number=7XXXXXXXXXX"/>
        <action application="set" data="effective_caller_id_name=7XXXXXXXXXX"/>
        <action application="bridge" data="sofia/gateway/операторыңыз/$1"/>
      </condition>
    </extension>

  </context>
</include>

Қолдану: fs_cli -x "reloadxml". ^(\d{3,4})$ үлгісін ішкі нөмірлеріңіздің ұзындығына сәйкестендіріңіз, ал оператордағы теру форматын шартыңыздан нақтылаңыз: біреуіне нөмір + белгісімен, біреуіне онсыз, біреуіне 8 цифрымен керек.

CallerID ауыстыру міндетті. Біздің INVITE сұрауымызда «кімнен» өрісінде 59336790 түріндегі қызметтік белгі тұрады (біздегі қоңырау нөмірі). Ол бойынша CDR жазбаларын біздің экспортпен салыстыру ыңғайлы, бірақ ол телефон нөмірі емес. effective_caller_id_number болмаса, оператор қоңырауды қабылдамайды.

Шифрлау: TLS және SRTP

Профильге TLS параметрлері қосылады, ал дауысты шифрлау диалпланда айнымалымен қосылады:

<!-- профильдің settings бөлімінде -->
<param name="tls"          value="true"/>
<param name="tls-only"     value="true"/>
<param name="tls-sip-port" value="5061"/>
<param name="tls-version"  value="tlsv1.2"/>

<!-- extension ішінде, bridge алдында -->
<action application="set" data="rtp_secure_media=true"/>

Бұл кезде кабинетте TLS транспортын, ал SRTP керек болса, дауысты шифрлаудың тиісті режимін таңдаңыз.

SRTP тек TLS қосулы болғанда жұмыс істейді. Шифрлау кілті тікелей SIP хабарламасының ішінде беріледі: шифрланбаған сигнализация арқылы ол «шифрланған» ағынның қасында ашық мәтінмен кетеді. Ал SRTP жоқ TLS қалыпты нұсқа, көп жабдық дәл осылай жұмыс істейді.

5-қадам. Кабинетке АТС қосу

«АТС» бөлімі → «АТС қосу»: станцияның IP мекенжайы, профиль порты (біздің мысалда 5070), транспорт, қажет болса логин мен құпиясөз, сондай-ақ бір мезгілдегі арналар шегі мен теру жылдамдығы. Оларды операторыңыз рұқсат еткеннен жоғары қоймаңыз, біз асырмаймыз.

Сақтағаннан кейін тізімде станцияның күйі пайда болады: «Жауап береді» FreeSWITCH станциясының біздің байланыс тексерулерімізге жауап беретінін білдіреді. Одан кейін қоңырау науқанын жасағанда өз станцияңызды таңдайсыз, және смета бірден жеңілдікті секунд бағасымен есептеледі.

Қоңыраулар өтпесе

  • Біздің тексерулерге жауап жоқ. Профиль іске қосылмаған немесе басқа мекенжайды тыңдап тұр: sofia status оның күйі мен портын көрсетеді.
  • INVITE сұрауына 403 Forbidden. ACL іске аспады. acl autocall list нәтижесін және профильде apply-inbound-acl тұрғанын тексеріңіз.
  • Қоңырау келеді де, бірден аяқталады. Диалпланда сәйкес жазба табылмады: sofia global siptrace on және console loglevel debug қай контексттен ізделгенін көрсетеді.
  • Оператор қоңырауларды қайтарады. CallerID ауыстырылмаған.
  • Қосылады, бірақ үнсіздік. Дауыс ішкі желісі ашылмаған немесе NAT артында жұмыс істегенде ext-rtp-ip және ext-sip-ip көрсетілмеген.

Бұл қанша тұрады

Өз АТС арқылы қоңырау шалғанда байланыс минуттарын операторыңызға төлейсіз, ал біз тарапта тек платформаның жұмысы қалады, сондықтан секунд әдеттегіден бірнеше есе арзан. Өз станцияңыз арқылы қайталама қоңырау әрекеттері тегін: байланыс Сіздікі, біздің желінің табандылығы үшін төлеудің қажеті жоқ.

Неліктен external емес, бөлек профиль?

Жұмыс істеп тұрған пирлеріңіздің әрекетін өзгертпеу үшін. Бөлек профиль өз портын тыңдайды, оның өз контексті мен өз ACL тізімі бар. external нұсқасы да жұмыс істейді: бұл жағдайда біздің қоңырауларды диалпланда ${network_addr} бойынша іріктеңіз.

Тіркеу немесе авторизация керек пе?

Жоқ, қоңыраулар ACL бойынша auth-calls=false параметрімен қабылданады. Платформаның авторизациядан өткенін қаласаңыз, өз жағыңызда авторизацияны қосып, логин мен құпиясөзді кабинетте көрсетіңіз.

Неліктен қоңырау келеді, бірақ бірден аяқталады?

Қоңырау сәйкес жазбасы жоқ контекстке түсті. Профильдегі context параметрін және +7XXXXXXXXXX түріндегі нөмірлерге арналған ережелерді тексеріңіз.

Қай кодекті қолдану керек?

OPUS және PCMA (alaw). Платформа екеуін де ұсынады, OPUS бірінші: онда дауыс тазарақ. Профильдің кіріс және шығыс басымдықтарында OPUS,PCMA көрсетіңіз. mod_opus жүктелмесе, тек PCMA қалдырыңыз.

TLS және SRTP қолдау көрсетіле ме?

Иә: TLS профильде, SRTP rtp_secure_media айнымалысымен. SRTP тек TLS үстінен, әйтпесе шифрлау кілті ашық мәтінмен кетеді.

Бір нәрсе сәйкес келмесе, қолдау қызметіне жазып, сынақ қоңырауы кезіндегі sofia global siptrace on шығысын тіркеңіз. Ол бойынша INVITE сұрауының жеткені, FreeSWITCH станцияңыздың не жауап бергені және бәрі қай қадамда аяқталғаны көрінеді.

Жасанды интеллектті FreeSWITCH станциясына қалай қосуға болады?

Жоғарыда баптаған SIP-транкты дауыстық ЖИ-агент те пайдаланады. Оны АТС-ке бөлек қосудың қажеті жоқ. Агент АТС-іңіз (FreeSWITCH) арқылы өз нөміріңізден, өз операторыңызбен қоңырау шалады. Клиенттің сұрағына жауап беріп, қажет жерін нақтылап сұрайды да, әңгіменің қорытындысын жазып алады.

  1. Станцияны «АТС» бөлімінде қосып, оны тексеру қоңырауымен растаңыз.
  2. ЖИ-агент жасаңыз да, тапсырманы өз сөзіңізбен түсіндіріңіз.
  3. Қоңырау науқанын іске қосып, онда өз АТС-іңізді таңдаңыз.

Абонент маманмен сөйлесуді сұраса, агент оны сол АТС арқылы қызметкердің ішкі нөміріне немесе ұялы телефонына қосады. Кіріс қоңырауларын да қабылдай аласыз. Ол үшін кабинетте АТС-іңізге кіріс желісін ашыңыз. АТС сол желіге жіберген қоңырауларға ЖИ-агент жауап береді.

Өз нөмірлеріңізден өз АТС арқылы қоңырау шалыңыз

Толығырақ ақпарат пен бағалар «Өз АТС-іңізді қосу» бетінде.

Тегін қолданып көру →