
Na internetu postoji nekoliko opcija za integraciju IP-ATC Asterisk i CRM Bitrix24, ali smo na kraju odlučili napisati svoju.
Funcionalnost je standardna:
- Klikom na link s brojem telefona klijenta u Bitrix24, Asterisk povezuje unutarnji broj korisnika koji je izvršio klik s brojem telefona klijenta. U Bitrix24 se bilježi zapis o pozivu i na kraju poziva se povlači snimka razgovora.
- Asterisk prima poziv izvan — u sučelju Bitrix24 prikazujemo karticu klijenta onom zaposleniku kojem je ovaj poziv upućen.
Ako takvog klijenta nema, otvorit ćemo karticu za stvaranje novog lead-a.
Čim je poziv završen, zabilježavamo to u kartici i povlačimo snimku razgovora.
Ispod pisat ću kako sve postaviti kod sebe i dati ću link na github — da-da, uzmite i koristite!
Opći opis
Svoju integraciju nazvali smo CallMe. CallMe je mala web-aplikacija napisana u PHP-u.
Koristeće tehnologije i servisi
- PHP 5.6
- Composer
- Nginx + php-fpm
- supervisor
- AMI (Asterisk Manager Interface)
- Bitrix webhooks (pojednostavljena realizacija REST API-a)
Prethodna konfiguracija
Na serveru s Asteriskom potrebno je instalirati web-server (kod nas je to nginx+php-fpm), supervisor i git.
Komanda za instalaciju (CentOS):
yum install nginx php-fpm supervisor gitPrijelazimo u direktorij dostupan web-serveru, povlačimo aplikaciju iz gita i postavljamo potrebna prava na mapu:
cd /var/www
git clone https://github.com/ViStepRU/callme.git
chown nginx. -R callme/
Nakon toga ćemo postaviti nginx, naš config se nalazi u
/etc/nginx/conf.d/pbx.vistep.ru.confserver {
server_name www.pbx.vistep.hr pbx.vistep.hr;
listen *:80;
rewrite ^ https://pbx.vistep.hr$request_uri? permanent;
}
server {
# listen *:80;
# server_name pbx.vistep.hr;
access_log /var/log/nginx/pbx.vistep.hr.access.log main;
error_log /var/log/nginx/pbx.vistep.hr.error.log;
listen 443 ssl http2;
server_name pbx.vistep.hr;
resolver 8.8.8.8;
ssl_stapling on;
ssl on;
ssl_certificate /etc/letsencrypt/live/pbx.vistep.hr/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/pbx.vistep.hr/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; # zabrana za skrivene datoteke
}
location ~* \/(?:uploads|files)\/.*.php$ {
deny all; # zabrana za učitane skripte
}
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; # keširanje statičkog sadržaja
}
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;
}
}
Analiza konfiguracije, sigurnosna pitanja, dobivanje certifikata i izbor web poslužitelja ostavljam izvan okvira članka — o tome je već mnogo napisano. Aplikacija nema ograničenja, radi i na http i na https.
Imamo — https, certifikat let’s encrypt.
Ako ste sve ispravno učinili, trebali biste vidjeti nešto slično kada kliknete na link.

Konfiguracija Bitrix24
Stvorit ćemo dva webhuka.
Ulazni webhuk.
Pod računom administratora (s id 1) idemo putem: Aplikacije -> Webhuci -> Dodaj webhuk -> Ulazni webhuk

Ispunite parametre ulaznog webhuka kao na ekranima:


I kliknite spremi.
Nakon spremanja, Bitrix24 će pružiti URL ulaznog webhuka, na primjer:

Spremite svoj URL bez završnog /profile/ — on će se koristiti u aplikaciji za rad s ulaznim pozivima.
To je kod mene https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/
Izlazni webhuk.
Aplikacije -> Webhuci -> Dodaj webhuk -> Izlazni webhuk
Detalji ponovno na ekranima:


Spremamo i dobivamo kod autorizacije

To je kod mene xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. Također ga treba kopirati, potreban je za obavljanje odlaznih poziva.
Važno!
Na serveru Bitrix24 treba biti postavljen ssl-certifikat (možete koristiti letsencrypt), inače API Bitrix-a neće raditi. Ako imate cloud verziju, ne morate brinuti — već ima ssl.
Važno!
U polju „Adresa obradnika“ treba biti navedena adresa dostupna iz Interneta!
I kao posljednji detalj postavit ćemo naš CallMeOut kao aplikaciju za obavljanje poziva (da bi se klikom na broj na PBX-u slala naredba za origonaciju poziva).
U izborniku odabiremo: Još -> Telefonska usluga -> Još -> Postavke, postavljamo u „Broj za odlazni poziv po defaultu“ Aplikacija: CallMeOut i kliknemo „Spremi“

Postavka asterisk
Za uspješno povezivanje Asteriska i Bitrix24 trebamo dodati AMI korisnika callme u 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
Nakon toga postoji nekoliko trikova koje će biti potrebno implementirati posredstvom dialplana (kod nas je to extensions.ael).
Navodim cijeli datoteku, a nakon toga ću dati objašnjenja:
globals {
WAV=\/var\/www\/pbx.vistep.ru\/callme\/records\/wav; \/\/Privremena mapa za WAV
MP3=\/var\/www\/pbx.vistep.ru\/callme\/records\/mp3; \/\/Gdje se pohranjuju mp3 datoteke
URLRECORDS=https:\/\/pbx.vistep.ru\/callme\/records\/mp3;
RECORDING=1; \/\/ Snimanje, 1 - uključeno.
};
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()); \/\/ postavljamo CallerID ako smo ga saznali iz Bitrix24
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 već postavljen ===));
}
}
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});
}
};
Počnimo od početka: direktiva globals.
Varijabla URLRECORDS sadrži URL do datoteka snimanja razgovora, putem kojeg će Bitrix24 preuzimati te datoteke u kontakt karticu.
Dalje nas interesira makro recording.
Ovdje, osim snimanja razgovora, postavit ćemo varijablu FullFname.
Set(FullFname=${URLRECORDS}\/${datedir}\/${fname}.mp3);Ona sadrži puni URL do konkretne datoteke (makro se poziva posvuda).
Razmotrit ćemo odlazni poziv:
_. => {
&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});
}
Pretpostavimo da zovemo na 89991234567, prvo dolazimo ovde:
&recording(${CALLERID(number)},${EXTEN});tj. poziva se makro za snimanje poziva i postavljaju potrebne promenljive.
Dalje
Set(__CallIntNum=${CALLERID(num)})
Set(CallStart=${STRFTIME(epoch,,%s)});
snimamo ko je inicirao poziv i beležimo vreme početka poziva.
I po njegovom završetku, u posebnom kontekstu 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});
}
isključujemo upis u CDR tabelu za ovu ekstenziju (nije potrebno tamo), postavljamo vreme završetka poziva, izračunavamo trajanje, ako je rezultat poziva nepoznat — postavljamo (promenljivu CallMeDISPOSITION) i, poslednjim korakom, šaljemo sve Bitrixu preko sistemskog curl-a.
I još malo magije — dolazni poziv:
888999 => {
&recording(${CALLERID(number)},${EXTEN});
Answer();
ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp()); // postavljamo CallerID ako ga znamo iz Bitrix24
Set(CallStart=${STRFTIME(epoch,,%s)}); // započinjemo odbrojavanje vremena poziva
Queue(Q1,tT);
Set(CallMeDISPOSITION=${CDR(disposition)});
Hangup();
}
Ovde nas zanima samo jedan red.
ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp());Ona naređuje PBX-u da postavi CallerID(name) na vrednost promenljive CallMeCallerIDName.
Sama promenljiva CallMeCallerIDName, se postavlja aplikacijom CallMe (ako u Bitrix24 postoji ime i prezime za pozivatelja — postavimo ga kao CallerID(name), ako ne — ne radimo ništa).
Podešavanje aplikacije
Fajl podešavanja aplikacije — /var/www/pbx.vistep.ru/config.php
Opis parametara aplikacije:
- CallMeDEBUG — ako je 1, u log fajl će se upisivati svi događaji koje aplikacija obrađuje, 0 — ne radimo ništa
- tech — SIP/PJSIP/IAX/etc
- authToken — token autorizacije Bitrix24, kod autorizacije odlaznog webhooka
- bitrixApiUrl — URL dolaznog webhooka, bez profile/
- extentions — lista vanjskih brojeva
- kontekst — kontekst za inicijaciju poziva
- listener_timeout — brzina obrade događaja od Asteriska
- asterisk — niz s postavkama za povezivanje na Asterisk:
- host — IP ili hostname poslužitelja Asterisk
- scheme — shema povezivanja (tcp://, tls://)
- port — port
- korisničko_ime — korisničko ime
- secret — lozinka
- connect_timeout — vremensko ograničenje za povezivanje
- read_timeout — vremensko ograničenje za čitanje
primjer datoteke s postavkama:
1, // debag poruke u logu: 1 - piši, 0 - ne piši
'tech' => 'SIP',
'authToken' => 'xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6', // token autorizacije Bitrixa
'bitrixApiUrl' => 'https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/', // url za Bitrix API (dolazni webhook)
'extentions' => array('888999'), // lista vanjskih brojeva, odvojeno zarezom
'context' => 'dial_out', // odlazni kontekst za inicijaciju poziva
'asterisk' => array( // postavke za povezivanje na Asterisk
'host' => '10.100.111.249',
'scheme' => 'tcp://',
'port' => 5038,
'username' => 'callme',
'secret' => 'JD3clEB8_f23r-3ry84gJ',
'connect_timeout' => 10000,
'read_timeout' => 10000
),
'listener_timeout' => 300, // brzina obrade događaja od Asteriska
);Postavke supervisora
Supervisor se koristi za pokretanje procesa-obrađivača događaja iz Asteriska CallMeIn.php, koji prati dolazne pozive i komunicira s Bitrix24 (prikaz kartice, skrivanje kartice itd.).
Datoteka s postavkama koju treba stvoriti:
/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.logPokretanje i ponovni pokretanje aplikacije:
supervisorctl start callme
supervisorctl restart callmepregled statusa rada aplikacije:
supervisorctl status callme
callme RUNNING pid 11729, uptime 17 days, 16:58:07Zaključak
Ispostavilo se da je dovoljno složeno, ali sam siguran — iskusni administrator će to moći implementirati i oduševiti svoje korisnike.
Kao što sam obećao, .
Pitanja, prijedlozi — slobodno u komentare. Također, ako vas zanima kako je išao razvoj ove integracije, javite, a u sljedećem članku ću se potruditi detaljnije objasniti sve.
Izvor: habr.com
