I’ve been working on a very cool project project here at Vale Presente which was able to provide a smooth interface to our call center attendees increasing their productivity and quality of our costumer service. The project was built with HTML5, CSS3, Javascript and Node.js as our backend engine (only cool stuff!). But the main challenge was finding the right tool to get the job done in a fast and consistent manner. I’m not going to talk about how I built the client. My focus here is talk about the tool I used to create a fast and consistent connection between the attendees and Asterisk. That was tough. There are a lot of libraries available over the Internet but most of them aren’t production ready.
Production ready
During my quest I had the pleasure to meet asterisk-manager. A Asterisk Manager Interface created by Philipp Dunkel which is a node.js module for interacting with the Asterisk Manager API. Nowdays I’m helping him as a maintainer of the project, improving, fixing bugs and helping to increase the project’s visibility. Not just because I’m a maintainer but because it works!
Currently the asterisk-manager module/package for node.js is handling incredibly well more than 500,000 asterisk events and ~5,000 voice calls a day. All of those events are being transmitted to our clients through Socket.io. This is a production ready and tested solution.
How to use it
Pretty simple. First you have to install it directly:
[javascript]
npm install asterisk-manager
[/javascript]
Or put it inside of your package.json:
[javascript]
{
"dependencies": {
"asterisk-manager": "0.1.x"
}
}
[/javascript]
Now you have to create a connection instance with your asterisk server:
[javascript]
var AsteriskManager = require(‘asterisk-manager’)
, ami = new AsteriskManager(config.asterisk.port, config.asterisk.host, config.asterisk.user, config.asterisk.password, true)
;
[/javascript]
And that’s it! It works! Now you have to take a closer look inside of the available events and actions and have fun!
Events
The list of all available events which is supported by Asterisk Manager API can be found here: https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+AMI+Events How do I listen for any/all AMI events?
[javascript]
ami.on(‘managerevent’, function(evt) {});
[/javascript]
How do I listen for specific AMI events?
[javascript]
ami.on(‘hangup’, function(evt) {});
ami.on(‘confbridgejoin’, function(evt) {});
[/javascript]
What if my connection dropped? You can listen to the connection events like:
[javascript]
ami.on(‘close’, function(e) {});
ami.on(‘disconnect’, function(e) {});
ami.on(‘connect’, function(e) {});
[/javascript]
And make your own decision on what do to next.
Actions
The list of all available actions supported by Asterisk Manager API can be found here: https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+AMI+Actions How do I call an action?
[javascript]
ami.action({
‘action’:’originate’,
‘channel’: "SIP/1234",
‘exten’: ‘1143224321’,
‘context’: ‘from-internal’,
‘priority’: ‘1’
}, function(err, res) {});
[/javascript]
And that’s it! Have fun!
Github: https://github.com/pipobscure/NodeJS-AsteriskManager NPM Repository: https://www.npmjs.org/package/asterisk-manager Bug Reports: https://github.com/pipobscure/NodeJS-AsteriskManager/issues
Igor Escobar 
Hi,
I am trying to use asterisk-manager with nodejs. I have a running nodejs server at port 3000. Now I want to connect to my asterisk server and for that I am using asterisk-manager.
a)In the node_modules folder I have the package ‘asterisk-manager’, and in the main package.json under dependencies I added the line “asterisk-manager”: “0.1.x” and restarted the nodejs server.
But when I try to connect the AMI using the command
var AsteriskManager = require(‘asterisk-manager’);
var ami = new AsteriskManager(‘5038′,’serverip’,’user’,’passwd’, true);
it throws an error ‘ReferenceError: AsteriskManager is not defined’
Am I missing anything? Please let me know.
Thanks
LikeLike
Dear Igor, how to catch error ‘Authentication failed’ from function ManagerLogin in client code without analize raw events ?
LikeLike
Hello,
I am trying to print the peer statues on browser using node and socket.io, Till the data what i understood i think io.emit will help me to print my peers on browser. I get the status of peers on my terminal i want to print it upon browser to please help me for the same.
Below is my code to fetch peer status on terminal
:ami.connect(function(response){
console.log(‘connected to the AMI’);
setInterval(function(){
//ami.send({action: ‘Sippeers’,peer :’7010_rtcbiz’});
ami.send({action: ‘SIPpeerstatus’});
// ami.send({action: ‘sip show peer 7010_rtcbiz’});//run a callback event when we have connected to the socket
}, 6000);
});
LikeLike
How to answer incoming call with ami?
LikeLike
Hello Igor ,
sorry , but I do not understand how perform a meetme list #room and get the result .
There i some other site where I’ll find some docs ?
I coded :
ami.action({
‘action’:’meetmelist’
}, function(err, res) {
console.log(res);
});
Res = server listening on localhost:8000
{ response: ‘Success’,
actionid: ‘1467211204530’,
eventlist: ‘start’,
message: ‘Meetme user list will follow’ }
same with :
ami.action({
‘action’:’meetmelist’,
‘conference’: ‘12345’
}, function(err, res) {
console.log(res);
});
Many thanks .
LikeLike
Bom dia Igor, tudo bom ?
Queria ver contigo se tu me daria um workshop dessa aplicacao.
LikeLike