
Na internete existuje niekoľko možností integrácie IP-ATA Asterisk a CRM Bitrix24, ale rozhodli sme sa napísať svoju.
Funkcionalita je štandardná:
- Kliknutím na odkaz s telefónnym číslom klienta v Bitrix24 Asterisk spojí interné číslo používateľa, ktorého meno je uvedené, s telefónnym číslom klienta. V Bitrix24 sa uloží záznam o telefonáte a po jeho skončení sa natiahne záznam rozhovoru.
- Na Asterisk príde hovor zvonku — v rozhraní Bitrix24 zobrazíme kartu klienta zamestnancovi, na ktorého číslo tento hovor prišiel.
Ak taký klient neexistuje, otvoríme kartu na vytvorenie nového leadu.
Akonáhle je hovor ukončený, zaznamenáme to na karte a natiahneme záznam rozhovoru.
Nižšie vám poviem, ako si to všetko nastaviť a poskytnem link na github — áno, vezmite si to a používajte!
Všeobecný popis
Našu integráciu sme nazvali CallMe. CallMe je malá webová aplikácia napísaná v PHP.
Používané technológie a služby
- PHP 5.6
- Composer
- Nginx + php-fpm
- supervisor
- AMI (Asterisk Manager Interface)
- Webhooky Bitrix (zjednodušená implementácia REST API)
Predbežné nastavenie
Na serveri s Asterisk je potrebné nainštalovať webový server (u nás je to nginx+php-fpm), supervisor a git.
Príkaz na inštaláciu (CentOS):
yum install nginx php-fpm supervisor gitPrejdeme do adresára prístupného pre webový server, vytiahneme aplikáciu z gita a nastavíme potrebné práva na priečinok:
cd /var/www
git clone https://github.com/ViStepRU/callme.git
chown nginx. -R callme/
Ďalej nastavíme nginx, náš konfiguračný súbor sa nachádza v
/etc/nginx/conf.d/pbx.vistep.ru.confserver {
server_name www.pbx.vistep.sk pbx.vistep.sk;
listen *:80;
rewrite ^ https://pbx.vistep.sk$request_uri? permanent;
}
server {
# listen *:80;
# server_name pbx.vistep.sk;
access_log /var/log/nginx/pbx.vistep.sk.access.log main;
error_log /var/log/nginx/pbx.vistep.sk.error.log;
listen 443 ssl http2;
server_name pbx.vistep.sk;
resolver 8.8.8.8;
ssl_stapling on;
ssl on;
ssl_certificate /etc/letsencrypt/live/pbx.vistep.sk/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/pbx.vistep.sk/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; # zákaz pro skryté soubory
}
location ~* /(?:uploads|files)/.*.php$
{
deny all; # zákaz pro nahrané skripty
}
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; # cachování statiky
}
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;
}
}
Analýzu konfigurace, otázky bezpečnosti, získání certifikátu a dokonce výběr webového serveru nechám stranou — o tom bylo hodně napsáno. Aplikace nemá žádná omezení, funguje jak po http, tak po https.
Používáme https, certifikát Let's Encrypt.
Pokud jste všechno udělali správně, pak po kliknutí na odkaz byste měli vidět něco podobného.

Nastavení Bitrix24
Vytvoříme dva webhooky.
Příchozí webhook.
Pod účtem administrátora (s id 1) jdeme cestou: Aplikace -> Webhooky -> Přidat webhook -> Příchozí webhook

Vyplňujeme parametry příchozího webhooku jako na obrazcích:


A klikneme na uložit.
Po uložení Bitrix24 poskytne URL adresu příchozího webhooku, například:

Uložte si svou variantu URL bez koncového /profile/ — ta bude použita v aplikaci pro práci s příchozími hovory.
U mě je to https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/
Odchozí webhook.
Aplikace -> Webhooky -> Přidat webhook -> Odchozí webhook
Podrobnosti znovu na obrázcích:


Uložíme a dostaneme autorizační kód

U mě je to xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6. Ten si také musíte zkopírovat, je potřeba pro provádění odchozích hovorů.
Dôležité!
Na serveri Bitrix24 musí byť nastavený ssl-certifikát (môžete použiť letsencrypt), inak nebude fungovať API Bitrixu. Ak máte cloudovú verziu, nemusíte sa obávať — tam už ssl je.
Dôležité!
V poli „Adresa spracovateľa“ musí byť uvedená adresa dostupná z internetu!
A ako posledný krok nainštalujeme náš CallMeOut ako aplikáciu na uskutočňovanie hovorov (aby po kliknutí na číslo na ATE išla príkaz na origináciu hovoru).
V menu vyberáme: Ďalšie -> Telefónia -> Ďalšie -> Nastavenia, nastavíme v „Čísle pre odchádzajúci hovor predvolene“ Aplikácia: CallMeOut a klikneme na „Uložiť“

Nastavenie asterisk
Pre úspešnú interakciu Asterisk a Bitrix24 musíme pridať AMI-článka callme do 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
Ďalej je niekoľko trikov, ktoré bude potrebné implementovať prostredníctvom dialplanu (u nás to je extensions.ael).
Uvádzam celý súbor, a potom prinesiem vysvetlenia:
globals {
WAV=\/var\/www\/pbx.vistep.ru\/callme\/records\/wav; \/\/Dočasný adresár s WAV
MP3=\/var\/www\/pbx.vistep.ru\/callme\/records\/mp3; \/\/Kam ukladať mp3 súbory
URLRECORDS=https:\/\/pbx.vistep.ru\/callme\/records\/mp3;
RECORDING=1; \/\/ Nahrávanie, 1 - zapnuté.
};
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()); \/\/ nastavíme CallerID, ak sme ho zistili z 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 už bola nastavená ===));
}
}
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});
}
};
Začneme od začiatku: direktíva globals.
Premenná URLRECORDS uchováva URL k súborom záznamov hovorov, podľa ktorého ich Bitrix24 naťahuje do karty kontaktu.
Ďalej nás zaujíma makro recording.
Tu, okrem nahrávania hovorov, nastavíme premennú FullFname.
Set(FullFname=${URLRECORDS}\/${datedir}\/${fname}.mp3);Ukladá plné URL k konkrétnemu súboru (makro sa vyvoláva všade).
Rozoberme odchádzajúci hovor:
_. => {
&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});
}
Predpokladajme, že voláme na 89991234567, najprv sa dostaneme sem:
&recording(${CALLERID(number)},${EXTEN});t.j. zavolá sa makro na nahrávanie hovoru a nastaví sa potrebné premenné.
Ďalej
Set(__CallIntNum=${CALLERID(num)})
Set(CallStart=${STRFTIME(epoch,,%s)});
nahrávame, kto inicioval hovor a zaznamenávame čas začiatku hovoru.
A po jeho ukončení, v špeciálnom kontexte 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});
}
vypíname nahrávanie do tabuľky CDR pre tento extension (netreba to tam), nastavíme čas ukončenia hovoru, vypočítame dĺžku, ak výsledok hovoru nie je známy — nastavíme (premenná CallMeDISPOSITION) a, posledným krokom, pošleme všetko Bitrixu cez systémový curl.
A ešte trochu mágie — prichádzajúci hovor:
888999 => {
&recording(${CALLERID(number)},${EXTEN});
Answer();
ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp()); // nastavíme CallerID, ak sme ho získali z Bitrix24
Set(CallStart=${STRFTIME(epoch,,%s)}); // začíname počítať čas hovoru
Queue(Q1,tT);
Set(CallMeDISPOSITION=${CDR(disposition)});
Hangup();
}
Tu nás zaujíma len jeden riadok.
ExecIF(${CallMeCallerIDName}?Set(CALLERID(name)=${CallMeCallerIDName}):NoOp());Hovorí ATS nastaviť CallerID(name) rovným premenné CallMeCallerIDName.
Samotná premenná CallMeCallerIDName, je nastavená aplikáciou CallMe (ak má Bitrix24 meno pre číslo volajúceho — nastavíme ho ako CallerID(name), ak nie — nič neurobíme).
Nastavenie aplikácie
Súbor s nastavením aplikácie — /var/www/pbx.vistep.ru/config.php
Popis parametrov aplikácie:
- CallMeDEBUG — ak 1, tak do logu budú zapisované všetky udalosti spracovávané aplikáciou, 0 — nič nezapisujeme
- tech — SIP/PJSIP/IAX/etc
- authToken — autorizačný token bitrix24, kód autorizácie výstupného webhúku
- bitrixApiUrl — URL prichádzajúceho webhúku, bez profile/
- extentions — zoznam externých čísiel
- context — kontext pre origináciu hovoru
- listener_timeout — rýchlosť spracovania udalostí od asterisk
- asterisk — pole s nastaveniami pripojenia k asterisku:
- host — ip alebo hostname servera asterisk
- scheme — schéma pripojenia (tcp://, tls://)
- port — port
- username — meno používateľa
- secret — heslo
- connect_timeout — timeout pripojenia
- read_timeout — timeout čítania
príklad konfiguračného súboru:
1, // debug správy v logu: 1 - píšeme, 0 - nepíšeme
'tech' => 'SIP',
'authToken' => 'xcrp2ylhzzd2v43cmfjqmkvrgrcbkni6', //token autorizácie bitrixu
'bitrixApiUrl' => 'https://b24-xsynia.bitrix24.ru/rest/1/7eh61lh8pahw0fwt/', //url k api bitrixu (prichádzajúci webhúk)
'extentions' => array('888999'), // zoznam externých čísiel, oddelených čiarkou
'context' => 'dial_out', //výstupný kontext pre origináciu hovoru
'asterisk' => array( // nastavenia pre pripojenie k asterisku
'host' => '10.100.111.249',
'scheme' => 'tcp://',
'port' => 5038,
'username' => 'callme',
'secret' => 'JD3clEB8_f23r-3ry84gJ',
'connect_timeout' => 10000,
'read_timeout' => 10000
),
'listener_timeout' => 300, //rýchlosť spracovania udalostí od asterisk
);Nastavenie supervisora
Supervisor slúži na spustenie procesu spracovateľa udalostí od Asterisk CallMeIn.php, ktorý sleduje prichádzajúce hovory a interaguje s Bitrix24 (zobrazenie karty, skrytie karty atď.).
Konfiguračný súbor, ktorý je potrebné vytvoriť:
/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.logSpustenie a reštart aplikácie:
supervisorctl start callme
supervisorctl restart callmekontrola stavu aplikácie:
supervisorctl status callme
callme RUNNING pid 11729, uptime 17 days, 16:58:07Záver
Zdalo sa to dosť zložité, ale som presvedčený — skúsený administrátor si s tým poradí a poteší svojich používateľov.
Ako som sľúbil, .
Otázky, pripomienky — prosím do komentárov. Ak máte záujem o to, ako prebiehala vývoj tejto integrácie, napíšte, a v ďalšom článku sa pokúsim všetko podrobne objasniť.
Zdroj: habr.com
