PoundTeam Avatar Beta Instructions
Contents
First: Create an "Avatar"
- You will be given a link similar to: http://IP_OR_DOMAIN/poundteam/edit_avatar_names.php
This link is used to create "Named" Avatars. The Avatar Name is how buttons are Grouped. Create as many Names as you like. This can be one for each agent, or one for each Product.
Second: Add buttons to the Avatar you just created/named
- You will be given a link similar to: http://IP_OR_DOMAIN/poundteam/edit_avatars.php
This link is used to assign Recording Buttons to each Avatar.
Each recording can be sorted (to control the order they appear on the agent page). The sort feature is per Avatar and only affects the Avatar to which this recording is assigned. So one Avatar may have numbers like "1000, 2000, 3000" and another Avatar may have "15,16,17".
"Button text" and "script" will appear on the agent screen if the alignment is "V" (Vertical). If the alignment is "H", the "script" text will not be seen by the agent.
Filenames should NOT include the file extension. Thus, if your system allows manually editing the filenames, do NOT add ".WAV" to a filename.
Files must have the underscore ("_") as the Fifth Character to appear in the dropdown. This allows you to use the first four characters as an internal code while also avoiding having 200 unnecessary audio files in the dropdown. This can be easily changed (or removed entirely) upon request during installation with no extra charge (or within a day or two if you did not understand before installation).
DO NOT add a file that has not been confirmed to be a valid, playable, asterisk sound.
DO NOT delete a file that is still on a button. Some versions of asterisk will occasionally continually attempt to play an invalid or missing sound until it crashes the server and requires a restart. (It's beta, and to date no on has paid for the addition of validation that a file exists before playing it.)
Active can be changed to "N" for temporarily removing a button without deleting it (of course, you could also create an avatar named "Inactive" and just change the recordings to that Avatar for safekeeping ...).
Align = "H" will cause the button (and those that follow if they also have "H" to take up less room and stack several per line on the agent screen. It also hides the "script" text from the agent. Useful for things like numbers and states or even just to allow More Buttons on the screen.
Third: Modify Campaign for Avatar
Simple Web Form
- Modify a campaign to include "Web Form = http://DOMAIN_OR_IP/poundteam/Avatar1.php?avatar=Avatar2"
- Be sure to set avatar=XXXX" to an actual "named avatar" which you created earlier!
- Log in as agent to this campaign, manual dial another phone, click on "web form", and then click on one of the Avatar buttons and experience sound.
Note: It is expected that the agent close the web form after each client. The web form is connected to the Meetme Room of the agent. IF the agent transfers a client, the Meetme Room of the agent may change. This would cause the agent's Avatar buttons to remain connected to the room the previous client was in!
Audio
Audio must be loaded using the Audio Store unless you directly place the audio in /var/lib/asterisk/sounds
Remember to verify the format using telephone, playing the audio in a web browser is not valid.
DO NOT delete a file that is still on a button. Some versions of asterisk will occasionally continually attempt to play an invalid or missing sound until it crashes the server and requires a restart. (It's beta, and to date no on has paid for the addition of validation that a file exists before playing it.)
Customization
The file "Avatar1.php" should not be altered if you choose to customize the system. Create a copy ("Avatar2.php"?) and modify the copy instead. Then, when there's an upgrade to this package, we can update your Avatar1.php file and you can run a DIFF against the original and apply those same changes to any page you created.
Avatar1.php does use javascript and AJAX functions, but is not all that complex. It can be easily customized by any PHP/Javascript programmer that knows what he's doing.
