Integracija Asterisk i Bitrix24

Integracija Asterisk i Bitrix24
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
  • PHP AMI biblioteka
  • 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 git

Prelazimo 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.conf

server {
	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

Integracija Asterisk i Bitrix24

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

Integracija Asterisk i Bitrix24

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

Integracija Asterisk i Bitrix24

Integracija Asterisk i Bitrix24

I kliknite na sačuvaj.

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

Integracija Asterisk i Bitrix24

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:

Integracija Asterisk i Bitrix24

Integracija Asterisk i Bitrix24

Sačuvamo i dobijemo kod autorizacije

Integracija Asterisk i Bitrix24

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“

Integracija Asterisk i Bitrix24

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.log

Pokretanje i restart aplikacije:

supervisorctl start callme
supervisorctl restart callme

pregled statusa rada aplikacije:

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

Zaključ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, link na GitHub.

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

Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere 🔥 Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere | ProHoster