Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Links, and flipped content to put routines up top.

Interception

...

routines

...

Anchor

...

titleWARNING

interception_routines
interception_routines

Note

As Interception routines are implemented internally using the Gosub application, all routines should end with an explicit call to the Return application.

The interception macros routines give the administrator an opportunity to alter connected line and redirecting information before the channel driver is given the information. If the macro routine does not change a value then that is what is going to be passed to the channel driver.

The tag string available in CALLERID, CONNECTEDLINE, and REDIRECTING is useful for the interception macros routines to provide some information about where the information originally came from.

The 'i' option of the CONNECTEDLINE dialplan function should always be used in the CONNECTED_LINE interception macrosroutines. The interception macro routine always passes the connected line information on to the channel driver when the macro exitsroutine returns. Similarly, the 'i' option of the REDIRECTING dialplan function should always be used in the REDIRECTING interception macrosroutines.

...

Info

Note that Interception routines do not attempt to draw a distinction between caller/callee. As it turned out, it was not a good thing to distinguish since transfers make a mockery of caller/callee.

  • ${REDIRECTING_CALLEE_SEND_MACRO_ARGSSUB}
    Arguments to pass to ${REDIRECTING_CALLEE_SEND_MACRO}.${REDIRECTING_CALLER_SEND_MACRO}
    Macro to Subroutine to call before sending a redirecting update to the callerparty.
  • ${REDIRECTING_CALLER_SEND_MACROSUB_ARGS}
    Arguments to pass to ${REDIRECTING_CALLER_SEND_MACRO}.${CONNECTED_LINE_CALLEE_SEND_MACRO}
    Macro to call before sending a connected line update to the calleeSUB}.
  • ${CONNECTED_LINE_CALLEE_SEND_MACRO_ARGSSUB}
    Arguments to pass to ${CONNECTED_LINE_CALLEE_SEND_MACRO}.${CONNECTED_LINE_CALLER_SEND_MACRO}
    Macro to Subroutine to call before sending a connected line update to the callerparty.
  • ${CONNECTED_LINE_CALLER_SEND_MACROSUB_ARGS}
    Arguments to pass to ${CONNECTED_LINE_CALLER_SEND_MACROSUB}.

Interception

...

macros

...

Warning

...

As Interception routines are implemented internally using the Gosub application, all routines should end with an explicit call to the Return application
Note
titleWARNING

Interception macros have been deprecated in Asterisk 11 due to deprecation of Macro. Users of the interception functionality should plan to migrate to Interception routines.

The interception routines macros give the administrator an opportunity to alter connected line and redirecting information before the channel driver is given the information. If the routine macro does not change a value then that is what is going to be passed to the channel driver.

The tag string available in CALLERID, CONNECTEDLINE, and REDIRECTING is useful for the interception routines macros to provide some information about where the information originally came from.

The 'i' option of the CONNECTEDLINE dialplan function should always be used in the CONNECTED_LINE interception routinesmacros. The interception routine macro always passes the connected line information on to the channel driver when the routine returnsmacro exits. Similarly, the 'i' option of the REDIRECTING dialplan function should always be used in the REDIRECTING interception routinesmacros.

...

  • ${REDIRECTING_CALLEE_SEND_MACRO}
    Macro to call before sending a redirecting update to the callee. This macro may never be needed since the redirecting updates should only go from the callee to the caller direction. It is available for completeness.
  • ${REDIRECTING_CALLEE_SEND_SUBMACRO_ARGS}
    Subroutine to Arguments to pass to ${REDIRECTING_CALLEE_SEND_MACRO}.
  • ${REDIRECTING_CALLER_SEND_MACRO}
    Macro to call before sending a redirecting update to the partycaller.
  • ${REDIRECTING_CALLER_SEND_SUBMACRO_ARGS}
    Arguments to pass to ${REDIRECTING_CALLER_SEND_MACRO}.
  • ${CONNECTED_LINE_CALLEE_SEND_SUB}MACRO}
    Macro to call before sending a connected line update to the callee.
  • ${CONNECTED_LINE_CALLEE_SEND_SUBMACRO_ARGS}
    Subroutine to Arguments to pass to ${CONNECTED_LINE_CALLEE_SEND_MACRO}.
  • ${CONNECTED_LINE_CALLER_SEND_MACRO}
    Macro to call before sending a connected line update to the partycaller.
  • ${CONNECTED_LINE_CALLER_SEND_SUBMACRO_ARGS}
    Arguments to pass to ${CONNECTED_LINE_CALLER_SEND_SUBMACRO}.