For API and docs, check out the homepage at http://marcelog.github.com/Nami
You can also download the distribution and doc from the CI server, at: http://ci.marcelog.name:8080/view/NodeJS/
A very similar, PHP alternative, is available at http://marcelog.github.com/PAMI An Erlang port is available at https://github.com/marcelog/erlami
Nami by itself is just a library that allows your nodejs code to communicate to an Asterisk Manager Interface (AMI). However, it includes a full application useful to monitor an asterisk installation.
You will be able to login, receive asynchronous events, and send actions (also, asynchronously receiving the according response with their optional related events).
This is supported by the Nami class (er.. function) which inherits from EventEmitter, so your application is able to subscribe to the interesting nami events.
- Nodejs (Tested with 0.6.5)
- log4js (For logging, tested with 0.3.9)
namiConnected
: Emitted when nami could successfully connect and logged in to an AMI server.namiConnection
: Emitted for all connection related events. Listen to this generic event for the status of the socket connection.namiConnection(EventName)
: Emitted for the status of the connection. States include:Connect
,End
,Error
,Timeout
, andClose
. TheError
event will emit right before theClose
event and includes the error that was thrown. TheClose
event includes a boolean value (had_error
) if an error was thrown.- namiEvent: Emitted for all events. Listen to this generic event if you want to catch any events.
namiEvent(EventName)
: These events are thrown based on the event name received. Let's say nami gets an event named "Dial", "VarSet", or "Hangup". This will emit the events: "namiEventDial", "namiEventVarSet", and "NamiEventHangup".namiLoginIncorrect
: Emitted when the login action fails (wrong password, etc).namiInvalidPeer
: Emitted if nami tried to connect to anything that did not salute like an AMI 1.1, 1.2, or 1.3.
namiRawMessage
: Whenever a full message is received from the AMI (delimited by double crlf), this is emitted to invoke the decode routine. After namiRawMessage, the decodification routine runs to properly identify this message as a response, an event that belongs to a response, or an async event from server.namiRawEvent
: Emitted when the decodification routine classified the received message as an async event from server.namiRawResponse
: Emitted when the decodification routine classified the received message as a response to an action.
$ npm install log4js
$ npm install nami
-or- Download it from this repo :)
Nami expects a configuration object, very much like this:
var namiConfig = {
host: "amihost",
port: 5038,
username: "admin",
secret: "secret"
};
$ mkdir testnami
$ cd testnami
$ npm install log4js
$ npm install nami
var nami = new (require("nami").Nami)(namiConfig);
nami.on('namiEvent', function (event) { });
nami.on('namiEventDial', function (event) { });
nami.on('namiEventVarSet', function (event) { });
nami.on('namiEventHangup', function (event) { });
process.on('SIGINT', function () {
nami.close();
process.exit();
});
nami.on('namiConnected', function (event) {
nami.send(new namiLib.Actions.CoreShowChannelsAction(), function(response){
logger.debug(' ---- Response: ' + util.inspect(response));
});
});
nami.open();
Use the property 'variables' in the actions:
var action = new namiLib.Actions.Status();
action.variables = {
'var1': 'val1'
};
nami.send(action, function(response) {
...
});
See src/index.js for a better example (including how to reconnect when the current connection closes).
That's about it.
See this gist for an example of how to connect to multiple asterisk boxes.
- Login
- Logoff
- Ping
- Hangup
- CoreShowChannels
- CoreStatus
- CoreSettings
- Status
- DahdiShowChannels
- ListCommands
- AbsoluteTimeout
- SipShowPeer
- SipShowRegistry
- SipQualifyPeer
- SipPeers
- AgentLogoff
- Agents
- AttendedTransfer
- ChangeMonitor
- Command
- CreateConfig
- DahdiDialOffHook
- DahdiDndOff
- DahdiDndOn
- DahdiHangup
- DahdiRestart
- DbDel
- DbDeltree
- DbGet
- DbPut
- ExtensionState
- GetConfig
- GetConfigJson
- GetVar
- SetVar
- JabberSend
- ListCategories
- PauseMonitor
- LocalOptimizeAway
- Reload
- PlayDtmf
- Park
- ParkedCalls
- Monitor
- ModuleCheck
- ModuleLoad
- ModuleReload
- ModuleUnload
- MailboxCount
- MailboxStatus
- VoicemailUsersList
- Originate
- Redirect
- Bridge
- UnpauseMonitor
- StopMonitor
- ShowDialPlan
- SendText
- Queues
- QueueUnpause
- QueuePause
- QueueSummary
- QueueStatus
- QueueRule
- QueueRemove
- QueueAdd
- QueueLog
- AGI
- Joshua Elson for his help in trying and debugging in loaded asterisk servers and testing with node 0.6.5 and newer npm versions
- Jon Hoult for his help in testing with AMI 1.2
- Jonathan Nicholson (rooftopsparrow) for working on exposing connection events, making reconnections a breeze.
- Moshe Brevda for his contributions