This section explains how to install the AMIgo controls into the development environment and to setup an asterisk system's Manager Interface for access.

Adding the AMIgo Controls to Visual Studio Toolbox

To add AMIgo components and controls to the Visual Studio Toolbox, follow this procedure

  • Create a new Windows Form Application
  • In the project manager, double click the main form to open it in design mode.
  • Open the toolbox if not already opened. (Menu View | Toolbox or CTRL+W, X)
  • Right click on the Toolbox and select Add Tab, and name the new Tab AMIgo
  • Right click in the new AMIgo Tab and select 'Choose Items...'
  • Click on the Browse button, and browse and select the AMIgo.dll file. (Default \Program Files\TELE DATA Inc\AMIgo)
  • Select all controls and component that are part of the AMIgo Namespace (you can sort the list by namspace for easier selection)
  • Once completed the AMIgo Tab of the toolbox should contains all of the AMIgo controls.

Adding a reference to AMIgo.dll to a project

To add a reference to AMIgo.dll to a Windows Form Application, follow this procedure

  • Create a new Windows Form Application
  • In the Solution Manager, right click on the 'References' directory and select 'Add reference ...'
  • Select the 'Browse' tab and browse to and select the AMIgo.dll file from the installation directory.

Note

The default installation directory is "\Program Files\TELE DATA Inc\AMIgo"

Setting up an Asterisk system to access the manager interface.

The manager is a client/server model over TCP. With the manager interface, you'll be able to control the PBX, originate calls, check mailbox status, monitor channels and queues as well as execute Asterisk commands. AMI is the standard management interface into your Asterisk server. You configure AMI in manager.conf. By default, AMI is available on TCP port 5038 if you enable it in manager.conf.

AMI receive commands, called "actions". These generate a "response" from Asterisk. Asterisk will also send "Events" containing various information messages about changes within Asterisk. Some actions generate an initial response and data in the form list of events. This format is created to make sure that extensive reports do not block the manager interface fully.

Management users are configured in the configuration file manager.conf and are given permissions for read and write, where write represents their ability to perform this class of "action", and read represents their ability to receive this class of "event".

Here an example of a manager.conf file with a single account for the user 'admin'

CopyC#
 1[general]
 2enabled = yes        ; Enable the AMI
 3webenabled = yes    ; Enable HTTP access (used by Asterisk GUI)
 4port = 5038        ; Use the default port
 5bindaddr = 0.0.0.0    ; Listen for all IP address
 6displayconnects = yes    ; display connections (In CLI))
 7timestampevents = yes    ; Add a unix timestamp to event messages.
 8
 9; Define an account for username 'admin' with password 'mypwd'
10[admin]
11secret = mypwd
12read = system,call,log,verbose,command,agent,user,config
13write = system,call,log,verbose,command,agent,user,config

Note

If the Asterisk system uses the Asterisk GUI, there will be a manager account already configured on the system, with default username 'admin'. You can use this account to connect with the AMI_Client if desired.