h1. Система отправки сообщений
За настройку отправки СМС сообщений в Carbon Billing 5 отвечают следующие параметры:
* Тихий час - период времени, когда сообщения не отправляются абонентам.
* Заголовок сообщения - указывается тема письма.
* Адрес СМС шлюза - используется при СМС рассылке.
* Post параметры - параметры для СМС рассылки. %sms%-телефон рассылки, %text% -сообщение.
{note:title=Важно:}
Для настройки отправки смс, у вашего смс шлюза должна быть возможность отправки смс путем вставки запроса в адресную строку браузера. Пример ниже.\*
{note}
Соответственно "Адрес СМС шлюза" это то, что {color:#000000}у провайдера шлюза указано{color} {color:#ff0000}слева{color} от символа "?", и "Post параметры СМС шлюза" это то что {color:#ff0000}справа{color}{color:#000000}, при этом переменные{color} {color:#000000}обозначаются как{color} {color:#008000}%(sms)s - номер телефона{color} {color:#008000}и %(text)s - текст сообщения{color}{color:#000000}.{color}
h2. Добавляем SMS-шлюз
!0.png|border=1!
h2. Производим настройку адреса и параметров отправки сообщения
h6. Для того, чтобы корректно работал шаблон сообщений "Отправлять за n дней", необходимо в настройках сообщений оператора связи указать параметр "Предупреждать о лимите за n дней"
!1.png|border=1!
h2. Добавляем шаблоны сообщений
!2.png|border=1!
Для каждого типа сообщения надо создать свой шаблон
!3.png|border=1!
Пример ниже:
Галочка *Отправлять сообщение* отвечает за то нужно отправлять сообщение или нет. Эту галочку можно также поставить в самом шаблоне при редактировании.
В шаблонах можно использовать следующие параметры:
%(contract_number)s - номер договора;
%(balance)s - текущий баланс;
%(currecy)s - валюта сокращение (например руб.);
%(text)s - передаваемый текст (сообщение непосредственно конкретному абоненту);
%(operator_name)s - имя оператора связи(по умолчанию "Лучший провайдер");
%(allow_limit)s - сумма, которая указана в пороге включения(тариф);
%(gen_pwd)s - созданный через админ. панель пароль(не существует, если пароль изменен через ЛК);
%(tarif_name)s - тариф абонента;
%(plan_comment)s - описание тарифа (например скорость, указывается руками);
%(recomend_pay_sum)5.2f - рекомендуемый платеж
%(recomend_pay_sum_post)5.2f - рекомендуемый платеж постоплата
%(minimal_pay_sum)5.2f - минимальный платеж для разблокировки
,а также любые поля абонента, тарифа, счета.
*Текст заголовка* \- тема e-mail или заголовок смс.
*Текст шаблона* \- непосредственно отправляемый текст.
Каждый шаблон сообщения может быть отправлен по любому из выбранных событий:
* *Подключение услуги* \- приходит абоненту при подключении услуги;
* *Положительный баланс* \- приходит абоненту при переходе абонента в положительный баланс(ниже порога отключения абонента);
* *Отрицательный баланс* \- приходит абоненту при переходе абонента в отрицательный баланс(выше порога отключения абонента);
* *Выставлен счет* \- приходит абоненту при выставлении счета абоненту (используется чаще для юр.лиц). Для того, чтобы отправка счета выполнялась вручную из вкладки "Операции", шаблон с данным типом должен быть включен. Вместе со счетом юр.лицам отправляется ещё и акт. Отправка акта выполняется с помощью этого же шаблона сообщений(Выставлен счет);
* *Зачисление денег* \- приходит абоненту при поступлении средств на счет (при условии что в настройках абонента стоят галочки Юр.лицо и Отправлять Счет/Акт, а также Настройки - Число месяца выставления счетов на предоплату);
* *Ручная отправка сообщения* \- при ручной отправке;
* *Занесено в Аудит* \- при занесении информации в Аудит;
* *Достигнут порог предупреждения* \- при достижении порога предупреждения (порог предупреждения из опций тарифа);
* *Сообщение из HelpDesk* \- при создании заявки от абонента в HelpDesk (приходит инженерам Helpdesk);
* *Сообщение из CRM* \- при создании задачи в CRM (приходит ответственному исполнителю).
В настоящее время поддерживаются 4 способа отправки сообщений пользователям:
!mess3_80.png|border=1!
* Письмо на e-mail;
* SMS сообщение на телефон;
* Всплывающее сообщение в Carbon Agent;
* Передача сообщения по winpopup (редко используется).
Если не выбрать конкретный вид сообщения, то рассылка будет вестись всеми доступными средствами.
h4. {color:#000000}Отправитель{color}
Поле отправитель зависит от типа сообщения:
* Если сообщение системное, например у пользователя кончились деньги на счёте, то в поле отправитель будет указан e-mail, принадлежащий группе "Все" (id 1);
* Если сообщение отправлялось вручную с помощью веб-интерфейс администратора Carbon Billing 5, то отправителем будет указан e-mail администратора системы, который это сообщение отправил;
* Если данные поля не заполнены, отправителем будет почта вида root@www.example.com, где www.example.com - доменное имя главного внешнего интерфейса.
h2. Отправка сообщений
Для отправки сообщений непосредственно одному из абонентов необходимо зайти в раздел Абоненты, выбрать абонента, вкладка Отправить сообщения. Выбирается метод отправки и пишется текст сообщения.
h2. Отладка
Логи работы демона отправки сообщений за текущие сутки находятся в файле /app/asr_billing/var/log/msgd.log
Логи за прошедшие сутки архивируются в этом же каталоге под названием msgd.log-<date>.gz
h2. Настройка e-mail'ов или кому, что и от кого приходит
h4. Группа "Все"
Подходящее имя: что-то вроде info@provider.name
Что отправляется от её имени: системные сообщения о том, что баланс положительный, баланс отрицательный и т.д.
h2. Пример оператора смс-шлюза
Вот один из примеров оператора смс-шлюза, который можно настроить в Carbon Billing 5 [http://smsc.ru/|http://smsc.ru/?pp328703/]
За настройку отправки СМС сообщений в Carbon Billing 5 отвечают следующие параметры:
* Тихий час - период времени, когда сообщения не отправляются абонентам.
* Заголовок сообщения - указывается тема письма.
* Адрес СМС шлюза - используется при СМС рассылке.
* Post параметры - параметры для СМС рассылки. %sms%-телефон рассылки, %text% -сообщение.
{note:title=Важно:}
Для настройки отправки смс, у вашего смс шлюза должна быть возможность отправки смс путем вставки запроса в адресную строку браузера. Пример ниже.\*
{note}
Соответственно "Адрес СМС шлюза" это то, что {color:#000000}у провайдера шлюза указано{color} {color:#ff0000}слева{color} от символа "?", и "Post параметры СМС шлюза" это то что {color:#ff0000}справа{color}{color:#000000}, при этом переменные{color} {color:#000000}обозначаются как{color} {color:#008000}%(sms)s - номер телефона{color} {color:#008000}и %(text)s - текст сообщения{color}{color:#000000}.{color}
h2. Добавляем SMS-шлюз
!0.png|border=1!
h2. Производим настройку адреса и параметров отправки сообщения
h6. Для того, чтобы корректно работал шаблон сообщений "Отправлять за n дней", необходимо в настройках сообщений оператора связи указать параметр "Предупреждать о лимите за n дней"
!1.png|border=1!
h2. Добавляем шаблоны сообщений
!2.png|border=1!
Для каждого типа сообщения надо создать свой шаблон
!3.png|border=1!
Пример ниже:
Галочка *Отправлять сообщение* отвечает за то нужно отправлять сообщение или нет. Эту галочку можно также поставить в самом шаблоне при редактировании.
В шаблонах можно использовать следующие параметры:
%(contract_number)s - номер договора;
%(balance)s - текущий баланс;
%(currecy)s - валюта сокращение (например руб.);
%(text)s - передаваемый текст (сообщение непосредственно конкретному абоненту);
%(operator_name)s - имя оператора связи(по умолчанию "Лучший провайдер");
%(allow_limit)s - сумма, которая указана в пороге включения(тариф);
%(gen_pwd)s - созданный через админ. панель пароль(не существует, если пароль изменен через ЛК);
%(tarif_name)s - тариф абонента;
%(plan_comment)s - описание тарифа (например скорость, указывается руками);
%(recomend_pay_sum)5.2f - рекомендуемый платеж
%(recomend_pay_sum_post)5.2f - рекомендуемый платеж постоплата
%(minimal_pay_sum)5.2f - минимальный платеж для разблокировки
,а также любые поля абонента, тарифа, счета.
*Текст заголовка* \- тема e-mail или заголовок смс.
*Текст шаблона* \- непосредственно отправляемый текст.
Каждый шаблон сообщения может быть отправлен по любому из выбранных событий:
* *Подключение услуги* \- приходит абоненту при подключении услуги;
* *Положительный баланс* \- приходит абоненту при переходе абонента в положительный баланс(ниже порога отключения абонента);
* *Отрицательный баланс* \- приходит абоненту при переходе абонента в отрицательный баланс(выше порога отключения абонента);
* *Выставлен счет* \- приходит абоненту при выставлении счета абоненту (используется чаще для юр.лиц). Для того, чтобы отправка счета выполнялась вручную из вкладки "Операции", шаблон с данным типом должен быть включен. Вместе со счетом юр.лицам отправляется ещё и акт. Отправка акта выполняется с помощью этого же шаблона сообщений(Выставлен счет);
* *Зачисление денег* \- приходит абоненту при поступлении средств на счет (при условии что в настройках абонента стоят галочки Юр.лицо и Отправлять Счет/Акт, а также Настройки - Число месяца выставления счетов на предоплату);
* *Ручная отправка сообщения* \- при ручной отправке;
* *Занесено в Аудит* \- при занесении информации в Аудит;
* *Достигнут порог предупреждения* \- при достижении порога предупреждения (порог предупреждения из опций тарифа);
* *Сообщение из HelpDesk* \- при создании заявки от абонента в HelpDesk (приходит инженерам Helpdesk);
* *Сообщение из CRM* \- при создании задачи в CRM (приходит ответственному исполнителю).
В настоящее время поддерживаются 4 способа отправки сообщений пользователям:
!mess3_80.png|border=1!
* Письмо на e-mail;
* SMS сообщение на телефон;
* Всплывающее сообщение в Carbon Agent;
* Передача сообщения по winpopup (редко используется).
Если не выбрать конкретный вид сообщения, то рассылка будет вестись всеми доступными средствами.
h4. {color:#000000}Отправитель{color}
Поле отправитель зависит от типа сообщения:
* Если сообщение системное, например у пользователя кончились деньги на счёте, то в поле отправитель будет указан e-mail, принадлежащий группе "Все" (id 1);
* Если сообщение отправлялось вручную с помощью веб-интерфейс администратора Carbon Billing 5, то отправителем будет указан e-mail администратора системы, который это сообщение отправил;
* Если данные поля не заполнены, отправителем будет почта вида root@www.example.com, где www.example.com - доменное имя главного внешнего интерфейса.
h2. Отправка сообщений
Для отправки сообщений непосредственно одному из абонентов необходимо зайти в раздел Абоненты, выбрать абонента, вкладка Отправить сообщения. Выбирается метод отправки и пишется текст сообщения.
h2. Отладка
Логи работы демона отправки сообщений за текущие сутки находятся в файле /app/asr_billing/var/log/msgd.log
Логи за прошедшие сутки архивируются в этом же каталоге под названием msgd.log-<date>.gz
h2. Настройка e-mail'ов или кому, что и от кого приходит
h4. Группа "Все"
Подходящее имя: что-то вроде info@provider.name
Что отправляется от её имени: системные сообщения о том, что баланс положительный, баланс отрицательный и т.д.
h2. Пример оператора смс-шлюза
Вот один из примеров оператора смс-шлюза, который можно настроить в Carbon Billing 5 [http://smsc.ru/|http://smsc.ru/?pp328703/]