Asterisk: How to setup Agent Status on Polycom Idle Display

Polycom Soundpoint IP 550 idle display screen


This tutorial describes how to configure the idle display screens on Polycom phones to subscribe to a XHTML file that reads their Agent status from Asterisk.  When the phone is not in active use it displays the web page.

My tutorial has three components.  A specific Polycom option(found in sip.cfg) added to the configuration file of each phone, a BASH script I wrote, and a little Asterisk configuration.  This tutorial assumes you have a working Asterisk 1.6+ PBX with a basic queue setup.  It also assumes you are using automatic web provisioning of your Polycom phones.

Here is a link to my previous article on  configuring Polycom SoundPoint IP phones for Asterisk:

How to configure a Polycom SoundPoint IP phone for Asterisk on Fedora 10

To get the idle display screen to work correctly we will need to modify our standard configuration file a bit.  Navigate to the FTP/HTPP directory you provision your phones from.  Edit an Agent phone similar to the following,


I created a BASH script that generates a XHTML file that each phone subscribes too. When an agent logs onto the ‘Sales Queue’ the script is executed, resulting in XHTML that will read, “Logged in as 189”.  The file is saved by default to the apache web located at ‘/var/www/html/polycom’.  So please create a directory named polycom in your web root; or modify the script to fit your needs.

Polycom SoundPoint IP idle display screen

Idle Display screen subcribes to 189.xhtml. Each phone has it’s own web page!

A similar script is called when an Agent logs out, /etc/asterisk/bin/agent-status-logoff.script: /etc/asterisk/extensions.conf:

Below is an example of a context called ‘utilities’ that includes an extension for logging into and out of a queue named ‘sales’.  When a Agent successfully enters the ‘sales’ queue ‘’ is executed with ‘${CALLERID(num)}’ as the positional parameter(in BASH parlance $1).  The result is that a simple XHTML file named after the extension is created.  Every three seconds the phone updates this XHTML file.  The phone displays this page when not in use.




Asterisk combined with feature rich Polycom Soundpoint IP phones provide a high quality feature rich Call Center environment. If you have any questions, suggestions, or improvements please post!

Written by mattb in: Asterisk,Scripts | Tags: , , , ,

No Comments »

RSS feed for comments on this post. TrackBack URL

Leave a comment