Integracija Asteriska i Bitrix24

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

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

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

Integracija Asteriska i Bitrix24

Konfiguracija Bitrix24

Stvorit ćemo dva webhuka.

Ulazni webhuk.

Pod računom administratora (s id 1) idemo putem: Aplikacije -> Webhuci -> Dodaj webhuk -> Ulazni webhuk

Integracija Asteriska i Bitrix24

Ispunite parametre ulaznog webhuka kao na ekranima:

Integracija Asteriska i Bitrix24

Integracija Asteriska i Bitrix24

I kliknite spremi.

Nakon spremanja, Bitrix24 će pružiti URL ulaznog webhuka, na primjer:

Integracija Asteriska i Bitrix24

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:

Integracija Asteriska i Bitrix24

Integracija Asteriska i Bitrix24

Spremamo i dobivamo kod autorizacije

Integracija Asteriska i Bitrix24

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“

Integracija Asteriska i Bitrix24

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

Pokretanje i ponovni pokretanje 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

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

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

Kupite pouzdan hosting za web stranice s DDoS zaštitom, VPS VDS servere 🔥 Kupite pouzdan hosting za web stranice s DDoS zaštitom, VPS VDS servere | ProHoster