mirror of
https://github.com/asterisk/asterisk.git
synced 2025-10-12 15:45:18 +00:00
Many doc directory improvements, including:
- Added development section (backtrace.tex) - Correct filesystem path formating - Replace all "|" argument separator to "," - Endless count of spaces at the end of line - Using astlisting to make listings do not take so much place - Take back ASTRISKVERSION on first page - Make localchannel.tex readable by inserting extra end of lines (closes issue #10962) Reported by: IgorG Patches: texdoc-85177-1.patch uploaded by IgorG (license 20) git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@85519 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
Russell Bryant
@@ -2,7 +2,7 @@
|
||||
\section{Introduction}
|
||||
|
||||
Pardon, but the dialplan in this tutorial will be expressed
|
||||
in AEL, the new Asterisk Extension Language. If you are
|
||||
in AEL, the new Asterisk Extension Language. If you are
|
||||
not used to its syntax, we hope you will find it to some
|
||||
degree intuitive. If not, there are documents explaining
|
||||
its syntax and constructs.
|
||||
@@ -15,6 +15,7 @@ First of all, set up call queues in queue.conf
|
||||
|
||||
Here is an example:
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
=========== queues.conf ===========
|
||||
| ; Cool Digium Queues |
|
||||
@@ -46,8 +47,9 @@ Here is an example:
|
||||
| leavewhenempty=strict |
|
||||
===================================
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
In the above, we have defined 3 separate calling queues:
|
||||
In the above, we have defined 3 separate calling queues:
|
||||
sales-general, customerservice, and dispatch.
|
||||
|
||||
Please note that the sales-general queue specifies a
|
||||
@@ -58,16 +60,16 @@ contexts must be defined somewhere in your dialplan.
|
||||
We will show them after the main menu below.
|
||||
|
||||
In the [general] section, specifying the persistentmembers=yes,
|
||||
will cause the agent lists to be stored in astdb, and
|
||||
will cause the agent lists to be stored in astdb, and
|
||||
recalled on startup.
|
||||
|
||||
The strategy=ringall will cause all agents to be dialed
|
||||
together, the first to answer is then assigned the incoming
|
||||
call.
|
||||
call.
|
||||
|
||||
"joinempty" set to "strict" will keep incoming callers from
|
||||
being placed in queues where there are no agents to take calls.
|
||||
The Queue() application will return, and the dial plan can
|
||||
The Queue() application will return, and the dial plan can
|
||||
determine what to do next.
|
||||
|
||||
If there are calls queued, and the last agent logs out, the
|
||||
@@ -80,11 +82,12 @@ set to "strict".
|
||||
|
||||
Then in extensions.ael, you can do these things:
|
||||
|
||||
\subsubsection{The Main Menu}
|
||||
\subsubsection{The Main Menu}
|
||||
|
||||
At Digium, incoming callers are sent to the "mainmenu" context, where they
|
||||
are greeted, and directed to the numbers they choose...
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
context mainmenu {
|
||||
|
||||
@@ -93,10 +96,10 @@ context mainmenu {
|
||||
queues-loginout;
|
||||
}
|
||||
|
||||
0 => goto dispatch|s|1;
|
||||
2 => goto sales|s|1;
|
||||
3 => goto customerservice|s|1;
|
||||
4 => goto dispatch|s|1;
|
||||
0 => goto dispatch,s,1;
|
||||
2 => goto sales,s,1;
|
||||
3 => goto customerservice,s,1;
|
||||
4 => goto dispatch,s,1;
|
||||
|
||||
s => {
|
||||
Ringing();
|
||||
@@ -133,13 +136,15 @@ context mainmenu {
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
\subsubsection{The Contexts referenced from the queues.conf file}
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
context sales {
|
||||
|
||||
0 => goto dispatch|s|1;
|
||||
0 => goto dispatch,s,1;
|
||||
8 => Voicemail(${SALESVM});
|
||||
|
||||
s => {
|
||||
@@ -151,18 +156,20 @@ context sales {
|
||||
WaitExten(0.3);
|
||||
Background(digium/AtAnyTimeYouMayPress0ToSpeakWithAnOperatorOr8ToLeaveAMessage);
|
||||
Set(CALLERID(name)=Sales);
|
||||
Queue(sales-general|t);
|
||||
Queue(sales-general,t);
|
||||
Set(CALLERID(name)=EmptySalQ);
|
||||
goto dispatch|s|1;
|
||||
goto dispatch,s,1;
|
||||
Playback(goodbye);
|
||||
Hangup();
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
Please note that there is only one attempt to queue a call in the sales queue. All sales agents that
|
||||
are logged in will be rung.
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
context customerservice {
|
||||
|
||||
@@ -183,11 +190,11 @@ context customerservice {
|
||||
Background(digium/AtAnyTimeYouMayPress0ToSpeakWithAnOperatorOr8ToLeaveAMessage);
|
||||
Set(CALLERID(name)=Cust Svc);
|
||||
Set(QUEUE_MAX_PENALTY=10);
|
||||
Queue(customerservice|t);
|
||||
Queue(customerservice,t);
|
||||
Set(QUEUE_MAX_PENALTY=0);
|
||||
Queue(customerservice|t);
|
||||
Queue(customerservice,t);
|
||||
Set(CALLERID(name)=EmptyCSVQ);
|
||||
goto dispatch|s|1;
|
||||
goto dispatch,s,1;
|
||||
Background(digium/NoCustomerServiceRepresentativesAreAvailableAtThisTime);
|
||||
Background(digium/PleaseLeaveAMessageInTheCustomerServiceVoiceMailBox);
|
||||
Voicemail(${CUSTSERVVM});
|
||||
@@ -196,11 +203,13 @@ context customerservice {
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
Note that calls coming into customerservice will first be try to queue
|
||||
calls to those agents with a QUEUE\_MAX\_PENALTY of 10, and if none are available,
|
||||
then all agents are rung.
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
context dispatch
|
||||
{
|
||||
@@ -226,21 +235,22 @@ context dispatch
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
And in the dispatch context, first agents of priority 10 are tried, then
|
||||
20, and if none are available, all agents are tried.
|
||||
20, and if none are available, all agents are tried.
|
||||
|
||||
Notice that a common pattern is followed in each of the three queue contexts:
|
||||
|
||||
First, you set QUEUE\_MAX\_PENALTY to a value, then you call
|
||||
Queue($<$queue-name$>$,option,...) (see the Queue application documetation for details)
|
||||
|
||||
In the above, note that the "t" option is specified, and this allows the
|
||||
agent picking up the incoming call the luxury of transferring the call to
|
||||
In the above, note that the "t" option is specified, and this allows the
|
||||
agent picking up the incoming call the luxury of transferring the call to
|
||||
other parties.
|
||||
|
||||
The purpose of specifying the QUEUE\_MAX\_PENALTY is to develop a set of priorities
|
||||
amongst agents. By the above usage, agents with lower number priorities will
|
||||
amongst agents. By the above usage, agents with lower number priorities will
|
||||
be given the calls first, and then, if no-one picks up the call, the QUEUE\_MAX\_PENALTY
|
||||
will be incremented, and the queue tried again. Hopefully, along the line, someone
|
||||
will pick up the call, and the Queue application will end with a hangup.
|
||||
@@ -251,12 +261,12 @@ to zero, which means to try all available agents.
|
||||
|
||||
\subsection{Assigning agents to Queues}
|
||||
|
||||
In this example dialplan, we want to be able to add and remove agents to
|
||||
In this example dialplan, we want to be able to add and remove agents to
|
||||
handle incoming calls, as they feel they are available. As they log in,
|
||||
they are added to the queue's agent list, and as they log out, they are
|
||||
removed. If no agents are available, the queue command will terminate, and
|
||||
it is the duty of the dialplan to do something appropriate, be it sending
|
||||
the incoming caller to voicemail, or trying the queue again with a higher
|
||||
the incoming caller to voicemail, or trying the queue again with a higher
|
||||
QUEUE\_MAX\_PENALTY.
|
||||
|
||||
Because a single agent can make themselves available to more than one queue,
|
||||
@@ -265,6 +275,7 @@ dialplan.
|
||||
|
||||
\subsubsection{Agents Log In and Out}
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
context queues-loginout
|
||||
{
|
||||
@@ -284,14 +295,16 @@ context queues-loginout
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
In the above contexts, the agents dial 6092 to log into their queues,
|
||||
and they dial 6093 to log out of their queues. The agent is prompted
|
||||
for their agent number, and if they are logging in, their passcode,
|
||||
and then they are transferred to the proper extension in the
|
||||
queues-manip context. The queues-manip context does all the
|
||||
for their agent number, and if they are logging in, their passcode,
|
||||
and then they are transferred to the proper extension in the
|
||||
queues-manip context. The queues-manip context does all the
|
||||
actual work:
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
context queues-manip {
|
||||
|
||||
@@ -324,27 +337,29 @@ context queues-manip {
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
In the above extensions, note that the queue-addremove macro is used
|
||||
to actually add or remove the agent from the applicable queue,
|
||||
with the applicable priority level. Note that agents with a
|
||||
with the applicable priority level. Note that agents with a
|
||||
priority level of 10 will be called before agents with levels
|
||||
of 20 or 30.
|
||||
|
||||
In the above example, Raquel will be dialed first in the dispatch
|
||||
queue, if she has logged in. If she is not, then the second call of
|
||||
Queue() with priority of 20 will dial Brittanica if she is present,
|
||||
otherwise the third call of Queue() with MAX\_PENALTY of 0 will
|
||||
otherwise the third call of Queue() with MAX\_PENALTY of 0 will
|
||||
dial Rock and Saline simultaneously.
|
||||
|
||||
Also note that Rock will be among the first to be called in the sales-general
|
||||
Also note that Rock will be among the first to be called in the sales-general
|
||||
queue, and among the last in the dispatch queue. As you can see in
|
||||
main menu, the callerID is set in the main menu so they can tell
|
||||
main menu, the callerID is set in the main menu so they can tell
|
||||
which queue incoming calls are coming from.
|
||||
|
||||
The call to queue-success() gives some feedback to the agent
|
||||
as they log in and out, that the process has completed.
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
macro queue-success(exten)
|
||||
{
|
||||
@@ -362,9 +377,11 @@ macro queue-success(exten)
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
The queue-addremove macro is defined in this manner:
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
macro queue-addremove(queuename,penalty,exten)
|
||||
{
|
||||
@@ -397,6 +414,7 @@ macro queue-addremove(queuename,penalty,exten)
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
Basically, it uses the first character of the exten variable, to determine the
|
||||
proper actions to take. In the above dial plan code, only the cases I or O are used,
|
||||
@@ -408,6 +426,7 @@ which correspond to the Login and Logout actions.
|
||||
Notice in the above, that the commands to manipulate agents in queues have
|
||||
"@agents" in their arguments. This is a reference to the agents context:
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
context agents
|
||||
{
|
||||
@@ -415,21 +434,21 @@ context agents
|
||||
8010 =>
|
||||
{
|
||||
Set(QUEUE_MAX_PENALTY=10);
|
||||
Queue(sales-general|t);
|
||||
Queue(sales-general,t);
|
||||
Set(QUEUE_MAX_PENALTY=0);
|
||||
Queue(sales-general|t);
|
||||
Queue(sales-general,t);
|
||||
Set(CALLERID(name)=EmptySalQ);
|
||||
goto dispatch|s|1;
|
||||
goto dispatch,s,1;
|
||||
}
|
||||
// Customer Service queue
|
||||
8011 =>
|
||||
{
|
||||
Set(QUEUE_MAX_PENALTY=10);
|
||||
Queue(customerservice|t);
|
||||
Queue(customerservice,t);
|
||||
Set(QUEUE_MAX_PENALTY=0);
|
||||
Queue(customerservice|t);
|
||||
Queue(customerservice,t);
|
||||
Set(CALLERID(name)=EMptyCSVQ);
|
||||
goto dispatch|s|1;
|
||||
goto dispatch,s,1;
|
||||
}
|
||||
8013 =>
|
||||
{
|
||||
@@ -442,7 +461,7 @@ context agents
|
||||
Queue(support-dispatch,t);
|
||||
Set(QUEUE_MAX_PENALTY=0); // means no max
|
||||
Queue(support-dispatch,t);
|
||||
goto dispatch|s|1;
|
||||
goto dispatch,s,1;
|
||||
}
|
||||
6121 => &callagent(${RAQUEL},${EXTEN});
|
||||
6165 => &callagent(${SPEARS},${EXTEN});
|
||||
@@ -450,27 +469,29 @@ context agents
|
||||
6070 => &callagent(${SALINE},${EXTEN});
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
In the above, the variables \${RAQUEL}, etc stand for
|
||||
actual devices to ring that person's
|
||||
phone (like Zap/37).
|
||||
|
||||
The 8010, 8011, and 8013 extensions are purely for transferring
|
||||
incoming callers to queues. For instance, a customer service
|
||||
agent might want to transfer the caller to talk to sales. The
|
||||
incoming callers to queues. For instance, a customer service
|
||||
agent might want to transfer the caller to talk to sales. The
|
||||
agent only has to transfer to extension 8010, in this case.
|
||||
|
||||
Here is the callagent macro, note that if a person in the
|
||||
queue is called, but does not answer, then they are automatically
|
||||
removed from the queue.
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
macro callagent(device,exten)
|
||||
{
|
||||
if( ${GROUP_COUNT(${exten}@agents)}=0 )
|
||||
{
|
||||
Set(OUTBOUND_GROUP=${exten}@agents);
|
||||
Dial(${device}|300|t);
|
||||
Dial(${device},300,t);
|
||||
switch(${DIALSTATUS})
|
||||
{
|
||||
case BUSY:
|
||||
@@ -478,7 +499,7 @@ macro callagent(device,exten)
|
||||
break;
|
||||
case NOANSWER:
|
||||
Set(queue-announce-success=0);
|
||||
goto queues-manip|O${exten}|1;
|
||||
goto queues-manip,O${exten},1;
|
||||
default:
|
||||
Hangup();
|
||||
break;
|
||||
@@ -490,6 +511,7 @@ macro callagent(device,exten)
|
||||
}
|
||||
}
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
In the callagent macro above, the \${exten} will
|
||||
be 6121, or 6165, etc, which is the extension of the agent.
|
||||
@@ -498,10 +520,10 @@ The use of the GROUP\_COUNT, and OUTBOUND\_GROUP follow this line
|
||||
of thinking. Incoming calls can be queued to ring all agents in the
|
||||
current priority. If some of those agents are already talking, they
|
||||
would get bothersome call-waiting tones. To avoid this inconvenience,
|
||||
when an agent gets a call, the OUTBOUND\_GROUP assigns that
|
||||
when an agent gets a call, the OUTBOUND\_GROUP assigns that
|
||||
conversation to the group specified, for instance 6171@agents.
|
||||
The \${GROUP\_COUNT()} variable on a subsequent call should return
|
||||
"1" for that group. If GROUP\_COUNT returns 1, then the busy()
|
||||
"1" for that group. If GROUP\_COUNT returns 1, then the busy()
|
||||
is returned without actually trying to dial the agent.
|
||||
|
||||
\subsection{Pre Acknowledgement Message}
|
||||
@@ -509,16 +531,17 @@ is returned without actually trying to dial the agent.
|
||||
If you would like to have a pre acknowledge message with option to reject the message
|
||||
you can use the following dialplan Macro as a base with the 'M' dial argument.
|
||||
|
||||
\begin{astlisting}
|
||||
\begin{verbatim}
|
||||
[macro-screen]
|
||||
exten=>s,1,Wait(.25)
|
||||
exten=>s,2,Read(ACCEPT|screen-callee-options|1)
|
||||
exten=>s,2,Read(ACCEPT,screen-callee-options,1)
|
||||
exten=>s,3,Gotoif($[${ACCEPT} = 1] ?50)
|
||||
exten=>s,4,Gotoif($[${ACCEPT} = 2] ?30)
|
||||
exten=>s,5,Gotoif($[${ACCEPT} = 3] ?40)
|
||||
exten=>s,6,Gotoif($[${ACCEPT} = 4] ?30:30)
|
||||
exten=>s,30,Set(MACRO_RESULT=CONTINUE)
|
||||
exten=>s,40,Read(TEXTEN|custom/screen-exten|)
|
||||
exten=>s,40,Read(TEXTEN,custom/screen-exten,)
|
||||
exten=>s,41,Gotoif($[${LEN(${TEXTEN})} = 3]?42:45)
|
||||
exten=>s,42,Set(MACRO_RESULT=GOTO:from-internal^${TEXTEN}^1)
|
||||
exten=>s,45,Gotoif($[${TEXTEN} = 0] ?46:4)
|
||||
@@ -527,6 +550,7 @@ exten=>s,50,Playback(after-the-tone)
|
||||
exten=>s,51,Playback(connected)
|
||||
exten=>s,52,Playback(beep)
|
||||
\end{verbatim}
|
||||
\end{astlisting}
|
||||
|
||||
\subsection{Caveats}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user