Likes: 
Introductie
Gezien er al genoeg HOWTO's zijn over hoe je een Asterisk-server opzet en deze koppelt aan diverse VOIP- en PSTN-netwerken, maar eens even heel iets anders.
In deze tutorial zal ik uitleggen hoe je de nummerherkenning in Asterisk kan uitbreiden met de namen van de bellers. De bedoeling is een eenvoudig maar compleet werkend voorbeeld te presenteren dat je zelf naar eigen wens kan uitbreiden.
Technische basis
We maken gebruik van de AGI-interface in Asterisk. Dit is vergelijkbaarheid met CGI's in je webserver. Maar -zoals duidelijk mag zijn- dan om de functionaliteit van je VOIP-server uit te breiden. In dit voorbeeld maken we gebruik van PHP als programmeertaal met MySQL als backend voor het telefoonboek. Ik ga ervanuit dat iedereen hier deze tools wel klaar voor gebruik heeft.
Tenslotte ga ik ervanuit dat je over een toestel beschikt dat niet alleen nummers, maar ook namen kan weergeven. Veel VOIP-toestellen kunnen dit wel, maar de goedkopere Grandstream-toestellen bijvoorbeeld niet, en ook mensen met een gewone telefoon aangesloten op een ATA zullen hier geen profijt van trekken.
PHPAGI package
Om eenvoudig AGI's te kunnen programmeren in PHP is er het PHPAGI-project. Download de tarball van http://phpagi.sourceforge.net/ en pak het zaakje uit. De PHP-scripts in de hoofdmap hiervan zet je in je /var/lib/asterisk/agi-bin directory.
Een eerste testscript
Lekker snel to the point nu. We willen immers resultaat zien!
Maak het bestand callerid.php in /var/lib/asterisk/agi-bin/ waarbij je in het onderstaande voorbeeld de variabele $miniBook kan vullen met nummers en namen.
Pas je dialplan aan in /etc/asterisk/extensions.conf, stel je dialplan voor vanaf extern is:PHP Code:#!/usr/local/bin/php -q
<?php
// agi stuff
require "phpagi.php";
$agi = new AGI();
$as = $agi->new_AsteriskManager();
// get callerid
$cid = $agi->parse_callerid();
$callernum = $cid["username"];
if (substr($callernum, 0, 4) == "0031") $callernum = "0".substr($callernum, 4);
if (substr($callernum, 0, 2) == "31") $callernum = "0".substr($callernum, 2);
// mini-adresboek
$miniBook = array();
$miniBook["020638ENZO"] = "Basemotive";
$miniBook["06ENZOENZO"] = "Ikzelf GSM";
foreach ($miniBook as $nr => $name) {
if ($nr == $callernum) {
$agi->set_callerid("\"$name\"<$callernum>");
exit;
}
}
?>
dan voeg je daar een aanroep voor callerid.agi in. Het wordt dan:Code:[from-external] exten => _X.,1,Verbose(Call from ${CALLERIDNUM} to ${EXTEN}) exten => _X.,2,Ringing exten => _X.,3,Dial(SIP/200,60,tT)
Zodra je nu vanaf een van de bekende nummers belt zal je zien dat op je telefoontoestel de naam van die beller zal verschijnen.Code:[from-external] exten => _X.,1,Verbose(Call from ${CALLERIDNUM} to ${EXTEN}) exten => _X.,2,Ringing exten => _X.,3,agi,callerid.php exten => _X.,4,Dial(SIP/200,60,tT)
De volgende stap: MySQL
Als je heel erg veel namen wilt plaatsen, of je telefoonboek via het web toegankelijk wilt maken, dan wil je natuurlijk je gegevens in een database zetten. Hier geef ik een voorbeeld met MySQL.
Maak een MySQL-database aan voor deze zaken, en maak de pbook-tabel met de volgende query:
vul je tabel met wat gegevens:Code:create table pbook ( phone text, name text );
Vul je callerid.php-script met de volgende code:Code:insert into pbook values ('06ENZOENZO', 'Ikzelf GSM');
Als alles klopt zal je nu ook zien dat keurig een naam wordt weergegeven op het display. Je kan nu zelf een web-applicatie maken waarmee je het telefoonboek kan vullen (als je dat wilt natuurlijk).PHP Code:#!/usr/local/bin/php -q
<?php
// settings
$dbhost = "localhost";
$dbuser = "foonboek";
$dbname = "foonboek";
$dbpass = "f7892JeDO";
// agi stuff
require "phpagi.php";
$agi = new AGI();
$as = $agi->new_AsteriskManager();
// get callerid
$cid = $agi->parse_callerid();
$callernum = $cid["username"];
if (substr($callernum, 0, 4) == "0031") $callernum = "0".substr($callernum, 4);
if (substr($callernum, 0, 2) == "31") $callernum = "0".substr($callernum, 2);
// connect to db
mysql_connect($dbhost, $dbuser, $dbpass) or die ("Failed to connect to the database!");
mysql_select_db($dbname) or die(mysql_error());
// No caller-id? Show 'Onbekend'
if ($result_cid == "" && ($callernum == "" || $callernum == "asterisk"))
$result_cid = "\"Onbekend\"<onbekend>";
// check local phonebook
if ($result_cid == "") {
$query = "select * from pbook where phone = '$callernum'";
$result = mysql_query($query) or die(mysql_error());
if ($row = mysql_fetch_array($result))
$result_cid = "\"".$row["name"]."\"<$callernum>";
}
// Unknown......
if ($result_cid == "") {
$result_cid = "\"$callernum\"<$callernum>";
}
$agi->set_callerid($result_cid);
?>
Het ultieme telefoonboek: De CD-foongids
Wil je echt heel graag veel namen zien, maar heb je geen zin om alle vage bekenden die je ooit weleens bellen in de database te gaan lopen kloppen, weet dan dat een ander al voor je heeft zitten kloppen.
Met een CD-foongids en het programma Foondump heb je de mogelijkheid je MySQL-database in no-time te vullen met een hele berg namen en nummers. Let op: Met de implementatie hiervan balanceer je op het randje van de wet. Ik laat jullie dit zien omdat het technisch gezien KAN. Zorg voor jezelf dat je je aan de regelgevingen houdt.
De foondump-documentatie vertelt genoeg over hoe je de gegevens in een database krijgt. Dat hoef ik volgens mij niet verder toe te lichten.
Afijn. Genoeg gezeurd. Hier is het laatste stukje PHP-code. De fijne query voor het zoeken van een naam bij een nummer heb ik onttrokken aan het programma fs2005.php dat ook op de foondump-site te vinden is.
Het volgende fragment plaats je boven de laatste regel (die met 'agi->...'):
SlotsomPHP Code:// check public phonebook
if ($result_cid == "") {
$query = "select white_subscriber.*, (housenumber+0.00) as housenr, count(white_info.id) as infocnt from white_subscriber ,white_phonenumber left join white_info on white_info.id = white_subscriber.id where white_phonenumber.phone='$callernum' and white_phonenumber.id = white_subscriber.id group by white_subscriber.id, white_info.id order by postalcode,housenr limit 1";
$result = mysql_query($query) or die(mysql_error());
if ($row = mysql_fetch_array($result)) {
$name = $row["firstname"]." ".($row["infix"]?$row["infix"]." ":"").$row["lastname"];
$result_cid = "\"$name\"<$callernum>";
}
}
Zoals ik heb laten zien is de functionaliteit van Asterisk middels AGI op eenvoudige wijze uit te breiden. Ik hoop dat jullie hier iets aan hebben, en er zo mogelijk zelfs nog iets van geleerd hebben. Laat me weten of dit leuk gevonden wordt!
De voorbeelden hier steken niet perfect in elkaar. Zorg dat je in een productie-omgeving de variabelen goed checkt en je variabelen in queries netjes afhandelt.
Vervolg?
Indien er interesse is kan ik bijvoorbeeld nog uit de doeken doen hoe je met AGI bepaalt welke toestellen er over moeten gaan, en dit zelfs web-based kan configureren.
Of misschien hebben jullie meer interesse in de Manager API. Ook hiermee zijn leuke dingen te realiseren.
Quote
Ziet er netjes uit
Oorspronkelijk geplaatst door XBL
