Documentation

Documentation.Tutorials-B2BUA-3-2 History

Hide minor edits - Show changes to output

January 19, 2023, at 06:12 PM by liviu -
Changed line 213 from:
b2b_client_new("callee", $tu);
to:
b2b_client_new("callee", $ru);
January 07, 2021, at 12:57 PM by 109.99.227.30 -
Added line 69:
[[#prepaid_cfg_scenario]]
November 18, 2020, at 10:54 AM by rvlad_patrascu -
Changed line 34 from:
!!!Dedeicated script routes
to:
!!!Dedicated script routes
November 18, 2020, at 10:53 AM by rvlad_patrascu -
Changed lines 6-7 from:
%block text-align=right% '''written by Anca Vamanu'''
to:
Changed lines 12-16 from:
OpenSIPS has many features but in the way it behaves when a media session is established, it is not more than a proxy, meaning that it only takes the messages from one side and pass them on the other side. However, this has proven not to be enough as to provide certain services it is required for the server to be aware of the state of the sessions, monitor and control them. A Back-to-Back User Agent is exactly this, a entity in the SIP network which has the ability to control or start media sessions. The name comes from the behavior, since in fact what is required is for the B2BUA to stand in the middle and establish two dialogs with both end points that will eventually exchange media.

B2BUA in OpenSIPS is an implementation of the behavior of a B2BUA as defined in RFC 3261 that offers the possibility to build certain services on top of it. It consists of two modules:
* b2b_entities - the bottom half, implementing the behavior of UAC and UAS (B2BUA)
* b2b_logic - the upper half, implementing a logic for analyzing and applying services scenarios to achieve the desired B2BUA specific services.
to:
OpenSIPS has many features but in the way it behaves when a media session is established, it is not more than a proxy, meaning that it only takes the messages from one side and passes them on the other side. However, this has proven not to be enough to provide certain services required for the server to be aware of the state of the sessions, monitor and control them. A Back-to-Back User Agent is exactly this, a entity in the SIP network which has the ability to control or start media sessions. The name comes from the behavior, since in fact what is required is for the B2BUA to stand in the middle and establish two dialogs with both end points that will eventually exchange media.

The B2BUA in OpenSIPS is an implementation of the behavior of a B2BUA as defined in RFC 3261 that offers the possibility to build certain services on top of it. It consists of two modules:
* b2b_entities - the bottom half, implementing the basic functions of a UAC and UAS, by dealing with the actual network message exchange;
* b2b_logic - the upper half, providing to the script and exterior the necessary functions for implementing the logic of the B2BUA services.

The two parts composing the B2BUA in OpenSIPS are bound to each other in a control-notify relationship. The b2b_logic module controls the b2b_entities by sending commands and telling it what messages to send and the b2b_entities modules notifies the b2b_logic module when a request or a reply is received for a dialog that the B2B is handling.

!!!B2B Entities
B2B entities are internal OpenSIPS records corresponding to the dialogs in which the B2BUA is involved. More loosely, we use the term "entity" to refer to the SIP entity that is the peer user agent of OpenSIPS in these dialogs. Depending on how OpenSIPS acts for the first transaction (as a UAS or UAC), we have two types of entities:
* b2b server entity, if it is created for a received initial INVITE;
* b2b client entity, if OpenSIPS will have to start a dialog itself by sending an initial message.

[[#Implementing_B2BUA_services]]
!! Implementing B2BUA services

!!!Initiating B2B sessions
There are two ways to trigger a new B2B session corresponding to a desired B2BUA scenario:
* from the script, at the receipt of an initial INVITE, using the '''b2b_init_request''' function
* with the '''b2b_trigger_scenario''' MI command , when OpenSIPS has to start the calls from the middle.
The initial details for the first entities that have to be connected are provided directly as parameters to the '''b2b_trigger_scenario''' MI command. In the case of the '''b2b_init_request''' function, the b2b entities records have to be created beforehand, with the '''b2b_server_new''' and '''b2b_client_new''' script functions.

!!!Dedeicated script routes
After initializing a B2B session, the call legs will be handled by the b2b_logic module and the first step will be to put the two initial entities in contact. Requests and replies belonging to these dialogs will not enter the script through the standard OpenSIPS routes but instead will be handled in b2b_logic dedicated routes (defined through the '''script_req_route''' and '''script_reply_route''' modparams or, the custom routes given as parameters to the '''b2b_init_request''' function). The further steps of the scenario can be implemented in these routes, by calling specific b2b_logic script functions in order to perform various actions (eg. bridging existing entities with new ones). Normal "proxy-like" OpenSIPS functions should not be executed in the b2b_logic routes.

Some messages will be handled automatically by the module and will not enter the b2b_logic routes at all (BYE requests received while in the process of bridging two entities, ACKs/BYEs/replies for disconnected entities). Also, if no dedicated b2b_logic reply route is defined, replies will be handled internally by the module, with the same effects as calling the '''b2b_handle_reply''' function from such a route if it were defined.

[[#Scenario_examples]]
!! Scenario Examples
!!! Topology Hiding
No scenario document must be defined for this usage case. This is a built in mechanism and it
can be requested to the B2B Logic by specifying the name "top hiding".
The functionality is a simple pass through with the creation of a new dialog on the other side
and transferring all the messages received on one side to the other side taking care only to
change the dialog information.

!!!!Scenario Schema
Here is the theoretical expected message trace:

http://www.opensips.org/images/top_hiding_schema.jpeg


!!! Prepaid
This scenario can be used by a company for prepaid users to announce them at the beginning of the call what their credit is and at the end of the call what their remaining credit is.

What must happen at session level is:

# the caller is connected to a media server
# the caller is connected to the callee
# if the callee hangs up the phone before the caller, the caller is connected to a media server (the same or other).

!!!! Scenario Schema
To establish this sessions the SIP message flow has to look like this( it is assumed that the
same media server is used):

http://www.opensips.org/images/ppaid.jpeg

!!!! Scenario Document
The relevent part of an OpenSIPS config that implements this scenario is shown below:
[@
modparam("b2b_logic", "script_req_route", "b2b_logic_request")

route {
...
if (is_method("INVITE") && !has_totag()) {
# choose an initial state and save it in context
$b2b_logic.ctx(state) = "1";
# save the original destination in context
$b2b_logic.ctx(callee_uri) = $tu;

# create the server entity
b2b_server_new("caller");
# create the initial client entity, to connect the caller to the media server
b2b_client_new("media", "sip:808@opensips.org");

# initialize B2B session for the "prepaid" scenario
b2b_init_request("prepaid");
exit;
}
...
}

route[b2b_logic_request] {
if ($rm != "BYE") {
# for requests other than BYE, no special actions needs to be done,
# just pass the request to the peer
b2b_pass_request();
exit;
}

if ($b2b_logic.ctx(state) == "1" && $b2b_logic.entity(id) == "media") {
# if we are in the initial state (caller connected to media server)
# and the BYE is from the media server, we connect the caller with the callee

# end dialog with the media server
b2b_send_reply(200, "OK");
b2b_delete_entity();

# create the client entity corresponding to the callee
b2b_client_new("callee", $b2b_logic.ctx(calle_uri));

# trigger the bridge action
b2b_bridge("caller", "callee");

# save the next state in context
$b2b_logic.ctx(state) = "2";
} else if ($b2b_logic.ctx(state) == "2" && $b2b_logic.entity(id) == "callee") {
# if we are in the second state (caller is connected with the callee)
# and the callee hanged up first, we connect the caller with the media server again

# end dialog with the callee
b2b_send_reply(200, "OK");
b2b_delete_entity();

# create a new client entity corresponding to the media server
b2b_client_new("media_end", "sip:808@opensips.org");

# trigger the bridging action
b2b_bridge("caller", "media_end");

# save the next state in context
$b2b_logic.ctx(state) = "3";
} else {
# a normal BYE request, for which no special scenario action is required,
# just pass the request to the peer
b2b_pass_request();
}
}
@]

!!! Marketing
The last test case is called “Marketing”, because it suits very well to the requirements of a marketing campaign through phone. The company might choose a list of potential costumers to call and announce about a new product/offer/discount. The message will be a recorded one, but the costumer will also be offered the possibility to talk to a human operator. If the costumer does not hung up the phone before the recorded message ends, it will be connected to a human operator. This is also a good means to filter the interested costumers and make the process more efficient with less resources used.

The OpenSIPS B2BUA must connect two end points, start the call from the middle. It is different from the other examples, since the call is initiated by the B2BUA and it is triggered by a MI command.

!!!! Scenario Schema
Below is the theoretical message flow that should occur for this functionality to be achieved.

http://www.opensips.org/images/marketing.jpeg

!!!! Scenario Document
The relevent part of an OpenSIPS config that implements this scenario is shown below:

[@
modparam("b2b_logic", "script_req_route", "b2b_logic_request")

route[b2b_logic_request] {
if ($rm != "BYE") {
# for requests other than BYE, no special actions needs to be done,
# just pass the request to the peer
b2b_pass_request();
exit;
}

if ($b2b_logic.ctx(state) != "2" && $b2b_logic.entity(id) == "media") {
# if we are in the initial state (customer connected to media server)
# and the BYE is from the media server, we connect the customer with the operator

# end dialog with the media server
b2b_send_reply(200, "OK");
b2b_delete_entity();

# create the client entity corresponding to the operator,
# take the URI of the destination from the context
b2b_client_new("operator", $b2b_logic.ctx(operator_uri));

# trigger the bridging action
b2b_bridge("customer", "operator");

# save the next state in context
$b2b_logic.ctx(state) = "2";
} else {
# a normal BYE request, for which no special scenario action is required,
# just pass the request to the peer
b2b_pass_request();
}
}
@]

MI command example:

[@
opensips-cli -x mi b2b_trigger_scenario marketing customer,sip:bob@opensips.org media,sip:808@opensips.org:5070 operator_uri=sip:alice@opensips.org
@]

!!! REFER Scenario

The B2BUA component can also be configured to handle blind transfers(with REFER SIP message). This is useful when in the platform there are devices that do not accept the REFER method. The scenario for this case is very simple and has one rule for when a REFER is received. This rule tells the B2BUA to end the call with the user agent that sent the refer message and to bridge the peer with the user specified in the 'Refer-To' header.
Deleted lines 200-437:
The picture bellow shows the architecture of the B2BUA implementation.

http://www.opensips.org/images/B2BUA_architecture.jpg

The reason for which the architecture has two parts is to allow extensions and integration with other system that might implement their own logic interpretor. Instead of the b2b_logic module, another module with a different logic interpretor or scenario source can be placed there and use the interface that the b2b_entities module offers to build quickly a new B2BUA implementation. The b2b_entities role in the processing is an independent one that is required in any B2B implementation and it is therefore encoded in a separate module. It offer an upper level library that will make the implementation of another logic interpreter and applier much easier. The separation enhances and encourages extension and integration with other systems.

The two parts composing B2BUA in OpenSIPS are bound to each other in a control-notify relationship. The b2b_logic module controls the b2b_entities by sending commands and telling it what messages to send and the b2b_entities modules notifies the b2b_logic module when a request or a reply is received for a dialog that the B2B is handling.

!!!Server Entity and Client Entity
The name represents in fact the type if transaction entity that is created at the beginning. So there will be a
* b2b server entity if it is created when a message is received and has to reply to it
* b2b client entity if the entity will have to start a dialog by sending an initial message

!!!Scenario Instantiation
The services are defined in documents called scenarios. A scenario instantiation is an application of a scenario that is currently in progress. The b2b_logic module might be told to initialize a scenario in two ways: from the script, by calling a function that the module exports when an initial request is received, or by sending an external command. When receiving one of this two events, the b2b_logic module will create a record(corresponding to the red small boxes in the drawing) with the information for that scenario instantiation. Also at this moment, the b2b_logic module tells the b2b_entities module to create the entities(server and/or clients) that it requires. The record mainly stores a relation to the scenario document that it must follow, the state of the scenario application and the identifiers for the entities in b2b_entities module.

!!!Communication with the exterior
As can be seen in the picture, the b2b_entities module is the bottom half part of B2BUA and it deals with the actual network message exchange. To achieve this it uses directly the functions provided by the '''tm''' module for sending requests and replies and for receiving replies. Also the tm module announce it when a reply for a request that it has sent is received. For requests inside dialog, the b2b_entities module registers a prescript function that catches this requests. In the current implementation, this requests don't go into the script because the prescript function returns '0'. As mentioned earlier, when receiving a reply or request that is matched to a known dialog, the b2b_entities module does no further action but notifies the b2b_logic module about this event. The b2b_logic module which is the upper half, will then decide what actions should be taken and sends back control commands to the b2b_entities module.


[[#Initiating_B2B_services]]
!! Initiating B2B services

There are two ways to trigger a B2B service.
* from script
* with an MI command

The function that can be called from the script has the name '''b2b_init_request''' and has 6 parameters:

'''b2b_init_request''' ( scenario_name, param1, param2, param3, param4, param5)

%color=#ff7f00% NOTE: This function has to be called on the initial Invite only ( the B2BUA must be in the middle of the call from the beginning). %black%

The first parameter is the name of the scenario to be instantiated. So it is the job of the script writer to decide when a certain scenario should be applied . The next arguments are parameters needed by the scenario. As it shall be seen later, a scenario can require some values to be given as parameters in contrast to hard coding them, making the scenario configurable.

The MI command has the name '''b2b_trigger_scenario''' and takes exactly the same parameters as the script function.


%color=#ff7f00% Ex: %black%'''Fifo MI command'''
>>lframe black<<
:b2b_trigger_scenario[=:=]fifo_reply[[<<]]
marketing[[<<]]
sip:bob@opensips.org[[<<]]
sip:322@opensips.org:5070[[<<]]
sip:alice@opensips.org
_empty_line_
>><<

[[<<]]
[[<<]]
There is one predefined service that works without any scenario definition and for any type of dialog. This is '''topology hiding''' service. The functionality is obvious from the name and what this service does is to hide the network topology from the parties that establish a dialog. To achieve this, the B2BUA poses itself in the middle and established dialogs with both parties. Then all it will do next will be to translate a receipt request or reply into the dialog from the other side and forward it to the peer entity.

This service can only be selected from the script, because it has sense only when a dialog is initiated. It does not require any parameter. The id for this scenario is '''top hiding'''.

%color=#ff7f00% Ex:%black% '''Calling top hiding service'''
>>lframe<<
<pre><span style="color: #008;">if</span><span style="color: #660;">(</span><span style="color: #000;">is_method</span><span style="color: #660;">(</span><span style="color: #080;">"INVITE"</span><span style="color: #660;">)</span><span style="color: #000;"> </span><span style="color: #660;">&amp;&amp;</span><span style="color: #000;"> src_ip</span><span style="color: #660;">==</span><span style="color: #080;">"10.10.10.10"</span><span style="color: #660;">)</span><span style="color: #000;"><br>&nbsp; &nbsp;b2b_init_request</span><span style="color: #660;">(</span><span style="color: #080;">"top hiding"</span><span style="color: #660;">);</span></pre>
>><<
[[<<]]
Other services must be defined in scenario documents and loaded at startup by providing the path towards them as module parameters as presented in the following chapter.


[[#Loading_scenarios]]
!! Loading scenarios

The scenario documents are loaded at startup and their paths in the system must be provided through module parameters that belong to the b2b_logic module. There are two parameters, one of each type of scenario: '''scenario_script''' and '''scenario_extern'''.

%color=#ff7f00% Ex:%black% '''Loading B2BUA scenarios'''
>>lframe<<
<pre><span style="color: #000;">modparam</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_logic"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"script_scenario"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"/usr/local/opensips/etc/b2bua/scenario_script.xml"</span><span style="color: #660;">)</span><span style="color: #000;"><br>modparam</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_logic"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"extern_scenario"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"/usr/local/opensips/etc/b2bua/scenario_extern.xml"</span><span style="color: #660;">)</span></pre>
>><<
[[<<]]

[[#B2BUA_scenario_format]]
!! Scenario format
The scenarios are defined as XML documents because of their adaptability and because they are easy to understand and write.

A scenario is a predefined behavior that will be interpreted by the B2B Logic. The decision when the the scenario will be applied must be taken by the server administrator in the configuration file or triggered by an extern application with an MI command.

The scenario is not rigid, but configurable through some parameters that will have to be provided to the B2B logic when requesting the instantiation of a certain scenario.



!!! Scenario root
The '''root''' element has the tag 'scenario'.
[[<<]]
%color=#ff7f00% Ex: %black%'''Scenario root node example'''
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">scenario</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"prepaid"</span><span style="color: #000;"> </span><span style="color: #606;">name</span><span style="color: #660;">=</span><span style="color: #080;">"MS start and end"</span><span style="color: #000;"> </span><span style="color: #606;">param</span><span style="color: #660;">=</span><span style="color: #080;">"2"</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"script"</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]

It has three parameters:

* '''id –''' the identifier for the scenario. It will be provided to the logic when desiring to instantiate the scenario.
* '''name''' – a more explicit name. It has meaning only for the reader, with no importance for the B2BUA.
* '''param''' – the number of parameters the scenario requires.
* '''type''' – the type of the scenario. It can be ''script'' or ''extern.'' This parameter as the name parameter is not meaningful to the B2BUA but to the reader.

A B2B scenario document has two parts:

* a '''init''' section
* a '''rules''' section

!!! Init section
The '''init''' section provides indications about the entities that must be created at the beginning of the scenario. The '''init''' node has as a subnode a '''bridging''' node meaning that the entities created there will eventually be connected in a media session.

There can be two types of entities:

* '''server entity''' – for the first transaction the entity will behave as a UAS. This can be created only if there is a INVITE message that the entity will have to deal with. Server entities can appear only in scrip scenarios.
* '''client entity''' - a entity that has to start a dialog and send an initial message to a SIP endpoint.

Some parameters must be defined for the entities. Both server and client entities must be given an '''id''' that will be used to identify the entity later in the script. For the server entity no other parameters need to be defined.

For the client entities it is compulsory to define the destination where the messages will be sent. For this a '''destination''' sub node must be defined. The syntax of the destination node is:

The destination value can be provided in more ways
[[<<]]
%color=#ff7f00% Ex: %black%'''Scenario destination node example'''
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"_value_type_"</span><span style="color: #660;">&gt;</span><span style="color: #000;">_value_</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]
[[<<]]
%color=#ff7f00% Table: %black%'''Scenario destination node structure'''
|| border=1
||Value source||Value type||Example||
||Inline URI ||"uri" ||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"uri"</span><span style="color: #660;">&gt;</span><span style="color: #000;">sip:ms@opensips.org</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>||
||Parameter.The value node content is a number and represents the number of the parameter.||"param"||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>||
||Initial destination.Used when the bridging is based on a received message. The destination will be that from the message.||"initial"||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"initial"</span><span style="color: #660;">&gt;&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>||
||Header body.Take the URI from the body of a header. The first header with that name will be used. ||"header" || <pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"header"</span><span style="color: #660;">&gt;</span><span style="color: #000;">Refer-To</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>||


The client entity can also have a '''type''' subnode. The only defined value for this node is ''''message''''. If type node with message value is present, it means that the client will be created using the info from received SIP message: the body, the caller URI, some SIP headers(Accept, Supported, Content-Type). Defining this node does not mean that the destination will be taken from this message and still a destination node must be defined.

In addition to the bridging node, you can also define a state node. The meaning of states in the b2b scenario is that of labels in the evolution of the scenario that can be used as conditions when defining rules. A '''state '''node in the '''init''' node specifies the state that the scenario instantiation will enter after the init part will be executed.

Below there are two examples of scenario init parts, one that creates entities based on a received message and in
which the dialog is initiated by the b2bua that puts two entities in contact.

[[<<]]
%color=#ff7f00% Table: %black%'''Scenario init node examples'''
||border=1
||'''Script scenario'''||'''Extern Scenario'''||
||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"> <br><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">message</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;">120</span><span style="color: #660;">&lt;/</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"> </span></pre>||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;">300</span><span style="color: #660;">&lt;/</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;<br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span></pre>||


!!! Rules section
The rules have two parts:

* condition
* action

The condition part decides whether a rule should be applied for the current event. The events are represented by the receipt of a SIP request or SIP reply. The action part may define a request or reply to be sent out.

In the scenario document, the rules node has two children, requests and replies, separating the two types of events. Then both replies and requests have children with names of the possible requests inside dialog: 'invite', 'ack', 'bye' and for each more rules can be defined.

%color=#ff7f00% Ex: %black%'''Scenario rules node structure'''
[[<<]]
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #000;"> ”</span><span style="color: #606;">1</span><span style="color: #000;">”</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; ...<br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #000;"> ”</span><span style="color: #606;">2</span><span style="color: #000;">”</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; ...<br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span></pre>
>><<
[[<<]]


!!!! Rules condition part
The extra conditions that can be defined for a rule filter the scenario state and the direction of the message.

A condition will be matched if the scenario instantiation is in the same state as the state specified in the condition.

The direction of a message is specified with a '''sender''' node. The sender can be a certain entity specified with a type and an id, or a entity category, being sufficient to specify only the type.

[[<<]]
%color=#ff7f00% Ex: %black%'''Scenario condition node'''
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">client</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]


!!!! Rules action part
In this first version there are four possible actions, with the possibility to extend them in the future. The actions are described in the table bellow.

[[<<]]
%color=#ff7f00% Table: %black%'''Scenario rules node structure'''

||border=1
||'''Node name'''||'''Description'''||'''Example'''||
||send_reply||This node tells the B2BUA to send a reply to the sender of the current message. A code and reason sub node must be defined.||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span></pre>||
||delete_entity||The delete_entity node specifies to the B2B Logic that the current entity which has received the message can be deleted.||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span></pre>||
||bridge||A bridge action means putting two end points in contact. The syntax is the same as the one for the bridge node in the init part. The only difference here is that the entities can be also existing ones. To refer to an existing entity, you must use the same "id". If a new entity has to be created, a '''<destination>''' node must be present. To force the creation of a new entity, insert a '''<new/>''' subnode for the client. The client node also allows a '''<lifetime>''' subnode. It defines the maximum duration of the media session and it is used to track blocked scenario instantiations. If the lifetime expires, the B2BUA will send BYE messages to both ends and delete the record. This parameter is not compulsory and should be defined when a maximum lifetime value is known(most likely in the case of recorded messages played by media servers).||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;">79800</span><span style="color: #660;">&lt;/</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span></pre>||
||state||Specifies the state the scenario instantiation will enter after the action will be executed.||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span></pre>||
||end_dialog_leg||This node tells the B2BUA to end the call that has just received an event ( request or reply). The B2BUA will send a BYE request to the party.||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">end_dialog_leg</span><span style="color: #660;">/&gt;</span></pre>||


Bellow is an action example:
[[<<]]
%color=#ff7f00% Ex: %black%'''Scenario action node'''
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"initial"</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]


[[#Scenario_examples]]
!! Scenario Examples
!!! Topology Hiding
No scenario document must be defined for this usage case. This is a built in mechanism and it
can be requested to the B2B Logic by specifying the name "top hiding".
The functionality is a simple pass through with the creation of a new dialog on the other side
and transferring all the messages received on one side to the other side taking care only to
change the dialog information.

!!!!Scenario Schema
Here is the theoretical expected message trace:

http://www.opensips.org/images/top_hiding_schema.jpeg


!!! Prepaid
This scenario can be used by a company for prepaid users to announce them at the beginning of the call what their credit is and at the end of the call what their remaining credit is.

What must happen at session level is:

# the caller is connected to a media server
# the caller is connected to the callee
# if the callee hangs up the phone before the caller, the caller is connected to a media server (the same or other).

In B2BUA terms, this is a script scenario that can be instantiating by specifying the id '''prepaid'''. It requires 2 parameters:
* the location of the first media server
* the location of the second media server

!!!! Scenario Schema
To establish this sessions the SIP message flow has to look like this( it is assumed that the
same media server is used):

http://www.opensips.org/images/ppaid.jpeg
Changed lines 202-306 from:
The full scenario document is printed bellow:
>>lframe<<
<pre><span style="color: #660;">&lt;?</span><span style="color: #000;">xml version</span><span style="color: #660;">=</span><span style="color: #080;">"1.0"</span><span style="color: #660;">?&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;</span><span style="color: #008;">scenario</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"prepaid"</span><span style="color: #000;"> </span><span style="color: #606;">name</span><span style="color: #660;">=</span><span style="color: #080;">"MS start and end"</span><span style="color: #000;"> </span><span style="color: #606;">param</span><span style="color: #660;">=</span><span style="color: #080;">"2"</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"script"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">message</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"1"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">client</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"initial"</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"2"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">client</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">scenario</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span></pre>
>><<
[[<<]]

!!! Marketing
The last test case is called “Marketing”, because it suits very well to the requirements of a marketing campaign through phone. The company might choose a list of potential costumers to call and announce about a new product/offer/discount. The message will be a recorded one, but the costumer will also be offered the possibility to talk to a human operator. If the costumer does not hung up the phone before the recorded message ends, it will be connected to a human operator. This is also a good means to filter the interested costumers and make the process more efficient with less resources used.

The OpenSIPS B2BUA must connect two end points, start the call from the middle. It is different from the other examples, since the call is initiated by the B2BUA and it is triggered by a MI command.

The id which must be mentioned to start this service is 'marketing'. It requires 3 parameters
* the URI of the possible costumer
* the URI of the media server
* the URI of the human operator

!!!! Scenario Schema
Below is the theoretical message flow that should occur for this functionality to be achieved.

http://www.opensips.org/images/marketing.jpeg

!!!! Scenario Document
The scenario document that describes this service is:
>>lframe<<
<pre><span style="color: #660;">&lt;?</span><span style="color: #000;">xml version</span><span style="color: #660;">=</span><span style="color: #080;">"1.0"</span><span style="color: #660;">?&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;</span><span style="color: #008;">scenario</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"marketing"</span><span style="color: #000;"> </span><span style="color: #606;">name</span><span style="color: #660;">=</span><span style="color: #080;">"MS start conditional"</span><span style="color: #000;"> </span><span style="color: #606;">param</span><span style="color: #660;">=</span><span style="color: #080;">"3"</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"extern"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"1"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">client</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">scenario</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]

!!! REFER Scenario

The B2BUA component can also be configured to handle blind transfers(with REFER SIP message). This is useful when in the platform there are devices that do not accept the REFER method. The scenario for this case is very simple and has one rule for when a REFER is received. This rule tells the B2BUA to end the call with the user agent that sent the refer message and to bridge the peer with the user specified in the 'Refer-To' header.

!!!! Scenario Document
The scenario document that describes this service is:
>>lframe<<
<pre><span style="color: #660;">&lt;?</span><span style="color: #000;">xml version</span><span style="color: #660;">=</span><span style="color: #080;">"1.0"</span><span style="color: #660;">?&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;</span><span style="color: #008;">scenario</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"refer"</span><span style="color: #000;"> </span><span style="color: #606;">name</span><span style="color: #660;">=</span><span style="color: #080;">"Handle refer at server"</span><span style="color: #000;"> </span><span style="color: #606;">param</span><span style="color: #660;">=</span><span style="color: #080;">"0"</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"script"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">message</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"initial"</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">refer</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"1"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">202</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">Accepted</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">end_dialog_leg</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">peer</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"header"</span><span style="color: #660;">&gt;</span><span style="color: #000;">Refer-To</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">refer</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">scenario</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]


[[#Configuration_file_example]]
!! Configuration file

%color=#ff7f00% You must note that, a call that is handled by the B2B will not have the normal ‘proxy like’ interaction with the script.

Once you ask b2b to handle a call, you '''won't see the future in-dialog request in the normal route'''. The reason is that in the normal route you do proxy operations - changes on the message, routing decisions, but for the b2b calls those requests will have the b2b as an endpoint. The b2b will then generate new messages that will be sent on the other side. It will not forward the received ones. Those new generated can be accessed in local_route.

If the scenario is called from script on an initial Invite, you must take care to drop this request after calling b2b_init_request() function on it ( call 'exit', don't call t_relay() on it ).

When using b2b all the changes that you want to perform on a message must be done in local_route on the new generated request that will be sent out.

Because sometimes it is required to also access the received requests, you can define a special route '''b2b_request route''' where you can do 'read-only' operation on the request, like accounting or logging.
Also, you can define a special '''b2b_reply route''' where you can see the received replies.

As a conclusion, when a call is handled by the b2bua, SIP messages for that call will be accessible in:
* '''b2b_request route''' : the received requests. This request will not be forwarded so doing changes on the message will have no effect. This route is useful for logging and accounting.
* '''b2b_reply route''' : the received replies. The same as with the requests, it has no effect to do changes on it.
* '''local_route''' : the SIP requests that are sent out by the b2bua. Here changes on the message can be performed.

%color=#ff7f00% Also, note that '''dialog''' module does not work with B2BUA. The reason is that this module was designed to handle proxy dialogs.

!!! Writing the configuration file

There are some requirements for a configuration file that enables the B2BUA services.

* load modules '''b2b_entities''' and '''b2b_logic'''
* set module parameters
** compulsory: the '''server_address''' parameter in b2b_entities
** optional:
*** '''script_scenario''' and '''extern_scenario''' in b2b_logic for loading service scenarios
*** parameters for the hash tables - server_hsize and client_hsize in b2b_entities module and '''hash_size''' in b2b_logic module

* load a MI module if you need to support triggering B2BUA scenarios with extern commands. Depending on the transport you require, either mi_fifo or mi_xmlrpc or mi_datagram.
* built the filters and call the script scenario instantiating function

Also please note that you need to configure the tm module to pass provisional replies. For this you need to set the module parameter:

>>lframe blue<<
<pre><span style="color: #000;">modparam</span><span style="color: #660;">(</span><span style="color: #080;">"tm"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"pass_provisional_replies"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #066;">1</span><span style="color: #660;">)</span></pre>
>><<
[[<<]]


!!! Example

You can find [[Documentation.Tutorials-B2BUAConfigExample|here]] a configuration file example that loads the two scenarios presented in this tutorial and enables the '''prepaid''' service for a certain user. Also the mi_fifo module is loaded here and it will be possible to send MI commands to instantiate the '''marketing''' scenario.

!!! Script routes
!!!! Special B2B route
The requests and replies that are received by the B2BUA server, belonging to the dialogs it is handling will not go into the script as normal request do. The reason for this is that this are not normal requests where the server is a proxy, but the server is an endpoint in the dialog and therefore they should not go through the same routes. However, it is normal for this request to be seen from the script and allow the script writer to do the processing it desires based on them. For this, it is possible to define two special B2B routes - one for requests and one for replies. The routes are of type '''route''' and have their name defined in the modules parameters '''script_req_route''' and '''script_reply_route'''.

>>lframe blue<<
<pre><span style="color: #000;">modparam</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_entities"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"script_req_route"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"b2b_request"</span><span style="color: #660;">)</span><span style="color: #000;"><br>modparam</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_entities"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"script_reply_route"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"b2b_reply"</span><span style="color: #660;">)</span><span style="color: #000;"><br><br>route</span><span style="color: #660;">[</span><span style="color: #000;">b2b_request</span><span style="color: #660;">]</span><span style="color: #000;"> </span><span style="color: #660;">{</span><span style="color: #000;"><br>&nbsp; xlog</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_request ($ci)\n"</span><span style="color: #660;">);</span><span style="color: #000;"><br></span><span style="color: #660;">}</span><span style="color: #000;"><br><br><br>route</span><span style="color: #660;">[</span><span style="color: #000;">b2b_reply</span><span style="color: #660;">]</span><span style="color: #000;"> </span><span style="color: #660;">{</span><span style="color: #000;"><br>&nbsp; xlog</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_reply ($ci)\n"</span><span style="color: #660;">);</span><span style="color: #000;"><br></span><span style="color: #660;">}</span></pre>
>><<
[[<<]]


!!!! Failure route not available for B2B

It is impossible to have a '''t_on_failure()''' mechanism (which is transaction specific) on a B2BUA scenario (where you have multiple dialogs, with multiple transactions) - for complex scenarios, with multiple dialogs, you cannot say for which transaction to trigger the failure route for. The "topo hiding" scenario is a very simple B2BUA scenario, but you cannot have a general "on_failure" concept for all b2bua scenarios.

A solution is to consider that b2bua is a separate instance (logically speaking) which selects types/classes of destinations. A proxy instance will responsible for routing inside the class of destinations.

For ex: in a scenario we can sent in the first place the call to Media Server for some announcement and later to PSTN GW. In a first step, the b2bua scenario will sent to proxy the call with RURI pointing to "a class"
of media servers - the proxy will select the proper media server and do the failover between the media servers, totally transparent for the b2bua. In a similar way, on the second step, the b2bua scenario will indicate to proxy that it wants to have the call to be sent to PSTN GW (as type of destination) - the proxy will do lcr, drouting, failover between the GW.
to:
The relevent part of an OpenSIPS config that implements this scenario is shown below:
[@
modparam("b2b_logic", "script_req_route", "b2b_logic_request")

route {
...
if (is_method("INVITE") && !has_totag()) {
# create the server entity
b2b_server_new("caller");
# create the initial client entity, to connect the caller with the callee
b2b_client_new("callee", $tu);

# initialize B2B session for the "refer" scenario
b2b_init_request("refer");
exit;
}
...
}

route[b2b_logic_request] {
if ($rm != "REFER") {
# for requests other than REFER, no special actions needs to be done,
# just pass the request to the peer
b2b_pass_request();
exit;
}

# end dialog with the referrer
b2b_send_reply(202, "Accepted");
b2b_end_dlg_leg();

# create the client entity corresponding to
# the user specified in the 'Refer-To' header
b2b_client_new("referee", $hdr(Refer-To));

# bridge the referrer's peer with the referee
b2b_bridge("peer", "referee");
}
@]
November 16, 2020, at 02:27 AM by rvlad_patrascu -
Added lines 1-362:
!!!!!Documentation -> [[Documentation.Tutorials | Tutorials]] -> B2BUA

----

!Back-to-Back User Agent
%block text-align=right% '''written by Anca Vamanu'''

(:toc Table of Content:)

[[#Overview]]
!! Overview

OpenSIPS has many features but in the way it behaves when a media session is established, it is not more than a proxy, meaning that it only takes the messages from one side and pass them on the other side. However, this has proven not to be enough as to provide certain services it is required for the server to be aware of the state of the sessions, monitor and control them. A Back-to-Back User Agent is exactly this, a entity in the SIP network which has the ability to control or start media sessions. The name comes from the behavior, since in fact what is required is for the B2BUA to stand in the middle and establish two dialogs with both end points that will eventually exchange media.

B2BUA in OpenSIPS is an implementation of the behavior of a B2BUA as defined in RFC 3261 that offers the possibility to build certain services on top of it. It consists of two modules:
* b2b_entities - the bottom half, implementing the behavior of UAC and UAS (B2BUA)
* b2b_logic - the upper half, implementing a logic for analyzing and applying services scenarios to achieve the desired B2BUA specific services.

The picture bellow shows the architecture of the B2BUA implementation.

http://www.opensips.org/images/B2BUA_architecture.jpg

The reason for which the architecture has two parts is to allow extensions and integration with other system that might implement their own logic interpretor. Instead of the b2b_logic module, another module with a different logic interpretor or scenario source can be placed there and use the interface that the b2b_entities module offers to build quickly a new B2BUA implementation. The b2b_entities role in the processing is an independent one that is required in any B2B implementation and it is therefore encoded in a separate module. It offer an upper level library that will make the implementation of another logic interpreter and applier much easier. The separation enhances and encourages extension and integration with other systems.

The two parts composing B2BUA in OpenSIPS are bound to each other in a control-notify relationship. The b2b_logic module controls the b2b_entities by sending commands and telling it what messages to send and the b2b_entities modules notifies the b2b_logic module when a request or a reply is received for a dialog that the B2B is handling.

!!!Server Entity and Client Entity
The name represents in fact the type if transaction entity that is created at the beginning. So there will be a
* b2b server entity if it is created when a message is received and has to reply to it
* b2b client entity if the entity will have to start a dialog by sending an initial message

!!!Scenario Instantiation
The services are defined in documents called scenarios. A scenario instantiation is an application of a scenario that is currently in progress. The b2b_logic module might be told to initialize a scenario in two ways: from the script, by calling a function that the module exports when an initial request is received, or by sending an external command. When receiving one of this two events, the b2b_logic module will create a record(corresponding to the red small boxes in the drawing) with the information for that scenario instantiation. Also at this moment, the b2b_logic module tells the b2b_entities module to create the entities(server and/or clients) that it requires. The record mainly stores a relation to the scenario document that it must follow, the state of the scenario application and the identifiers for the entities in b2b_entities module.

!!!Communication with the exterior
As can be seen in the picture, the b2b_entities module is the bottom half part of B2BUA and it deals with the actual network message exchange. To achieve this it uses directly the functions provided by the '''tm''' module for sending requests and replies and for receiving replies. Also the tm module announce it when a reply for a request that it has sent is received. For requests inside dialog, the b2b_entities module registers a prescript function that catches this requests. In the current implementation, this requests don't go into the script because the prescript function returns '0'. As mentioned earlier, when receiving a reply or request that is matched to a known dialog, the b2b_entities module does no further action but notifies the b2b_logic module about this event. The b2b_logic module which is the upper half, will then decide what actions should be taken and sends back control commands to the b2b_entities module.


[[#Initiating_B2B_services]]
!! Initiating B2B services

There are two ways to trigger a B2B service.
* from script
* with an MI command

The function that can be called from the script has the name '''b2b_init_request''' and has 6 parameters:

'''b2b_init_request''' ( scenario_name, param1, param2, param3, param4, param5)

%color=#ff7f00% NOTE: This function has to be called on the initial Invite only ( the B2BUA must be in the middle of the call from the beginning). %black%

The first parameter is the name of the scenario to be instantiated. So it is the job of the script writer to decide when a certain scenario should be applied . The next arguments are parameters needed by the scenario. As it shall be seen later, a scenario can require some values to be given as parameters in contrast to hard coding them, making the scenario configurable.

The MI command has the name '''b2b_trigger_scenario''' and takes exactly the same parameters as the script function.


%color=#ff7f00% Ex: %black%'''Fifo MI command'''
>>lframe black<<
:b2b_trigger_scenario[=:=]fifo_reply[[<<]]
marketing[[<<]]
sip:bob@opensips.org[[<<]]
sip:322@opensips.org:5070[[<<]]
sip:alice@opensips.org
_empty_line_
>><<

[[<<]]
[[<<]]
There is one predefined service that works without any scenario definition and for any type of dialog. This is '''topology hiding''' service. The functionality is obvious from the name and what this service does is to hide the network topology from the parties that establish a dialog. To achieve this, the B2BUA poses itself in the middle and established dialogs with both parties. Then all it will do next will be to translate a receipt request or reply into the dialog from the other side and forward it to the peer entity.

This service can only be selected from the script, because it has sense only when a dialog is initiated. It does not require any parameter. The id for this scenario is '''top hiding'''.

%color=#ff7f00% Ex:%black% '''Calling top hiding service'''
>>lframe<<
<pre><span style="color: #008;">if</span><span style="color: #660;">(</span><span style="color: #000;">is_method</span><span style="color: #660;">(</span><span style="color: #080;">"INVITE"</span><span style="color: #660;">)</span><span style="color: #000;"> </span><span style="color: #660;">&amp;&amp;</span><span style="color: #000;"> src_ip</span><span style="color: #660;">==</span><span style="color: #080;">"10.10.10.10"</span><span style="color: #660;">)</span><span style="color: #000;"><br>&nbsp; &nbsp;b2b_init_request</span><span style="color: #660;">(</span><span style="color: #080;">"top hiding"</span><span style="color: #660;">);</span></pre>
>><<
[[<<]]
Other services must be defined in scenario documents and loaded at startup by providing the path towards them as module parameters as presented in the following chapter.


[[#Loading_scenarios]]
!! Loading scenarios

The scenario documents are loaded at startup and their paths in the system must be provided through module parameters that belong to the b2b_logic module. There are two parameters, one of each type of scenario: '''scenario_script''' and '''scenario_extern'''.

%color=#ff7f00% Ex:%black% '''Loading B2BUA scenarios'''
>>lframe<<
<pre><span style="color: #000;">modparam</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_logic"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"script_scenario"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"/usr/local/opensips/etc/b2bua/scenario_script.xml"</span><span style="color: #660;">)</span><span style="color: #000;"><br>modparam</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_logic"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"extern_scenario"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"/usr/local/opensips/etc/b2bua/scenario_extern.xml"</span><span style="color: #660;">)</span></pre>
>><<
[[<<]]

[[#B2BUA_scenario_format]]
!! Scenario format
The scenarios are defined as XML documents because of their adaptability and because they are easy to understand and write.

A scenario is a predefined behavior that will be interpreted by the B2B Logic. The decision when the the scenario will be applied must be taken by the server administrator in the configuration file or triggered by an extern application with an MI command.

The scenario is not rigid, but configurable through some parameters that will have to be provided to the B2B logic when requesting the instantiation of a certain scenario.



!!! Scenario root
The '''root''' element has the tag 'scenario'.
[[<<]]
%color=#ff7f00% Ex: %black%'''Scenario root node example'''
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">scenario</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"prepaid"</span><span style="color: #000;"> </span><span style="color: #606;">name</span><span style="color: #660;">=</span><span style="color: #080;">"MS start and end"</span><span style="color: #000;"> </span><span style="color: #606;">param</span><span style="color: #660;">=</span><span style="color: #080;">"2"</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"script"</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]

It has three parameters:

* '''id –''' the identifier for the scenario. It will be provided to the logic when desiring to instantiate the scenario.
* '''name''' – a more explicit name. It has meaning only for the reader, with no importance for the B2BUA.
* '''param''' – the number of parameters the scenario requires.
* '''type''' – the type of the scenario. It can be ''script'' or ''extern.'' This parameter as the name parameter is not meaningful to the B2BUA but to the reader.

A B2B scenario document has two parts:

* a '''init''' section
* a '''rules''' section

!!! Init section
The '''init''' section provides indications about the entities that must be created at the beginning of the scenario. The '''init''' node has as a subnode a '''bridging''' node meaning that the entities created there will eventually be connected in a media session.

There can be two types of entities:

* '''server entity''' – for the first transaction the entity will behave as a UAS. This can be created only if there is a INVITE message that the entity will have to deal with. Server entities can appear only in scrip scenarios.
* '''client entity''' - a entity that has to start a dialog and send an initial message to a SIP endpoint.

Some parameters must be defined for the entities. Both server and client entities must be given an '''id''' that will be used to identify the entity later in the script. For the server entity no other parameters need to be defined.

For the client entities it is compulsory to define the destination where the messages will be sent. For this a '''destination''' sub node must be defined. The syntax of the destination node is:

The destination value can be provided in more ways
[[<<]]
%color=#ff7f00% Ex: %black%'''Scenario destination node example'''
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"_value_type_"</span><span style="color: #660;">&gt;</span><span style="color: #000;">_value_</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]
[[<<]]
%color=#ff7f00% Table: %black%'''Scenario destination node structure'''
|| border=1
||Value source||Value type||Example||
||Inline URI ||"uri" ||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"uri"</span><span style="color: #660;">&gt;</span><span style="color: #000;">sip:ms@opensips.org</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>||
||Parameter.The value node content is a number and represents the number of the parameter.||"param"||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>||
||Initial destination.Used when the bridging is based on a received message. The destination will be that from the message.||"initial"||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"initial"</span><span style="color: #660;">&gt;&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>||
||Header body.Take the URI from the body of a header. The first header with that name will be used. ||"header" || <pre><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"header"</span><span style="color: #660;">&gt;</span><span style="color: #000;">Refer-To</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span></pre>||


The client entity can also have a '''type''' subnode. The only defined value for this node is ''''message''''. If type node with message value is present, it means that the client will be created using the info from received SIP message: the body, the caller URI, some SIP headers(Accept, Supported, Content-Type). Defining this node does not mean that the destination will be taken from this message and still a destination node must be defined.

In addition to the bridging node, you can also define a state node. The meaning of states in the b2b scenario is that of labels in the evolution of the scenario that can be used as conditions when defining rules. A '''state '''node in the '''init''' node specifies the state that the scenario instantiation will enter after the init part will be executed.

Below there are two examples of scenario init parts, one that creates entities based on a received message and in
which the dialog is initiated by the b2bua that puts two entities in contact.

[[<<]]
%color=#ff7f00% Table: %black%'''Scenario init node examples'''
||border=1
||'''Script scenario'''||'''Extern Scenario'''||
||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"> <br><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">message</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;">120</span><span style="color: #660;">&lt;/</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"> </span></pre>||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;">300</span><span style="color: #660;">&lt;/</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;<br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span></pre>||


!!! Rules section
The rules have two parts:

* condition
* action

The condition part decides whether a rule should be applied for the current event. The events are represented by the receipt of a SIP request or SIP reply. The action part may define a request or reply to be sent out.

In the scenario document, the rules node has two children, requests and replies, separating the two types of events. Then both replies and requests have children with names of the possible requests inside dialog: 'invite', 'ack', 'bye' and for each more rules can be defined.

%color=#ff7f00% Ex: %black%'''Scenario rules node structure'''
[[<<]]
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #000;"> ”</span><span style="color: #606;">1</span><span style="color: #000;">”</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; ...<br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #000;"> ”</span><span style="color: #606;">2</span><span style="color: #000;">”</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; ...<br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span></pre>
>><<
[[<<]]


!!!! Rules condition part
The extra conditions that can be defined for a rule filter the scenario state and the direction of the message.

A condition will be matched if the scenario instantiation is in the same state as the state specified in the condition.

The direction of a message is specified with a '''sender''' node. The sender can be a certain entity specified with a type and an id, or a entity category, being sufficient to specify only the type.

[[<<]]
%color=#ff7f00% Ex: %black%'''Scenario condition node'''
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">client</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]


!!!! Rules action part
In this first version there are four possible actions, with the possibility to extend them in the future. The actions are described in the table bellow.

[[<<]]
%color=#ff7f00% Table: %black%'''Scenario rules node structure'''

||border=1
||'''Node name'''||'''Description'''||'''Example'''||
||send_reply||This node tells the B2BUA to send a reply to the sender of the current message. A code and reason sub node must be defined.||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span></pre>||
||delete_entity||The delete_entity node specifies to the B2B Logic that the current entity which has received the message can be deleted.||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span></pre>||
||bridge||A bridge action means putting two end points in contact. The syntax is the same as the one for the bridge node in the init part. The only difference here is that the entities can be also existing ones. To refer to an existing entity, you must use the same "id". If a new entity has to be created, a '''<destination>''' node must be present. To force the creation of a new entity, insert a '''<new/>''' subnode for the client. The client node also allows a '''<lifetime>''' subnode. It defines the maximum duration of the media session and it is used to track blocked scenario instantiations. If the lifetime expires, the B2BUA will send BYE messages to both ends and delete the record. This parameter is not compulsory and should be defined when a maximum lifetime value is known(most likely in the case of recorded messages played by media servers).||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;">79800</span><span style="color: #660;">&lt;/</span><span style="color: #008;">lifetime</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span></pre>||
||state||Specifies the state the scenario instantiation will enter after the action will be executed.||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span></pre>||
||end_dialog_leg||This node tells the B2BUA to end the call that has just received an event ( request or reply). The B2BUA will send a BYE request to the party.||<pre><span style="color: #660;">&lt;</span><span style="color: #008;">end_dialog_leg</span><span style="color: #660;">/&gt;</span></pre>||


Bellow is an action example:
[[<<]]
%color=#ff7f00% Ex: %black%'''Scenario action node'''
>>lframe<<
<pre><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"initial"</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]


[[#Scenario_examples]]
!! Scenario Examples
!!! Topology Hiding
No scenario document must be defined for this usage case. This is a built in mechanism and it
can be requested to the B2B Logic by specifying the name "top hiding".
The functionality is a simple pass through with the creation of a new dialog on the other side
and transferring all the messages received on one side to the other side taking care only to
change the dialog information.

!!!!Scenario Schema
Here is the theoretical expected message trace:

http://www.opensips.org/images/top_hiding_schema.jpeg


!!! Prepaid
This scenario can be used by a company for prepaid users to announce them at the beginning of the call what their credit is and at the end of the call what their remaining credit is.

What must happen at session level is:

# the caller is connected to a media server
# the caller is connected to the callee
# if the callee hangs up the phone before the caller, the caller is connected to a media server (the same or other).

In B2BUA terms, this is a script scenario that can be instantiating by specifying the id '''prepaid'''. It requires 2 parameters:
* the location of the first media server
* the location of the second media server

!!!! Scenario Schema
To establish this sessions the SIP message flow has to look like this( it is assumed that the
same media server is used):

http://www.opensips.org/images/ppaid.jpeg

!!!! Scenario Document
The full scenario document is printed bellow:
>>lframe<<
<pre><span style="color: #660;">&lt;?</span><span style="color: #000;">xml version</span><span style="color: #660;">=</span><span style="color: #080;">"1.0"</span><span style="color: #660;">?&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;</span><span style="color: #008;">scenario</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"prepaid"</span><span style="color: #000;"> </span><span style="color: #606;">name</span><span style="color: #660;">=</span><span style="color: #080;">"MS start and end"</span><span style="color: #000;"> </span><span style="color: #606;">param</span><span style="color: #660;">=</span><span style="color: #080;">"2"</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"script"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">message</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"1"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">client</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"initial"</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"2"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">client</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">scenario</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span></pre>
>><<
[[<<]]

!!! Marketing
The last test case is called “Marketing”, because it suits very well to the requirements of a marketing campaign through phone. The company might choose a list of potential costumers to call and announce about a new product/offer/discount. The message will be a recorded one, but the costumer will also be offered the possibility to talk to a human operator. If the costumer does not hung up the phone before the recorded message ends, it will be connected to a human operator. This is also a good means to filter the interested costumers and make the process more efficient with less resources used.

The OpenSIPS B2BUA must connect two end points, start the call from the middle. It is different from the other examples, since the call is initiated by the B2BUA and it is triggered by a MI command.

The id which must be mentioned to start this service is 'marketing'. It requires 3 parameters
* the URI of the possible costumer
* the URI of the media server
* the URI of the human operator

!!!! Scenario Schema
Below is the theoretical message flow that should occur for this functionality to be achieved.

http://www.opensips.org/images/marketing.jpeg

!!!! Scenario Document
The scenario document that describes this service is:
>>lframe<<
<pre><span style="color: #660;">&lt;?</span><span style="color: #000;">xml version</span><span style="color: #660;">=</span><span style="color: #080;">"1.0"</span><span style="color: #660;">?&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;</span><span style="color: #008;">scenario</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"marketing"</span><span style="color: #000;"> </span><span style="color: #606;">name</span><span style="color: #660;">=</span><span style="color: #080;">"MS start conditional"</span><span style="color: #000;"> </span><span style="color: #606;">param</span><span style="color: #660;">=</span><span style="color: #080;">"3"</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"extern"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"1"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">client</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">sender</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">condition</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">200</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">OK</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">delete_entity</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"param"</span><span style="color: #660;">&gt;</span><span style="color: #000;">3</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;">2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">state</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bye</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">scenario</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]

!!! REFER Scenario

The B2BUA component can also be configured to handle blind transfers(with REFER SIP message). This is useful when in the platform there are devices that do not accept the REFER method. The scenario for this case is very simple and has one rule for when a REFER is received. This rule tells the B2BUA to end the call with the user agent that sent the refer message and to bridge the peer with the user specified in the 'Refer-To' header.

!!!! Scenario Document
The scenario document that describes this service is:
>>lframe<<
<pre><span style="color: #660;">&lt;?</span><span style="color: #000;">xml version</span><span style="color: #660;">=</span><span style="color: #080;">"1.0"</span><span style="color: #660;">?&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;</span><span style="color: #008;">scenario</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"refer"</span><span style="color: #000;"> </span><span style="color: #606;">name</span><span style="color: #660;">=</span><span style="color: #080;">"Handle refer at server"</span><span style="color: #000;"> </span><span style="color: #606;">param</span><span style="color: #660;">=</span><span style="color: #080;">"0"</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"script"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">server</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;">message</span><span style="color: #660;">&lt;/</span><span style="color: #008;">type</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"initial"</span><span style="color: #660;">&gt;</span><span style="color: #000;">server1</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">init</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br><br>&nbsp; </span><span style="color: #660;">&lt;</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">refer</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">rule</span><span style="color: #000;"> </span><span style="color: #606;">id</span><span style="color: #660;">=</span><span style="color: #080;">"1"</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;">202</span><span style="color: #660;">&lt;/</span><span style="color: #008;">code</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;">Accepted</span><span style="color: #660;">&lt;/</span><span style="color: #008;">reason</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">send_reply</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">end_dialog_leg</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">peer</span><span style="color: #660;">/&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;">client2</span><span style="color: #660;">&lt;/</span><span style="color: #008;">id</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;</span><span style="color: #008;">value</span><span style="color: #000;"> </span><span style="color: #606;">type</span><span style="color: #660;">=</span><span style="color: #080;">"header"</span><span style="color: #660;">&gt;</span><span style="color: #000;">Refer-To</span><span style="color: #660;">&lt;/</span><span style="color: #008;">value</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">destination</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">client</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">bridge</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">action</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">rule</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; &nbsp; &nbsp;</span><span style="color: #660;">&lt;/</span><span style="color: #008;">refer</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; &nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">request</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br>&nbsp; </span><span style="color: #660;">&lt;/</span><span style="color: #008;">rules</span><span style="color: #660;">&gt;</span><span style="color: #000;"><br></span><span style="color: #660;">&lt;/</span><span style="color: #008;">scenario</span><span style="color: #660;">&gt;</span></pre>
>><<
[[<<]]


[[#Configuration_file_example]]
!! Configuration file

%color=#ff7f00% You must note that, a call that is handled by the B2B will not have the normal ‘proxy like’ interaction with the script.

Once you ask b2b to handle a call, you '''won't see the future in-dialog request in the normal route'''. The reason is that in the normal route you do proxy operations - changes on the message, routing decisions, but for the b2b calls those requests will have the b2b as an endpoint. The b2b will then generate new messages that will be sent on the other side. It will not forward the received ones. Those new generated can be accessed in local_route.

If the scenario is called from script on an initial Invite, you must take care to drop this request after calling b2b_init_request() function on it ( call 'exit', don't call t_relay() on it ).

When using b2b all the changes that you want to perform on a message must be done in local_route on the new generated request that will be sent out.

Because sometimes it is required to also access the received requests, you can define a special route '''b2b_request route''' where you can do 'read-only' operation on the request, like accounting or logging.
Also, you can define a special '''b2b_reply route''' where you can see the received replies.

As a conclusion, when a call is handled by the b2bua, SIP messages for that call will be accessible in:
* '''b2b_request route''' : the received requests. This request will not be forwarded so doing changes on the message will have no effect. This route is useful for logging and accounting.
* '''b2b_reply route''' : the received replies. The same as with the requests, it has no effect to do changes on it.
* '''local_route''' : the SIP requests that are sent out by the b2bua. Here changes on the message can be performed.

%color=#ff7f00% Also, note that '''dialog''' module does not work with B2BUA. The reason is that this module was designed to handle proxy dialogs.

!!! Writing the configuration file

There are some requirements for a configuration file that enables the B2BUA services.

* load modules '''b2b_entities''' and '''b2b_logic'''
* set module parameters
** compulsory: the '''server_address''' parameter in b2b_entities
** optional:
*** '''script_scenario''' and '''extern_scenario''' in b2b_logic for loading service scenarios
*** parameters for the hash tables - server_hsize and client_hsize in b2b_entities module and '''hash_size''' in b2b_logic module

* load a MI module if you need to support triggering B2BUA scenarios with extern commands. Depending on the transport you require, either mi_fifo or mi_xmlrpc or mi_datagram.
* built the filters and call the script scenario instantiating function

Also please note that you need to configure the tm module to pass provisional replies. For this you need to set the module parameter:

>>lframe blue<<
<pre><span style="color: #000;">modparam</span><span style="color: #660;">(</span><span style="color: #080;">"tm"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"pass_provisional_replies"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #066;">1</span><span style="color: #660;">)</span></pre>
>><<
[[<<]]


!!! Example

You can find [[Documentation.Tutorials-B2BUAConfigExample|here]] a configuration file example that loads the two scenarios presented in this tutorial and enables the '''prepaid''' service for a certain user. Also the mi_fifo module is loaded here and it will be possible to send MI commands to instantiate the '''marketing''' scenario.

!!! Script routes
!!!! Special B2B route
The requests and replies that are received by the B2BUA server, belonging to the dialogs it is handling will not go into the script as normal request do. The reason for this is that this are not normal requests where the server is a proxy, but the server is an endpoint in the dialog and therefore they should not go through the same routes. However, it is normal for this request to be seen from the script and allow the script writer to do the processing it desires based on them. For this, it is possible to define two special B2B routes - one for requests and one for replies. The routes are of type '''route''' and have their name defined in the modules parameters '''script_req_route''' and '''script_reply_route'''.

>>lframe blue<<
<pre><span style="color: #000;">modparam</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_entities"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"script_req_route"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"b2b_request"</span><span style="color: #660;">)</span><span style="color: #000;"><br>modparam</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_entities"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"script_reply_route"</span><span style="color: #660;">,</span><span style="color: #000;"> </span><span style="color: #080;">"b2b_reply"</span><span style="color: #660;">)</span><span style="color: #000;"><br><br>route</span><span style="color: #660;">[</span><span style="color: #000;">b2b_request</span><span style="color: #660;">]</span><span style="color: #000;"> </span><span style="color: #660;">{</span><span style="color: #000;"><br>&nbsp; xlog</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_request ($ci)\n"</span><span style="color: #660;">);</span><span style="color: #000;"><br></span><span style="color: #660;">}</span><span style="color: #000;"><br><br><br>route</span><span style="color: #660;">[</span><span style="color: #000;">b2b_reply</span><span style="color: #660;">]</span><span style="color: #000;"> </span><span style="color: #660;">{</span><span style="color: #000;"><br>&nbsp; xlog</span><span style="color: #660;">(</span><span style="color: #080;">"b2b_reply ($ci)\n"</span><span style="color: #660;">);</span><span style="color: #000;"><br></span><span style="color: #660;">}</span></pre>
>><<
[[<<]]


!!!! Failure route not available for B2B

It is impossible to have a '''t_on_failure()''' mechanism (which is transaction specific) on a B2BUA scenario (where you have multiple dialogs, with multiple transactions) - for complex scenarios, with multiple dialogs, you cannot say for which transaction to trigger the failure route for. The "topo hiding" scenario is a very simple B2BUA scenario, but you cannot have a general "on_failure" concept for all b2bua scenarios.

A solution is to consider that b2bua is a separate instance (logically speaking) which selects types/classes of destinations. A proxy instance will responsible for routing inside the class of destinations.

For ex: in a scenario we can sent in the first place the call to Media Server for some announcement and later to PSTN GW. In a first step, the b2bua scenario will sent to proxy the call with RURI pointing to "a class"
of media servers - the proxy will select the proper media server and do the failover between the media servers, totally transparent for the b2bua. In a similar way, on the second step, the b2bua scenario will indicate to proxy that it wants to have the call to be sent to PSTN GW (as type of destination) - the proxy will do lcr, drouting, failover between the GW.

Page last modified on January 19, 2023, at 06:12 PM