
Na mreži postoje različiti načini integracije IP-telefonije Asterisk i CRM Bitrix24, ali smo ipak odlučili napisati svoje rješenje.
Funkcionalnost je standardna:
- Klikom na link s brojem telefona klijenta u Bitrix24, Asterisk povezuje interni broj korisnika koji je napravio klik s brojem telefona klijenta. U Bitrix24 se evidentira zapis o pozivu, a nakon završetka poziva se učitava snimka razgovora.
- Asterisk prima poziv izvana — u sučelju Bitrix24 prikazujemo karticu klijenta zaposleniku kojem je taj poziv upućen.
Ako takvog klijenta nema, otvorit ćemo karticu za kreiranje novog lead-a.
Čim je poziv završen, to odražavamo u kartici i učitavamo snimku razgovora.
U nastavku ću objasniti kako sve postaviti kod sebe i dati link na github — da, da, uzmite i koristite!
Opšti opis
Našu integraciju nazvali smo CallMe. CallMe je mala web-aplikacija napisana u PHP-u.
Korištene tehnologije i servisi
- PHP 5.6
- Composer
- Nginx + php-fpm
- supervisor
- AMI (Asterisk Manager Interface)
- Bitrix Webhooks (pojednostavljena implementacija REST API)
Prethodna podešavanja
Na serveru sa Asterisk-om 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 gitPrelazimo u direktorij dostupan web-serveru, preuzimamo aplikaciju iz gita i postavljamo odgovarajuće dozvole na folder:
cd /var/www
git clone https://github.com/ViStepRU/callme.git
chown nginx. -R callme/
Zatim ćemo konfigurirati nginx, naš konfiguracijski fajl je smješten u
/etc/nginx/conf.d/pbx.vistep.ru.confserver {
server_name www.pbx.vistep.ba pbx.vistep.ba;
listen *:80;
rewrite ^ https://pbx.vistep.ba$request_uri? permanent;
}
server {
# listen *:80;
# server_name pbx.vistep.ba;
access_log /var/log/nginx/pbx.vistep.ba.access.log main;
error_log /var/log/nginx/pbx.vistep.ba.error.log;
listen 443 ssl http2;
server_name pbx.vistep.ba;
resolver 8.8.8.8;
ssl_stapling on;
ssl on;
ssl_certificate /etc/letsencrypt/live/pbx.vistep.ba/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/pbx.vistep.ba/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;
}
}
Analizu konfiguracije, pitanja sigurnosti, dobivanje certifikata i čak izbor web servera ostavljam izvan okvira ovog članka — o tome je već puno napisano. Aplikacija nema ograničenja, radi i preko http i preko https.
Imamo — https, let’s encrypt certifikat.
Ako ste sve uradili ispravno, kada posjetite link, trebali biste vidjeti nešto slično

Podešavanje Bitrix24
Kreirajmo dva web huka.
Dolazni web huk.
Pod administratorskim računom (s id 1) idemo putem: Aplikacije -> Web hukovi -> Dodaj web huk -> Dolazni web huk

Ispunite parametre dolaznog web huka kao što je prikazano na slikama:


I kliknite na sačuvaj.
Nakon što ste sačuvali, Bitrix24 će vam pružiti URL dolaznog web huka, na primjer:

Sačuvajte vaš URL bez završnog /profile/ — koristiće se u aplikaciji za rad s dolaznim pozivima.
Ja imam to https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/
Odlazni web huk.
Aplikacije -> Web hukovi -> Dodaj web huk -> Odlazni web huk
Detalji opet na slikama:


Sačuvamo i dobijemo kod autorizacije

Ja imam to xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. I njega takođe treba kopirati, potrebno je za ostvarivanje odlaznih poziva.
Važno!
Na serveru Bitrix24 mora biti podešen ssl-certifikat (možete koristiti letsencrypt), inače API Bitrixa neće raditi. Ako imate cloud verziju, ne morate brinuti — tamo već postoji ssl.
Važno!
U polju „Adresa obradnika“ mora biti navedena adresa dostupna iz interneta!
Na kraju ćemo postaviti naš CallMeOut kao aplikaciju za obavljanje poziva (da bi se klikom na broj na PBX-u slala komanda za originalaciju poziva).
U meniju biramo: Još -> Telefonija -> Još -> Postavke, postavljamo u „Broju za odlazni poziv po-default“ Aplikacija: CallMeOut i kliknemo „Sačuvaj“

Podešavanje asteriska
Za uspešno povezivanje Asterisk-a i Bitrix24 treba da dodamo 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
Dalje postoji nekoliko trikova koje će biti potrebno implementirati putem dialplana (kod nas je to extensions.ael).
Donosim celu datoteku, a posle ću dati objašnjenja:
globals {
WAV=\/var\/www\/pbx.vistep.ba\/callme\/records\/wav; \/\/Privremeni katalog sa WAV
MP3=\/var\/www\/pbx.vistep.ba\/callme\/records\/mp3; \/\/Gdje pohraniti mp3 datoteke
URLRECORDS=https:\/\/pbx.vistep.ba\/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 prepoznali u 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ć je 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.ba\/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 samog početka: direktiva globals.
Promenljiva URLRECORDS sadrži URL do datoteka snimaka razgovora, putem kojeg će Bitrix24 pristupiti istima unutar kartice kontakta.
Dalje nas zanima makros recording.
Ovdje, pored snimanja razgovora, postavićemo varijablu FullFname.
Set(FullFname=${URLRECORDS}\/${datedir}\/${fname}.mp3);Ona sadrži puni URL do konkretne datoteke (makros se poziva svugdje).
Razmotrimo 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});
}
Zamislimo da zovemo na 89991234567, prvo dolazimo ovde:
&recording(${CALLERID(number)},${EXTEN});tj. pokreće se makro za snimanje razgovora i postavljaju potrebne promenljive.
Dalje
Set(__CallIntNum=${CALLERID(num)})
Set(CallStart=${STRFTIME(epoch,,%s)});
snimamo ko je započeo poziv i beležimo vreme početka poziva.
I na kraju, 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 snimanje u CDR tabeli za ovu ekstenziju (nije potrebno tamo), postavljamo vreme završetka poziva, izračunavamo trajanje, ako rezultat poziva nije poznat — postavljamo (promenljiva CallMeDISPOSITION) i, kao poslednji korak, š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 smo ga saznali od 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 govori ATC-u da postavi CallerID(name) na vrednost promenljive CallMeCallerIDName.
Sama promenljiva CallMeCallerIDName, pak, postavlja se aplikacijom CallMe (ako u Bitrix24 postoji ime i prezime za broj pozvanog — postavićemo to kao CallerID(name), ako ne — ništa ne radimo).
Podešavanje aplikacije
Fajl sa podešavanjima aplikacije — /var/www/pbx.vistep.ru/config.php
Opis parametara aplikacije:
- CallMeDEBUG — ako je 1, onda će se u log fajl upisivati svi događaji obrađivani aplikacijom, 0 — ne pišemo ništa
- tech — SIP/PJSIP/IAX/etc
- authToken — token za autorizaciju Bitrix24, kod autorizacije izlaznog webhook-a
- bitrixApiUrl — URL ulaznog webhook-a, bez profile/
- extentions — lista vanjskih brojeva
- kontekst — kontekst za origination poziv
- listener_timeout — brzina obrade događaja od Asteriska
- asterisk — niz sa postavkama veze sa Asteriskom:
- host — IP ili hostname servera Asterisk
- shema — shema veze (tcp://, tls://)
- port — port
- username — korisničko ime
- secret — lozinka
- connect_timeout — timeout za povezivanje
- read_timeout — timeout za čitanje
primjer datoteke postavki:
1, // debag poruke u logu: 1 - pišemo, 0 - ne pišemo
'tech' => 'SIP',
'authToken' => 'xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6', // token za autorizaciju Bitrixa
'bitrixApiUrl' => 'https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/', // url ka API Bitrixa (ulazni webhook)
'extentions' => array('888999'), // lista vanjskih brojeva, kroz zarez
'context' => 'dial_out', // izlazni kontekst za origination poziv
'asterisk' => array( // postavke za vezu sa Asteriskom
'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
);Postavka supervisora
Supervisor služi za pokretanje procesa-obrtnika događaja iz Asterisk CallMeIn.php, koji prati ulazne pozive i komunicira sa Bitrix24 (prikazivanje kartice, skrivanje kartice itd.).
Datoteka postavki koju je potrebno kreirati:
/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 restart aplikacije:
supervisorctl start callme
supervisorctl restart callmepregled statusa rada aplikacije:
supervisorctl status callme
callme RUNNING pid 11729, uptime 17 days, 16:58:07Zaključak
Iako je bilo dovoljno složeno, siguran sam da će iskusni administrator moći implementirati ovo i obradovati svoje korisnike.
Kao što sam obećao, .
Pitanja, sugestije — molim u komentare. Također, ako vas zanima kako je napredovala izrada ove integracije, javite, a u narednom članku ću se potruditi da to detaljnije razložim.
Izvor: habr.com
