... h4. Требования
Для работы этой системы необходимо:
* Carbon Billing версии 4.0.1 или выше
* Для того, чтобы ваши письма прошли проверку на спам, на ip-адрес, с которого будет отправляться почта(внешний ip Carbon Billing), нужно настроить все [инструкции|http://docs.carbonsoft.ru/pages/viewpage.action?pageId=2687516].
h4. Виды сообщений
В настоящее время поддерживаются 4 вида сообщений пользователям
* Письмо на e-mail
* SMS сообщение на телефон
* Всплывающее сообщение в Carbon Agent
* Передача сообщения по winpopup (редко используется)
Если не выбрать конкретный вид сообщения, то рассылка будет вестись всеми доступными средствами.
h4. Отправитель
Поле отправитель зависит от типа сообщения.
Если сообщение системное, например у пользователя кончились деньги на счёте, то в поле отправитель будет указан e-mail, принадлежащий группе "Все" (id 1)
Если сообщение отправлялось вручную с помощью Carbon Manager, то отправителем будет указан e-mail администратора системы, который это сообщение отправил.
Если данные поля не заполнены, отправителем будет почта вида root@www.example.com, где www.example.com - доменное имя главного внешнего интерфейса.
h4. Шаблоны счетов
Шаблоны счетов доступны для редактирования и находятся в каталоге:
/mnt/rw_disc/etc/templates
Отредактировать их можно с помощью находящихся на сервере редакторов vi или mcedit, либо забрав по scp на рабочую станцию и вернув, после редактирования, обратно.
h2. Настройка. Версия 4.0.х и выше
Для версий от 4.0.х описываемые настройки производятся в разделе Сервис \-> Настройка системы сообщений
!d.png|border=1!
Далее:
За настройку отправки СМС сообщений в Carbon Manager отвечают 2 констатны доступ к которым можно получить через пункт главного меню "Сервис-> Система настройки сообщений". Соответственно "Адрес СМС шлюза" это то, что {color:#000000}у провайдера шлюза указано{color} {color:#ff0000}слева{color} от символа "?", и "Post параметры СМС шлюза" это то что {color:#ff0000}справа{color}{color:#000000}, при этом переменные{color} {color:#000000}обозначаются как{color} {color:#008000}%sms% - номер телефона{color} {color:#008000}и %text% - текст сообщения{color}{color:#000000}.{color}
{color:#000000}Пример ниже:{color}
{color:#000000}Условия провайдера:{color}
[http://10.128.0.0/send?login=login&pass=password&tel=tel&text=text]
Настройка Carbon Manager:
!Снимок-Настройка системы сообщений.png|border=1!
* *
{color:#ff0000}Внимание:{color}
{color:#000000}Если сообщения не отправляются всем абонентам проверьте установлена ли галочка "Отправлять" два раза щелкнув по каждому из сообщений.{color}
!2.png|border=1!
h2. Шаблоны сообщений
*Существует несколько видов шаблонов:*
*1.* Отправляется при наступлении порога предупреждения и порога отключения
*2.* Отправляется при внесении изменений пользователю или группе
*3.* Шаблон ручной отправки сообщения
*4.* Отправляется при внесении средств абоненту или группе
*5.* Отправляется при отправке счета на оплату
*6.* Отправляется при превышении порога отключения
*7.* Отправляется при переходе из отрицательного баланса в положительный
*8.* Отправляется при добавлении услуги
*9.* Отправляется участникам группы техподдержки при создании заявки абонентом через локальный сайт (helpdesk)
*10.* Отправляется пользователю при смене пароля
*11.* Отправляется при выставлении акта в конце месяца, если в тарифе стоит соответствующая галочка.
*12.* Отправляется при взятии обещанного платежа
*13.* Отправляется при списании обещанного платежа
*14.* Отправляется при ответе на заявку через локальный сайт (helpdesk)
*15.* Отправляется при смене статуса заявки в helpdesk
*Примечание:* В версиях старше 4.0.1 есть поддержка транслитерации. Для смс сообщений в произвольном месте каждого шаблона нужно указать *$sms_translit$*, для e-mail *$email_translit$*
h2. *Переменные в шаблонах сообщений*
*%balance% *\- текущий баланс пользователя;
*%contract_number%* \- номер договора абонента;
*%params%* \- параметр, задаваемый для каждой переменной самой системой. Для каждого шаблона разный
*%allow_limit%* \- сумма задолженности+порог включения(если задан);
*%user_id%* \- id пользователя, его порядковый номер.
h2. Отправка сообщений
Существует два вида инициализации отправки сообщения:
1. Системные сообщений (генерируются при наступлении определенных событий)
2. Сообщения отправленные вручную
Для того, что бы отправить сообщение вручную:
1.Выберите в дереве пользователя или группу.
2.На панели инструментов или в контекстом меню нажмите кнопку !image235.png! *Отправить сообщение*.
3.Появится следующее окно:
!worddavd3c29a2defd17ae91c0e64dce593fb2e.png|height=100,width=194!
Введите текст сообщения.
Если вы отправляете сообщение группе, то при установке флажка !image068.png! *всем потомкам*, сообщение будет отправлено также и всем вложенным пользователям и подгруппам текущей группы.
4.Нажмите кнопку "*Отправить"*.
h2. Настройка e-mail'ов или кому, что и от кого приходит
h4. Группа "Все"
Подходящее имя: что-то вроде info@provider.name
Что отправляется от её имени: системные сообщения о том, что баланс положительный, баланс отрицательный и т.д.
h4. Главный администратор (емейл, указанный в Carbon Manager) и прочие администраторы
Подходящее имя: administrator@provider.name
Что отправляется от их имени: отчёты о их действиях (операции с деньгами), а также отправленные сообщения с помощью функции "Отправить сообщение".
h2. Отключение системы отправки сообщений
Начиная с версии 392 187, в случае проблем с отправкой сообщений можно временно её отключить с помощью опции в локальном меню:
"Дополнительные настройки > Настройки разработчиков > Включить систему отправки сообщений"
и после этого сделав перезагрузку или /etc/init.d/ideco_msgd stop и обратиться в техподдержку.
h2. Логирование сообщений
Лог отправки всех сообщений: /var/log/send_msg.log
Лог отправки email: /var/log/maillog
h2. Пример поддерживаемого оператора смс-шлюза
Вот один из примеров оператора смс-шлюза, который можно настроить в Carbon Billing 4 [http://smsc.ru/|http://smsc.ru/?pp328703/]
h2. Неподдерживаемые смс-шлюзы
\*смсгород ([http://smsgorod.ru/)*:] этот шлюз не поддерживает отправку смс через post-запросы. При этом через адресную строку браузера (метод get) сообщения успешно отправляются.
|