Загрузка клиентов с внешнего сайта

Есть несколько типовых ситуаций, когда может быть необходим  функционал добавления пользователей в базу с вашего корпоративного сайта:

1. Форма подписки на новости
2. Заявки клиентов на участие в каком либо мероприятии
3. Некие страницы, на которых для получения бонуса (скидки, бесплатных материалов и т.п.) нужно ввести свои данные

Во всех этих случаях бывает нужно, чтобы была некая форма с полями, которые клиент должен заполнить и отправить в BasePlan.

Для этого у нас реализован функционал отправки анкет пользователей с вашего сайта напрямую в систему.

Читать данный раздел имеет смысл только программистам, остальным будет сложно понять, что здесь написано :)

Итак, для того, чтобы отправить введенные пользователем данные на сервер, нужно послать GET запрос через AJAX с типом JSONP (так как запрос кросс доменный).

Адрес, по которому нужно отправлять запрос: http://baseplan.ru/base/client_add_req.php

На входе принимаются следующие параметры:

Параметр	Описание	Тип поля
'a'	Код компании, описание чуть ниже	Число
'c'	Контрольный код, описание чуть ниже	Строка
'prs_fam'	Фамилия клиента	Строка
'prs_name'	Имя клиента	Строка
'prs_otch'	Отчество клиента	Строка
'prs_sex'	Пол – 1-женский, 0-мужской	Число
'prs_mob_phone'	Телефон мобильный (формат 8-911-111-1111 и т.п.)	Строка
'prs_mob_phone_mail'	Подписан на SMS рассылку (1-подписан, 2-не хочет получать)	Число
'prs_email'	Email (только один адрес – типа some_name@gmail.com)	Строка
'prs_email_mail'	Подписан на Email рассылку (1-подписан, 2-не хочет получать)	Число
'prs_agt_comments'	Ваши собственные комментарии к форме	Строка
'prs_comments'	Комментарии пользователя	Строка
'act_id'	Номер вашего мероприятия, куда хочет записаться клиент	Число
'act_tid'	Номер шаблона мероприятий, если нет возможности передать номер мероприятия	Число
'act_sum'	Размер оплаты клиентом за мероприятие (если клиент уже оплатил вам все)	Число

Чтобы узнать параметры ‘a’ и ‘c’ нужно зайти в настройки компании (в правом верхнем углу), там кликнуть на зеленую кнопку «Настройка интеграции», потом напротив пункта "Информер" кликнуть на "Настройки", затем на появившейся странице нажать на кнопку «Сохранить и показать».

Чуть ниже, в поле «Код информера для вставки на ваш сайт» появится HTML код для вставки, в нем и нужно искать эти два параметра – на скриншоте сверху они выделены зелёным. В примере параметр ‘a’ = 3, параметр ’c’ = ‘7acf71e199175f7cf71e199631c07190’. Это все заносится в hidden поля.

Еще есть поле 'prs_agt_comments' – обычно это тоже поле с типом hidden, в котором можно указать любой текст, описывающий, с какой страницы пришел клиент (на случай, если на вашем сайте есть разные формы для отправки анкеты – например для разных мероприятий).

Внимание! Обязательны для заполнения поля «Фамилия» и «Имя», а так же должно быть указано хотя бы одно из полей с контактными данными (Email или телефон).

Значение для полей с номером мероприятия или шаблона проще всего узнать, зайдя в их редактирование. В адресной строке браузера, в конце адреса, будет что-то вроде "activity_add.php?id=111" для мероприятия или "activity_template.php?id=222" для шаблона. Вот эти 111 или 222 и есть номера мероприятия и шаблона соответственно. Передавать нужно что-то одно - либо номер мероприятия, если оно уже известно, или шаблон. Если данное мероприятие проходит часто и вам неудобно менять этот номер на своем сайте все время, можно указать номер шаблона, из которого вы делаете это мероприятие. Тогда при записи клиента вам будет предложен выбор из всех мероприятий, проходящих в будущем и созданных из этого шаблона.

После отправки запроса, сервер возвращает ответ в формате JSON, в котором поле «success» содержит результат выполнения запроса (TRUE если все в порядке, или FALSE если произошла ошибка). В поле «mess» будет сообщение, а в поле «code» - код ошибки (ноль, если  success=TRUE).

Если что-то заполнено не так или возникла какая либо ошибка, то  поле success=FALSE, в «mess» будет текст ошибки, а в поле «code» её код:

code	mess	Примечание
1	Ошибка в параметрах формы	Параметры ‘a’ или ‘c’ переданы неверно
2	Не указана фамилия
3	Не указано имя
4	Не указан хотя бы один способ связи	Должны быть указаны либо Email либо сотовый (или оба) контакт.
5	Произошла внутренняя ошибка	Какой-то внутренний сбой сервиса, нужно попробовать отправить запрос позднее.

 

После получения успешного ответа от сервера, вы можете перенаправить клиента на любую страницу или показать ему какое-то сообщение на ваше усмотрение.

Рабочий пример того, как можно реализовать отправку данных можно посмотреть здесь: http://istota.ru/clnt_add_expample.php

Пример сделан с использованием библиотеки jQuery. В нем отправляется только часть информации (Фамилия, Имя, Email, сотовый и Комментарий, а так же внутренние примечания). Так же сделан ввод параметров ‘a’ и ‘c’ для тестирования.

---

После входа в BasePlan, если есть отправленные анкеты, вы увидите сообщение на главной странице:

 

При щелчке на ссылку, будет показана форма работы с анкетами, присланными клиентами.

Здесь можно искать ранее присланные анкеты, а так же работать с текущими. Любую анкету можно отклонить, если, скажем, она заполнена некорректно, или же если такой клиент уже есть в вашей базе (в поле «Совпадение в базе» показывают уже имеющиеся клиенты, у которых совпадают либо Email либо телефон, по ФИО здесь совпадения не показываются). Если вы хотите добавить этого клиента в свою базу, нужно нажать «Добавить в базу» - будет показана форма добавления.

После того, как клиент был успешно добавлен в базу, вы увидите сообщение об успешном добавлении клиента, а так же ссылку на карточку клиента. Кликнув на неё, в отобразившейся карточку в меню операции можно записать клиента на любой мероприятие, отправить ему сообщение и т.п.