Asterisk와 Bitrix24의 통합

네트워크에는 IP-PBX Asterisk와 CRM Bitrix24를 통합하는 다양한 옵션이 있지만 그럼에도 불구하고 우리는 직접 작성하기로 결정했습니다.

기능적으로 모든 것이 표준입니다.

• Asterisk는 Bitrix24에서 고객의 전화번호가 있는 링크를 클릭하여 이 클릭을 대신한 사용자의 내부 번호를 고객의 전화번호와 연결합니다. Bitrix24에는 통화 기록이 기록되어 있으며 통화가 끝나면 대화 기록이 풀업됩니다.
• 외부에서 Asterisk에 전화가 도착합니다. Bitrix24 인터페이스에서 이 전화가 도착한 직원에게 클라이언트 카드를 보여줍니다.
  그러한 클라이언트가 없으면 새 리드를 생성하기 위해 카드를 엽니다.
  통화가 완료되는 즉시 이를 카드에 반영하고 대화녹음을 끌어올립니다.

컷 아래에서 모든 것을 직접 설정하고 github에 대한 링크를 제공하는 방법을 알려 드리겠습니다. 예, 예, 가져 와서 사용하십시오!

일반적인 설명

우리는 통합 CallMe를 호출했습니다. CallMe는 PHP로 작성된 작은 웹 애플리케이션입니다.

사용된 기술 및 서비스

• PHP 5.6
• PHP AMI 라이브러리
• 작곡가
• nginx + php fpm
• 감독자
• AMI(별표 관리자 인터페이스)
• Bitrix 웹후크(단순화된 REST API 구현)

사전 설정

Asterisk가 있는 서버에는 웹 서버(nginx + php-fpm이 있음), 관리자 및 git을 설치해야 합니다.

설치 명령(CentOS):

yum install nginx php-fpm supervisor git

웹 서버에 사용 가능한 디렉토리를 전달하고 git에서 응용 프로그램을 가져오고 폴더에 필요한 권한을 설정합니다.

cd /var/www
git clone https://github.com/ViStepRU/callme.git
chown nginx. -R callme/

다음으로 nginx를 구성합니다. 구성은 다음 위치에 있습니다.

/etc/nginx/conf.d/pbx.vistep.ru.conf

server {
	server_name www.pbx.vistep.ru pbx.vistep.ru;
	listen *:80;
	rewrite ^  https://pbx.vistep.ru$request_uri? permanent;
}

server {
#        listen *:80;
#	server_name pbx.vistep.ru;


	access_log /var/log/nginx/pbx.vistep.ru.access.log main;
        error_log /var/log/nginx/pbx.vistep.ru.error.log;

    listen 443 ssl http2;
    server_name pbx.vistep.ru;
    resolver 8.8.8.8;
    ssl_stapling on;
    ssl on;
    ssl_certificate /etc/letsencrypt/live/pbx.vistep.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/pbx.vistep.ru/privkey.pem;
    ssl_dhparam /etc/nginx/certs/dhparam.pem;
    ssl_session_timeout 24h;
    ssl_session_cache shared:SSL:2m;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers kEECDH+AES128:kEECDH:kEDH:-3DES:kRSA+AES128:kEDH+3DES:DES-CBC3-SHA:!RC4:!aNULL:!eNULL:!MD5:!EXPORT:!LOW:!SEED:!CAMELLIA:!IDEA:!PSK:!SRP:!SSLv2;
    ssl_prefer_server_ciphers on;
    add_header Strict-Transport-Security "max-age=31536000;";
    add_header Content-Security-Policy-Report-Only "default-src https:; script-src https: 'unsafe-eval' 'unsafe-inline'; style-src https: 'unsafe-inline'; img-src https: data:; font-src https: data:; report-uri /csp-report";
	
	root /var/www/callme;
	index  index.php;
        location ~ /. {
                deny all; # запрет для скрытых файлов
        }

        location ~* /(?:uploads|files)/.*.php$ {
                deny all; # запрет для загруженных скриптов
        }

        location ~* ^.+.(ogg|ogv|svg|svgz|eot|otf|woff|mp4|ttf|rss|atom|jpg|jpeg|gif|png|ico|zip|tgz|gz|rar|bz2|doc|xls|exe|ppt|tar|mid|midi|wav|bmp|rtf)$ {
                access_log off;
                log_not_found off;
                expires max; # кеширование статики
        }

	location ~ .php {
		root /var/www/callme;
		index  index.php;
		fastcgi_pass unix:/run/php/php5.6-fpm.sock;
	#	fastcgi_pass 127.0.0.1:9000;
		fastcgi_index index.php;
		fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
		include /etc/nginx/fastcgi_params;
		}
}

구성 분석, 보안 문제, 인증서 획득, 기사 범위를 벗어난 웹 서버 선택까지 남겨 둘 것입니다. 이에 대해 많이 작성되었습니다. 응용 프로그램에는 제한이 없으며 http와 https 모두에서 작동합니다.

우리는 https가 있습니다. 인증서를 암호화합시다.

모든 작업을 올바르게 수행한 경우 링크를 클릭하면 다음과 같은 내용이 표시됩니다.

Bitrix24 설정

두 개의 웹후크를 생성해 보겠습니다.

들어오는 웹훅.

관리자 계정(ID 1)에서 다음 경로를 따라 이동합니다. Applications -> Webhook -> Add webhook -> Incoming webhook

스크린샷과 같이 들어오는 Webhook의 매개변수를 입력합니다.

그리고 저장을 클릭합니다.

저장 후 Bitrix24는 들어오는 웹후크의 URL을 제공합니다. 예를 들면 다음과 같습니다.

후행 /profile/ 없이 URL 버전을 저장합니다. 이 URL은 애플리케이션에서 수신 전화를 처리하는 데 사용됩니다.

나는 그것을 가지고있다 https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/

발신 웹훅.

애플리케이션 -> Webhook -> Webhook 추가 -> 나가는 Webhook

자세한 내용은 스크린샷에 있습니다.

인증 코드 저장 및 받기

나는 그것을 가지고있다 xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. 또한 자신에게 복사해야 하며 발신 전화를 거는 데 필요합니다.

중요!

Bitrix24 서버에서 SSL 인증서를 구성해야 합니다(letsencrypt를 사용할 수 있음). 그렇지 않으면 BitrixXNUMX API가 작동하지 않습니다. 클라우드 버전이 있는 경우 걱정하지 마십시오. ssl은 이미 있습니다.

중요!

"프로세서 주소" 필드에는 인터넷에서 액세스할 수 있는 주소를 표시해야 합니다!

마지막으로 CallMeOut을 전화 걸기용 애플리케이션으로 설치해 보겠습니다(PBX에서 번호를 클릭하면 전화를 걸기 위한 명령이 날아갑니다).

메뉴에서 추가 -> 전화 통신 -> 추가 -> 설정을 선택하고 "기본적으로 발신 전화 번호"로 설정합니다. 응용 프로그램: CallMeOut을 클릭하고 "저장"을 클릭합니다.

별표 설정

Asterisk와 Bitrix24 간의 성공적인 상호 작용을 위해 callme AMI 사용자를 manager.conf에 추가해야 합니다.

[callme]
secret = JD3clEB8_f23r-3ry84gJ
deny = 0.0.0.0/0.0.0.0
permit = 127.0.0.1/255.255.255.0
permit= 10.100.111.249/255.255.255.255
permit = 192.168.254.0/255.255.255.0
read = system,call,log,verbose,agent,user,config,dtmf,reporting,cdr,dialplan
write = system,call,agent,log,verbose,user,config,command,reporting,originate

다음으로 다이얼플랜(extensions.ael이 있음)을 사용하여 구현해야 하는 몇 가지 트릭이 있습니다.

전체 파일을 인용한 다음 설명을 드리겠습니다.

globals {
    WAV=/var/www/pbx.vistep.ru/callme/records/wav; //Временный каталог с WAV
    MP3=/var/www/pbx.vistep.ru/callme/records/mp3; //Куда выгружать mp3 файлы
    URLRECORDS=https://pbx.vistep.ru/callme/records/mp3;
    RECORDING=1; // Запись, 1 - включена.
};

macro recording(calling,called) {
        if ("${RECORDING}" = "1"){
              Set(fname=${UNIQUEID}-${STRFTIME(${EPOCH},,%Y-%m-%d-%H_%M)}-${calling}-${called});
	      Set(datedir=${STRFTIME(${EPOCH},,%Y/%m/%d)});
	      System(mkdir -p ${MP3}/${datedir});
	      System(mkdir -p ${WAV}/${datedir});
              Set(monopt=nice -n 19 /usr/bin/lame -b 32  --silent "${WAV}/${datedir}/${fname}.wav"  "${MP3}/${datedir}/${fname}.mp3" && rm -f "${WAV}/${fname}.wav" && chmod o+r "${MP3}/${datedir}/${fname}.mp3");
	      Set(FullFname=${URLRECORDS}/${datedir}/${fname}.mp3);
              Set(CDR(filename)=${fname}.mp3);
	      Set(CDR(recordingfile)=${fname}.wav);
              Set(CDR(realdst)=${called});
              MixMonitor(${WAV}/${datedir}/${fname}.wav,b,${monopt});

       };
};


context incoming {
888999 => {
	&recording(${CALLERID(number)},${EXTEN});
        Answer();
        ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp()); // выставляем CallerID если узнали его у Битрикс24
        Set(CallStart=${STRFTIME(epoch,,%s)});  
        Queue(Q1,tT);
        Set(CallMeDISPOSITION=${CDR(disposition)}); 
        Hangup();
        }

h => {
    Set(CDR_PROP(disable)=true); 
    Set(CallStop=${STRFTIME(epoch,,%s)}); 
    Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)}); 
    ExecIF(${ISNULL(${CallMeDISPOSITION})}?Set(CallMeDISPOSITION=${CDR(disposition)}):NoOP(=== CallMeDISPOSITION already was set ===));  
}

}


context default {

_X. => {
        Hangup();
        }
};


context dial_out {

_[1237]XX => {
	&recording(${CALLERID(number)},${EXTEN});
        Set(__CallIntNum=${CALLERID(num)})
	Set(CallStart=${STRFTIME(epoch,,%s)});
        Dial(SIP/${EXTEN},,tTr);
        Hangup();
        }

_11XXX => {
	&recording(${CALLERID(number)},${EXTEN});
	Set(CallStart=${STRFTIME(epoch,,%s)});
	Set(__CallIntNum=${CALLERID(num)});
        Dial(SIP/${EXTEN:2}@toOurAster,,t);
        Hangup();
        }

_. => {
	&recording(${CALLERID(number)},${EXTEN});
        Set(__CallIntNum=${CALLERID(num)})
	Set(CallStart=${STRFTIME(epoch,,%s)});
	Dial(SIP/${EXTEN}@toOurAster,,t);
	Hangup();
        }

h => {
        Set(CDR_PROP(disable)=true);
        Set(CallStop=${STRFTIME(epoch,,%s)});
        Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)});
	if(${ISNULL(${CallMeDISPOSITION})}) {
          Set(CallMeDISPOSITION=${CDR(disposition)});
        }
	System(curl -s http://pbx.vistep.ru/CallMeOut.php --data action=sendcall2b24 --data call_id=${CallMeCALL_ID} --data-urlencode FullFname=${FullFname} --data CallIntNum=${CallIntNum} --data CallDuration=${CallMeDURATION} --data-urlencode CallDisposition=${CallMeDISPOSITION});
}

};

처음부터 시작하자: 디렉티브 전역.

변수 URL레코드 Bitrix24가 연락처 카드로 가져오는 대화 녹음 파일의 URL을 저장합니다.

다음으로 우리는 매크로 매크로에 관심이 있습니다 방송.

여기에서는 대화를 녹음하는 것 외에도 변수를 설정합니다. 전체 이름.

Set(FullFname=${URLRECORDS}/${datedir}/${fname}.mp3);

특정 파일에 대한 전체 URL을 저장합니다(매크로는 모든 곳에서 호출됨).

발신 전화를 분석해 보겠습니다.

_. => {
	&recording(${CALLERID(number)},${EXTEN});
        Set(__CallIntNum=${CALLERID(num)})
	Set(CallStart=${STRFTIME(epoch,,%s)});
	Dial(SIP/${EXTEN}@toOurAster,,t);
	Hangup();
        }

h => {
        Set(CDR_PROP(disable)=true);
        Set(CallStop=${STRFTIME(epoch,,%s)});
        Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)});
	if(${ISNULL(${CallMeDISPOSITION})}) {
          Set(CallMeDISPOSITION=${CDR(disposition)});
        }
	System(curl -s http://pbx.vistep.ru/CallMeOut.php --data action=sendcall2b24 --data call_id=${CallMeCALL_ID} --data-urlencode FullFname=${FullFname} --data CallIntNum=${CallIntNum} --data CallDuration=${CallMeDURATION} --data-urlencode CallDisposition=${CallMeDISPOSITION});
}

89991234567에 전화를 걸면 가장 먼저 여기에 도착합니다.

&recording(${CALLERID(number)},${EXTEN});

저것들. 통화 녹음 매크로가 호출되고 필요한 변수가 설정됩니다.

다음

        Set(__CallIntNum=${CALLERID(num)})
	Set(CallStart=${STRFTIME(epoch,,%s)});

통화를 시작한 사람을 기록하고 통화 시작 시간을 기록합니다.

그리고 완료되면 특별한 맥락에서 h

h => {
        Set(CDR_PROP(disable)=true);
        Set(CallStop=${STRFTIME(epoch,,%s)});
        Set(CallMeDURATION=${MATH(${CallStop}-${CallStart},int)});
	if(${ISNULL(${CallMeDISPOSITION})}) {
          Set(CallMeDISPOSITION=${CDR(disposition)});
        }
	System(curl -s http://pbx.vistep.ru/CallMeOut.php --data action=sendcall2b24 --data call_id=${CallMeCALL_ID} --data-urlencode FullFname=${FullFname} --data CallIntNum=${CallIntNum} --data CallDuration=${CallMeDURATION} --data-urlencode CallDisposition=${CallMeDISPOSITION});
}

이 확장에 대한 CDR 테이블의 항목을 끄고(필요하지 않음) 통화 종료 시간을 설정하고 통화 결과를 알 수 없는 경우 지속 시간을 계산합니다. 전화주세요 처분) 그리고 마지막 단계에서 시스템 컬을 통해 모든 것을 Bitrix로 보냅니다.

그리고 조금 더 마술 - 수신 전화:

888999 => {
	&recording(${CALLERID(number)},${EXTEN});
        Answer();
        ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp()); // выставляем CallerID если узнали его у Битрикс24
        Set(CallStart=${STRFTIME(epoch,,%s)}); // начинаем отсчет времени звонка
        Queue(Q1,tT);
        Set(CallMeDISPOSITION=${CDR(disposition)}); 
        Hangup();
        }

여기서는 한 줄에만 관심이 있습니다.

ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp());

그녀는 PBX 설치라고 말합니다. 발신번호(이름) 변하기 쉬운 CallMe발신자 ID이름.

CallMeCallerIDName 변수 자체는 CallMe 애플리케이션에 의해 설정됩니다(Bitrix24에 발신자 번호의 전체 이름이 있는 경우 다음과 같이 설정합니다). 발신번호(이름), 아니오 - 우리는 아무것도하지 않을 것입니다).

애플리케이션 설정

애플리케이션 설정 파일 - /var/www/pbx.vistep.ru/config.php

애플리케이션 매개변수 설명:

• 나한테 전화해디버그 - 1이면 애플리케이션에서 처리한 모든 이벤트가 로그 파일에 기록되고, 0이면 아무 것도 기록하지 않습니다.
• 기술 SIP/PJSIP/IAX/기타
• 인증토큰 — Bitrix24 인증 토큰, 발신 웹훅 인증 코드
• bitrixApiUrl — 수신 웹후크의 URL(profile/ 없음)
• 확장 — 외부 번호 목록
• 문맥 — 호출 발신에 대한 컨텍스트
• 리스너_시간 초과 - 별표에서 이벤트 처리 속도
• 별표 - 별표에 대한 연결 설정이 있는 배열:
• 주인 - 별표 서버의 IP 또는 호스트 이름
• 계획 — 연결 다이어그램(tcp://, tls://)
• 포트 - 포트
• 사용자 이름 - 사용자 이름
• 비밀 - 비밀번호
• 연결_시간 초과 - 접속 시간 초과
• 읽기 시간 초과 - 읽기 제한 시간

예제 설정 파일:

 <?php
return array(

        'CallMeDEBUG' => 1, // дебаг сообщения в логе: 1 - пишем, 0 - не пишем
        'tech' => 'SIP',
        'authToken' => 'xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6', //токен авторизации битрикса
        'bitrixApiUrl' => 'https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/', //url к api битрикса (входящий вебхук)
        'extentions' => array('888999'), // список внешних номеров, через запятую
        'context' => 'dial_out', //исходящий контекст для оригинации звонка
        'asterisk' => array( // настройки для подключения к астериску
                    'host' => '10.100.111.249',
                    'scheme' => 'tcp://',
                    'port' => 5038,
                    'username' => 'callme',
                    'secret' => 'JD3clEB8_f23r-3ry84gJ',
                    'connect_timeout' => 10000,
                    'read_timeout' => 10000
                ),
        'listener_timeout' => 300, //скорость обработки событий от asterisk

);

감독자 설정

감독자는 들어오는 호출을 모니터링하고 Bitrix24와 상호 작용(카드 표시, 카드 숨기기 등)하는 Asterisk CallMeIn.php 이벤트 핸들러 프로세스를 시작하는 데 사용됩니다.

만들 설정 파일:

/etc/supervisord.d/callme.conf

[program:callme]
command=/usr/bin/php CallMeIn.php
directory=/var/www/pbx.vistep.ru
autostart=true
autorestart=true
startretries=5
stderr_logfile=/var/www/pbx.vistep.ru/logs/daemon.log
stdout_logfile=/var/www/pbx.vistep.ru/logs/daemon.log

응용 프로그램 시작 및 다시 시작:

supervisorctl start callme
supervisorctl restart callme

신청 상태 보기:

supervisorctl status callme
callme                           RUNNING   pid 11729, uptime 17 days, 16:58:07

결론

상당히 어려웠지만 숙련 된 관리자가 사용자를 구현하고 기쁘게 할 수 있다고 확신합니다.

약속대로 깃허브 링크.

질문, 제안 - 의견을 보내주십시오. 또한이 통합 개발이 어떻게 진행되었는지에 관심이 있으시면 다음 기사에서 모든 것을 더 자세히 공개하려고 노력할 것입니다.

출처 : habr.com