marcelog/pagi

Asterisk Gateway Interface (AGI) client for PHP, suitable to make telephony applications using call flow nodes

Friday, September 8, 2017
by marcelog
Repository
27 Watchers
128 Stars
56,000 Installations

PHP
2 Dependents
0 Suggesters
58 Forks
18 Open issues
8 Versions
1 % Grown

The README.md

, _(*1)

, _(*2)

![Click here to lend your support to: PAGI and make a donation at pledgie.com !](https://pledgie.com/campaigns/30945.png?skin_name=chrome' border='0'), _(*3)

Introduction

This framework is intended to simply making ivr applications using Asterisk's AGI, providing a nice level of abstraction over what an IVR should look like from a developers' perspective., _(*4)

Documentation

Main Site
API
Complete PAGI/PAMI talk for the PHP Conference Argentina 2013. Check the slide notes for the complete text :)
In-depth tutorial
An example IVR application that includes unit tests is available here
Professional Telephony Applications at hand The march edition of Software Developer Journal features a complete article about writing telephony applications with PAMI and PAGI.

Installing

Add this library to your Composer configuration. In composer.json:, _(*5)

  "require": {
    "marcelog/pagi": "2.*"
  }

Using it

First, make sure you include the autoloader shipped with composer:, _(*6)

require __DIR__ . '/vendor/autoload.php';

Quickstart

You can start by doc/examples/quickstart for a very basic example. You'll need something like this in your dialplan:, _(*7)

[default]
exten => 1,1,AGI(/path/to/PAGI/doc/examples/quickstart/run.sh,a,b,c,d)
exten => 1,n,Hangup

Testing IVR applications

A mocked pagi client is included to easily test your ivr applications. See doc/examples/mock to see an example of how to use it., _(*8)

Features

Nodes

For a tutorial about nodes, see this article, _(*9)

Simple Call Flow Nodes are available (see doc/examples/node/example.php). Using nodes will let you simplify how you build and test your ivr applications. Nodes are an abstraction layer above the pagi client, and support:, _(*10)

Prompts mixing sound files, playing numbers/digits/datetime's.
Cancel and End Of Input digits.
Validator callbacks for inputs, can optionally specify 1 or more sound files to play when the validation fails.
Callbacks for invalid and valid inputs.
Optional sound when no input.
Maximum valid input attempts.
Optional sound when maximum attempts has been reached.
Expecting at least/at most/exactly N digits per input.
Timeout between digits in more-than-1 digit inputs.
Timeout per input attempt.
Retry Attempts for valid inputs.
And much more!

The NodeController will let you control the call flow of your application, by registering nodes and actions based on node results. Thus, you can jump from one node to the other on cancel or complete inputs, hangup the call, execute a callback, etc. For an example, see doc/examples/nodecontroller/example.php, _(*11)

An article about the node controller is available here, _(*12)

AutoDial

CallFiles are supported. You can also schedule a call in the future., _(*13)

Fax

Sending and receiving faxes is supported using spandsp (applications SendFax and ReceiveFax)., _(*14)

Available Facades

PAGI\Client\CDR: Provided to access cdr variables.
PAGI\Client\ChannelVariables: Provided to access channel variables and asterisk environment variables.
PAGI\Client\CallerID: Provided to access caller id variables.
PAGI\Client\Result: Provided to wrap up the result for agi commands.
PAGI\CallSpool\CallFile: Call file facade.
PAGI\CallSpool\CallSpool: Call spool facade.
PAGI\Logger\Asterisk: Provides access to asterisk logger (see logger.conf in your asterisk installation).

Results

For every operation, a Result is provided. Some operations decorate this Result to add functionality, like PlayResult, ReadResult, etc. For example, a stream file will return a PlayResult, which decorates a ReadResult which in turn, decorated a Result., _(*15)

PAGI\Client\DialResult
PAGI\Client\ExecResult
PAGI\Client\ReadResult
PAGI\Client\PlayResult
PAGI\Client\FaxResult

Debugging, logging

You can optionally set a PSR-3 compatible logger:, _(*16)

$pagi->setLogger($logger);

By default, the client will use the NullLogger., _(*17)

Developers

This project uses phing. Current tasks include: * test: Runs PHPUnit. * cs: Runs CodeSniffer. * doc: Runs PhpDocumentor. * md: runs PHPMD. * build: This is the default task, and will run all the other tasks., _(*18)

Running a phing task

To run a task, just do:, _(*19)

vendor/bin/phing build

Contributing

To contribute: * Make sure you open a concise and short pull request. * Throw in any needed unit tests to accomodate the new code or the changes involved. * Run phing and make sure everything is ok before submitting the pull request (make phpmd and CodeSniffer happy, also make sure that phpDocumentor does not throw any warnings, since all our documentation is automatically generated). * Your code must comply with PSR-2, CodeSniffer should take care of that., _(*20)

LICENSE

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at, _(*22)

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License., _(*23)

The Versions

08/09 2017

dev-master

9999999-dev http://marcelog.github.com/PAGI

Asterisk Gateway Interface (AGI) client for PHP, suitable to make telephony applications using call flow nodes

Sources Download

Apache-2.0

The Requires

php >=5.3.3
psr/log >= 1.0.0

The Development Requires

by Marcelo Gornstein

voip client flow asterisk agi ivr node call telephony

03/01 2016

v2.0.0

2.0.0.0 http://marcelog.github.com/PAGI

Asterisk Gateway Interface (AGI) client for PHP, suitable to make telephony applications using call flow nodes

Sources Download

Apache-2.0

The Requires

php >=5.3.3
psr/log >= 1.0.0

php >=5.3.3

by Marcelo Gornstein

voip client flow asterisk agi ivr node call telephony

library pagi

Asterisk Gateway Interface (AGI) client for PHP, suitable to make telephony applications using call flow nodes

marcelog/pagi

The README.md

Introduction

Documentation

Installing

Using it

Quickstart

Testing IVR applications

Features

Nodes

AutoDial

Fax

Available Facades

Results

Debugging, logging

Developers

Running a phing task

Contributing

LICENSE

The Versions

dev-master

The Requires

The Development Requires

by Marcelo Gornstein

v2.0.0

The Requires

The Development Requires

by Marcelo Gornstein

1.12.0.x-dev

The Requires

by Marcelo Gornstein

1.11.0.1

The Requires

by Marcelo Gornstein

1.10.4-p1

The Requires

by Marcelo Gornstein

1.11.0

The Requires

by Marcelo Gornstein

1.10.6

The Requires

by Marcelo Gornstein

1.10.7

The Requires

by Marcelo Gornstein