FreePBX. Konfigurera Asterisk för e-postmeddelanden om missade inkommande samtal i kö

IP ATC Asterisk — en kraftfull lösning för IP-telefoni. Webgränssnittet FreePBX, designat för Asterisk, förenklar betydligt konfigurationen och sänker inträdesbarriärerna för systemet.
Om du kan tänka dig en uppgift relaterad till IP-telefoni, så är det nästan säkert möjligt att genomföra den i Asterisk. Men var beredd på att det kommer att krävas uthållighet och tålamod från din sida.

Vi stod inför uppgiften att konfigurera e-postaviseringar om missade samtal. Mer specifikt att meddela via e-post de fall där ett inkommande samtal gick till kö, men ingen (av agenterna) svarade på det inkommande samtalet.

Överraskande nog fann vi inget standardverktyg för att lösa denna uppgift i FreePBX. Hur vi löste detta kommer jag att berätta om längre ner.

Förord

Innan vi löste uppgiften "rakt på" letade vi förstås efter information på internet, men vi hittade ingen färdig lösning (kanske letade vi dåligt, men vad ska man göra…).

Färdigheterna i att direkt arbeta i Asterisk är inte så många som vi skulle önska, därför var lösningen som föreslogs här, inte helt genomtänkt och avfärdades.

Vi gillade lösningen som föreslogs av här, även om den inte fungerade. Därför betonade vi att man måste arbeta i Asterisk i kontexten av köer [ext-queues]. Eftersom vi arbetar med FreePBX, måste vi arbeta i konfigurationsfilen "extensions_override_freepbx.conf". Vi noterade att det är praktiskt att "fånga missade samtal" innan händelsen hangupcall (avslut av samtal).
Efter att ha läst diskussionen om här, fick vi idén att filtrera variabeln "Disposition" i CDR för alla agenter i kön. Efter att ha läst denna informationen formulerades ganska konkreta steg för att lösa den uppställda uppgiften.

Vad har vi:

Vi har FreePBX 13.0.197 som använder Asterisk 13.12.1. Operativsystemversion SHMZ release 6.6 (Final). Distributionen baseras på CentOS.

I Asterisk är IVR (röstmeny) konfigurerat och dirigerar inkommande samtal till olika köer. Varje kö har tilldelats agenter.

Teori

Vad händer i Asterisk

När Asterisk tar emot ett inkommande samtal, går detta samtal till IVR. Den som ringer väljer genom att trycka på en viss siffra på telefonen och kommer till en viss kö. Efter det får alla lediga agenter i köen samtalet samtidigt.

För att bättre förstå vad som händer i detta ögonblick och vad som händer härnäst, låt oss hänvisa till Report CDR (Fig. 1).

Fig. 1

När ett inkommande samtal hamnar i kön, får alla agenter variabeln "Disposition" att vara lika med "NO ANSWER", om agenterna inte är upptagna vid det tillfället. Variabeln "Disposition" kan anta andra värden (se. https://asterisk-pbx.ru/wiki/asterisk/cf/cdr), förutom värdet "ANSWERED". När en av agenterna svarar på det inkommande samtalet blir värdet på denna agents variabel "Disposition" lika med "ANSWERED".
Från Report CDR kan man märka att när samtalet går in i kön (i kolumnen App blir värdet lika med "Queue"), så visas alla händelser med samma "uniqueid" (kolumnen System).

Kort om CDR

Det är viktigt att förstå vad CDR är, och vid vilken tidpunkt data skrivs in i CDR som vi observerar i Report CDR. CDR, i förhållande till operativsystemet, är en databas där Asterisk sparar detaljerade samtalsrapporter (se. https://asterisk-pbx.ru/wiki/asterisk/cf/cdr). I vårt fall handlar det om databasen som kallas asteriskcdrdb, som finns i mysql. Genom erfarenhet har vi fastställt att data för ett samtal med ett specifikt "uniqueid" inte skrivs in i asteriskcdrdb omedelbart efter att någon händelse inträffar, utan efter händelsen hangupcall (samtalsavslut).

Principen för den skapade lösningen

Eftersom vi har mer kunskap om bash än om Asterisk, blev huvudidén följande. Innan händelsen hangupcall ska ett bash-skript anropas. Tre parametrar ska skickas till detta skript. Den första parametern är "uniqueid", för att filtrera de data som hämtas från CDR. Den andra parametern är "CALLERID(num)" (nummer till den som ringer), för att veta vem man ska återringa. Den tredje parametern är "NODEST" (kö nummer), som samtalet kom till, för att veta vilket ärende samtalet handlade om, och vem som ska få ett e-postmeddelande om det missade samtalet.
Bash-skriptet ska ansluta till databasen asteriskcdrdb i mysql och hämta alla värden för variabeln "Disposition" med det specifika "uniqueid". Av de erhållna uppgifterna måste värdena "NO ANSWER", "BUSY", "FAILED", "UNKNOWN" uteslutas. Som resultat kommer antingen "ANSWERED" — det inkommande samtalet besvarades, eller inget alls — ett missat samtal.

Om samtalet visade sig vara missat, ska skriptet sedan skicka ett e-postmeddelande.
För att gå rakt på sak, är det viktigt att notera en avgörande punkt. Asterisk utför kommandon sekventiellt och väntar på att de ska slutföras (vilket i och för sig är logiskt). Men vi kommer att kalla på bash-skriptet innan kommandot hangupcall har utförts. Således, i ögonblicket då skriptet körs, kommer informationen om det önskade 'uniqueid' ännu inte att ha registrerats i CDR. För att lösa detta problem kommer vi att kalla på bash-skriptet med parametern '&', så att Asterisk genast går vidare till nästa steg, det vill säga hangupcall. Inuti bash-skriptet kommer vi i början att sätta en liten tidsfördröjning för att ge Asterisk tid att registrera data med det intressanta 'uniqueid' i CDR.

Praxis

Innan vi går vidare till att konfigurera Asterisk och skapa bash-skriptet, måste vi ställa in e-postaviseringar. För detta kommer vi att använda programmet postfix.

Konfigurera postfix

Vi har en e-postdomän 'lucky.ru' som finns på Yandex. Vi kommer att ställa in postfix i SMTP-klientläge och skicka e-post från kontot asterisk@lucky.ru.
Vi baserar oss på denna lösning: https://www.dmosk.ru/miniinstruktions.php?mini=postfix-over-yandex.

Först installerar/uppdaterar/kontrollerar vi att paketen finns:

yum install postfix
yum install mailx
yum install cyrus-sasl cyrus-sasl-lib cyrus-sasl-plain

Vi kommer inte att skriva över huvudkonfigurationsfilen för postfix '/etc/postfix/main.cf', utan skapa en säkerhetskopia av den:

cp /etc/postfix/main.cf /etc/postfix/main.cf.sav

Vi redigerar filen '/etc/postfix/main.cf' och gör den till följande:

nano /etc/postfix/main.cf
#####################
relayhost =
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/private/sasl_passwd
smtp_sasl_security_options = noanonymous
smtp_sasl_type = cyrus
smtp_sasl_mechanism_filter = login
smtp_sender_dependent_authentication = yes
sender_dependent_relayhost_maps = hash:/etc/postfix/private/sender_relay
smtp_generic_maps = hash:/etc/postfix/generic
smtp_tls_CAfile = /etc/postfix/ca.pem
smtp_use_tls = yes
smtputf8_autodetect_classes = all
#####################

Inte varje rad i '/etc/postfix/main.cf' kan kommenteras. Kommentarer i vissa rader identifieras inte av parsers och överförs för bearbetning, vilket kan leda till fel. Det är bättre att avstå från kommentarer inom denna fil. Du kan experimentera med detta genom att köra 'tail -f /var/log/messages' i ett intilliggande fönster.

Jag vill särskilt nämna raden 'smtputf8_autodetect_classes = all'. Denna inställning aktiverar utf-8 som standard, vilket möjliggör användning av kyrilliska tecken både i e-postens kropp och ämnesrad utan ytterligare manipulationsåtgärder (Se. http://www.postfix.org/SMTPUTF8_README.html).

Vi skapar en katalog för konfigurationsfiler:

mkdir /etc/postfix/private

Redigera filen «/etc/postfix/private/sender_relay». Där anger vi vilken smtp-server som ska refereras till vid användning av vår e-postdomän:

nano /etc/postfix/private/sender_relay
#####################
@lucky.ru smtp.yandex.ru
#####################

Redigera filen «/etc/postfix/private/sasl_passwd». Här anger vi e-postadressen som vi kommer använda för att skicka meddelanden samt inloggning och lösenord för detta konto (användarnamn och lösenord anges med kolon):

nano /etc/postfix/private/sasl_passwd
#####################
asterisk@lucky.ru asterisk@lucky.ru:password_asterisk
#####################

Redigera filen «/etc/postfix/generic». Där skriver vi reglerna för att ändra avsändaradressen (se. https://wiki.merionet.ru/ip-telephoniya/30/postfix-nastrojka-otpravki-pochty-v-asterisk/):

nano /etc/postfix/generic
#####################
root asterisk@lucky.ru
root@localhost asterisk@lucky.ru
root@localhost.localdomain asterisk@lucky.ru
root@freepbx asterisk@lucky.ru
root@freepbx.localdomain asterisk@lucky.ru
root@asterisk asterisk@lucky.ru
root@asterisk.localdomain asterisk@lucky.ru
asterisk asterisk@lucky.ru
asterisk@localhost asterisk@lucky.ru
asterisk@localhost.localdomain asterisk@lucky.ru
asterisk@freepbx asterisk@lucky.ru
asterisk@freepbx.localdomain asterisk@lucky.ru
asterisk@asterisk asterisk@lucky.ru
asterisk@asterisk.localdomain asterisk@lucky.ru
root@localdomain.localdomain asterisk@lucky.ru
#####################

Den ursprungliga avsändaradressen beror på innehållet i «/etc/hosts» och «/etc/hostname», såväl som namnet på användaren som kommer att skicka meddelandet. Det vill säga, trots att vi använder en smtp-klient och skickar e-post från asterisk@lucky.ru, kommer postfix initialt att sätta «något eget» i avsändaradressen och detta måste rättas till med reglerna i denna konfigurationsfil.

Jag visar innehållet i min fil «/etc/hosts»:

cat /etc/hosts
#####################
127.0.0.1 localhost localhost.localdomain localhost4 localhost4.localdomain4 asterisk.localdomain
127.0.0.1 localhost.localdomain localhost
::1 asterisk localhost localhost6
#####################

Det är viktigt att servern har en domän (värdet efter punkten), eftersom programmet mail «letar efter» domännamnet i «/etc/hosts» och om det «inte hittar» det direkt, fortsätter det att leta i ytterligare några minuter innan det skickar meddelandet. Det vill säga, om domänen inte är angiven, kommer meddelandet att skickas med en fördröjning på flera minuter.

Jag visar innehållet i min fil «/etc/hostname»:

cat /etc/hostname
#####################
asterisk
#####################

Därefter är det nödvändigt att konvertera de skapade konfigurationsfilerna till indexerade databaser, för detta kör vi följande kommando:

postmap /etc/postfix/generic && postmap /etc/postfix/private/{sasl_passwd,sender_relay}

Därefter behöver vi ladda ner och placera certifikatet för smtp.yandex.ru på servern, för detta kör vi följande kommando:

openssl s_client -starttls smtp -crlf -connect smtp.yandex.ru:25 > /etc/postfix/ca.pem

Men efter att den tekniska informationen visas på skärmen kommer teamet att "fortsätta hänga". Tryck Ctrl+C för att avbryta.

Nu tar vi bort allt skräp från den resulterande filen manuellt och lämnar bara certifikatet. Det borde se ut ungefär så här:

nano /etc/postfix/ca.pem
#####################
-----BEGIN CERTIFICATE-----
MIIGazCCBVOgAwIBAgIQcUU9mJXW4OUs5Gf0JfLtsjANBgkqhkiG9w0BAQsFADBf
...
nRG0DfdqYIuPGApFORYe
-----END CERTIFICATE-----
#####################

Och till sist startar vi om postfix:

service postfix restart

Vi skickar ett testmeddelande:

echo "Detta är kroppstexten" | mail -s "Detta är ämnet" admin@lucky.ru

admin@lucky.ru – mottagarens adress

Nu är inställningen av postfix klar.

Vi skriver en bash-skript

Vi skapar en katalog för att lagra bash-skriptet (här kan man välja var som helst):

mkdir /home/asterisk/scripts

Vi skapar bash-skriptfilen:

touch /home/asterisk/scripts/noanswer.sh

Vi ger skriptfilen rättigheter för att köras:

chmod +x /home/asterisk/scripts/noanswer.sh

Om du är osäker på filrättigheterna kan du temporärt ge full tillgång till filen för felsökning. Men det är "inte säkert".

chmod 777 /home/asterisk/scripts/noanswer.sh

Texten i bash-skriptet:

nano /home/asterisk/scripts/noanswer.sh
#####################
#! /bin /bash

sleep 7

res_sql="SELECT disposition FROM cdr WHERE uniqueid = '$1'"

answer=`mysql -u freepbxuser -pPassword_freepbxuser -D asteriskcdrdb -B -N -e "$res_sql" | grep -E -v "NO ANSWER|BUSY|FAILED|UNKNOWN" | head -n 1`

error_kod=0
if [ "$answer" != "ANSWERED" ]
then

 case $3 in
 68800)
 address="big_boss@lucky.ru"
 subject="i ett viktigt ärende"
 ;;
 63100)
 address="debian@lucky.ru"
 subject="om linux debian"
 ;;
 63200)
 address="windows@lucky.ru"
 subject="om windows"
 ;;
 63300)
 address="freebsd@lucky.ru"
 subject="om freebsd"
 ;;
 63400)
 address="ubuntu@lucky.ru"
 subject="om linux ubuntu"
 ;;
 63500)
 address="centos@lucky.ru"
 subject="om linux centos"
 ;;
 *)
 address="admin@lucky.ru"
 error_kod=1
 ;;
 esac

 case $error_kod in
 0)
 echo "Missat samtal från abonnenten $2, som ringde $subject." | mail -s "Missat samtal från $2" $address
 echo "Missat samtal till $address från abonnenten $2, som ringde $subject. uid=$1" | mail -s "Missat samtal från $2" admin@lucky.ru
 ;;
 1)
 echo "Missat samtal från $2. Tjänsten är okänd. uid=$1" | mail -s "Missat samtal från $2" admin@lucky.ru
 ;;
 esac

fi
#####################

Kort analys av skriptet:
"sleep 7":

Det handlar om den tidsfördröjning jag nämnde tidigare. Vi har en fördröjning på 7 sekunder. Jag tror dock att en sekund skulle vara tillräckligt.

"res_sql="SELECT disposition FROM cdr WHERE uniqueid = '$1'"":

SQL-frågan i mysql har vi placerat i en separat variabel för enkelhetens skull.

Vi gör sedan en förfrågan i mysql och filtrerar den mottagna utdata. Vi tar bort alla alternativ utom "ANSWERED", om det överhuvudtaget finns något sådant. Om det finns flera värden för "ANSWERED", måste vi bara behålla ett. I slutet kommer variabeln "answer" att innehålla antingen "ANSWERED" eller "".
Om värdet på variabeln "answer" inte är lika med "ANSWERED" så är det ett missat samtal. Beroende på könumret, ska vi med hjälp av case-satsen ange adressen till vem e-postaviseringen ska skickas, och vad som ska stå i detta meddelande (det föränderliga innehållet i meddelandet).

Vi överväger nu alternativet där kön är angiven i Asterisk, men inte beskriven i skriptet. I detta fall får admin@lucky.ru ett mejl om att kön är okänd för skriptet.

Om kön är beskriven kommer ett mejl att skickas dit det ska, samt en duplicerad mejl till admin@lucky.ru med angivelse av "uniqueid", för att det ska vara möjligt att spåra händelser kring detta samtal vid behov.

Här slutar skriptet.

Jag vill nämna att vi använde ett användarnamn och lösenord för att ansluta till mysql, som vi hade fått på förhand. I FreePBX, för att ta reda på användarnamnet för Asterisk i mysql, utför följande kommando:

cat /etc/amportal.conf | grep AMPDBUSER

Och för att ta reda på lösenordet för Asterisk-användaren i mysql, kör följande kommando:

cat /etc/amportal.conf | grep AMPDBPASS

Inställning av Asterisk

Vi använder FreePBX. I FreePBX finns det olika typer av konfigurationsfiler (se. https://asterisk-pbx.ru/wiki/freepbx/files), några av dem skriver FreePBX om vid omstart, och andra skriver den inte om (de kallas custom), eftersom de är speciellt avsedda för användaren.

Vi kommer att arbeta med konfigurationsfilen "extensions_override_freepbx.conf", eftersom den tillhör typen custom.

Först kontrollerar vi att filen "\/etc\/asterisk\/extensions.conf" inkluderar filen "extensions_override_freepbx.conf". För detta utför följande kommando:

cat /etc/asterisk/extensions.conf | grep extensions_override_freepbx.conf
#####################
#include extensions_override_freepbx.conf
#####################

Vi redigerar filen "\/etc\/asterisk\/extensions_override_freepbx.conf" och gör den till följande:

nano /etc/asterisk/extensions_override_freepbx.conf
#####################
[ext-queues]

exten => h,1,System(/home/asterisk/scripts/noanswer.sh ${CDR(uniqueid)} ${CALLERID(num)} ${NODEST} &)
exten => h,2,Macro(hangupcall,)

Som jag nämnde tidigare är tecknet «&» i slutet obligatoriskt. Eftersom vi arbetar med bash-skript med CDR-data direkt från mysql-databasen, och dessa data lagras i mysql först efter att «exten => h,2,Macro(hangupcall,)» har körts, är det nödvändigt att inte vänta på att bash-skriptet ska slutföras, utan att gå vidare till nästa steg i Asterisk. Och själva bash-skriptet ska innehålla en tidsfördröjning innan dess huvuddel utförs.

För att ändringar i konfigurationsfilen «/etc/asterisk/extensions_override_freepbx.conf» ska träda i kraft måste Asterisk-kärnan startas om med följande kommando:

/usr/sbin/asterisk -rx "core restart now"

Detta måste göras efter att bash-skriptet har skapats.

Slutsats

Detta är antagligen det 1001:a sättet att "fånga upp missade samtal" i Asterisk. Dela gärna med dig i kommentarerna hur du löser denna uppgift. Och vad, enligt din åsikt, kan förbättras/ändras/optimeras. Vi skulle uppskatta konstruktiva idéer.

Källa: habr.com