= Пример конфигурации !FreeSwitch для разговора двух абонентов в конференции =

Данная статья описывает пример настройки !FreeSwitch (FS) для реализации сценария вызова одним абонентом другого через конференцию. Задача поставлена в ticket:125 и включает следующеие моменты:

- при вызове создается конференция с именем типа `<caller Name>(<caller Number>) -> <callee Name>(<callee Number>)` (например `Вася(123) -> Петя(456)`), вызывающий и вызываемый абоненты добавляются в конференцию и ведут там разговор;
- пока вызываемый абонент не вошел в конференцию, вызывающий слышит КПВ;
- если вызов заканчивается неудачно (например вызываемый недоступен, вызываемый отказался принять вызов и т.п.), вызывающий должен слышать сигнал "Занято".

== Конфигурация конференций ==

Создадим профиль конференций для нашей задачи. В файле `/etc/freeswitch/autoload_configs/conference.conf.xml` пишем такой фрагмент:

{{{#!xml
<configuration name="conference.conf" description="Audio Conference">
  ....
  <profiles>
    ....
    <profile name="2-way-calls">
      <param name="domain" value="$${domain}"/>
      <param name="member-flags" value="mintwo"/>
      <param name="rate" value="8000"/>
      <param name="interval" value="20"/>
      <param name="caller-controls" value="none"/>
      <param name="energy-level" value="200"/>
      <param name="moh-sound" value="tone_stream://%(1000,3000,440)"/>
      <param name="cdr-event-mode" value="content"/>
    </profile>
    ....
  </profiles>
  ....
</configuration>
}}}

В приведенном примере профиля есть следующие моменты, важные для решаемой задачи:

- `<param name="member-flags" value="mintwo"/>` - этот флаг обеспечит отбой второго абонента когда один из собеседников отключится от конференции;
- `<param name="moh-sound" value="tone_stream://%(1000,3000,440)"/>` - пока вызывающий абонент - единственный участник конференции, ему будет воспроизводиться сигнал КПВ.

== Дайлплан ==

Теперь создадим дайлплан для нашей задачи. Вызывающий абонент будет вызывать номер 456:

{{{#!xml
<include>
  <extension name="call-in-conference">
    <!-- Проверим, что вызывается номер 456 -->
    <condition field="destination_number" expression="^456$">

      <!-- Формируем имя конференции -->
      <action application="set" data="conference_name=${caller_id_name}(${caller_id_number}) -> ${callee_id_name}(${destination_number})" />

      <!-- Установим параметры функции conference_auto_outcall -->
      <action application="set" data="conference_auto_outcall_timeout=60"/>
      <action application="set" data="conference_auto_outcall_flags=none"/>
      <action application="set" data="conference_auto_outcall_skip_member_beep=true"/>
      <!-- Имя и номер вызывающего абонента -->
      <action application="set" data="conference_auto_outcall_caller_id_name=${caller_id_name}"/>
      <action application="set" data="conference_auto_outcall_caller_id_number=${caller_id_number}"/>
      <action application="conference_set_auto_outcall" data="user/${destination_number}"/>

      <!-- Включаем вызывающего абонента в конференцию -->
      <action application="conference" data="${conference_name}@2-way-calls"/>

    </condition>
  </extension>
</include>
}}}

В приведенном примере при вызове номера 456 создается конференция с именем типа `Вася(123) -> Петя(456)` и с профилем `2-way-calls`, сконфигурированным ранее, в нее включается вызывающий абонент, и выполняется вызов в конференцию вызываемого абонента 456.

В приведенном выше примере не выполняется последнее требование - в случае неудачного вызова вызывающий должен слышать сигнал "Занято". Сейчас же в случае если вызываемый абонент отклонит вызов, вызывающий будет продолжать слушать сигнал КПВ. Для выполнения последнего требования создадим в дайлплане специальное расширение `busy`, которое передает сигнал "Занято":

{{{#!xml
  <extension name="Play BUSY tone">
    <condition field="destination_number" expression="^busy$">
      <action application="answer"/>
      <action application="playback" data="tone_stream://%(330,330,440);loops=-1"/>
    </condition>
  </extension>
}}}

И дополним вызов в конференцию так, чтобы при неудаче вызова исходного абонента вызывалось расширение busy:

`<action application="conference_set_auto_outcall" data="user/${destination_number}|loopback/busy"/>`

Пример дайлплана, передающего в конференцию "Занято" в случае неудачного вызова:

{{{#!xml
<include>
  <extension name="Play BUSY tone">
    <condition field="destination_number" expression="^busy$">
      <action application="answer"/>
      <action application="playback" data="tone_stream://%(330,330,440);loops=-1"/>
    </condition>
  </extension>

  <extension name="call-in-conference">
    <!-- Проверим, что вызывается номер 456 -->
    <condition field="destination_number" expression="^456$">

      <!-- Формируем имя конференции -->
      <action application="set" data="conference_name=${caller_id_name}(${caller_id_number}) -> ${callee_id_name}(${destination_number})" />

      <!-- Установим параметры функции conference_auto_outcall -->
      <action application="set" data="conference_auto_outcall_timeout=60"/>
      <action application="set" data="conference_auto_outcall_flags=none"/>
      <action application="set" data="conference_auto_outcall_skip_member_beep=true"/>
      <!-- Имя и номер вызывающего абонента -->
      <action application="set" data="conference_auto_outcall_caller_id_name=${caller_id_name}"/>
      <action application="set" data="conference_auto_outcall_caller_id_number=${caller_id_number}"/>
      <action application="conference_set_auto_outcall" data="user/${destination_number}|loopback/busy"/>

      <!-- Включаем вызывающего абонента в конференцию -->
      <action application="conference" data="${conference_name}@2-way-calls"/>

    </condition>
  </extension>
</include>
}}}