Документация
Как включить плагин?
После приобретения интеграции Hello Bonsai для Gravity Forms вам потребуется установить плагин на свой сайт WordPress. Давайте рассмотрим этот процесс.
Шаг 1: Установка
Войдите на свой сайт WordPress и перейдите в раздел «Плагины» → «Добавить плагин» → «Загрузить плагин» → Установите zip-файл и активируйте его.
Шаг 2: Зарегистрируйте плагин
Перейдите в раздел Формы → Настройки → Hello Bonsai и нажмите Активировать лицензию В разделе «Лицензия» введите свой лицензионный ключ и активируйте его.
Шаг 3: Подключите свою учетную запись Hello Bonsai
В своем аккаунте Hello Bonsai перейдите в... Настройки → Мой аккаунт → Интеграции → API для бонсай (новый) и создайте ключ API (он начинается с bonsai_at_Вернувшись в WordPress, вставьте его в раздел «Подключение Hello Bonsai» и нажмите «Сохранить настройки» — ключ будет проверен на соответствие Hello Bonsai, и учетная запись будет добавлена за один шаг.
Шаг 4: Создать ленту
Откройте форму, из которой хотите собирать лиды, перейдите в «Настройки» → вкладка «Hello Bonsai» и добавьте фид. Сопоставьте поля «Имя» и «Электронная почта», затем включите разделы «Компания» и «Сделка», если они вам нужны. Вот и все — следующая заявка будет отправлена в Hello Bonsai.
Подробная информация о функциях
Что создаётся в Hello Bonsai?
При каждой отправке данных каждая лента выполняет цепочку из четырех шагов:
- Компания (необязательно) – сопоставляется по домену и/или имени или создается, если ничего не совпадает.
- Контакт (всегда) – находится по точному адресу электронной почты и обновляется, или создается и связывается с компанией.
- По рукам (необязательно) – открывается на выбранном вами этапе воронки продаж, назначается, оценивается и прикрепляется к контакту и компании.
- Комментарий (необязательно) – документ, подтверждающий заключение нового соглашения.
Если последующий этап не может быть завершен, предыдущие этапы все равно учитываются – запись помечается. частично синхронизировано с простым и понятным объяснением того, какой именно шаг требует внимания, функция «Повторная отправка» продолжает работу с того места, где остановилась.
Поля контактов, которые он сопоставляет
- Имя (обязательно) – Поля имени в Gravity Forms автоматически объединяются (Имя + Фамилия).
- Электронная почта (обязательно) – уникальный ключ, по которому Hello Bonsai сопоставляет контакты.
- Должность
- Номер телефона
Это поля, которые API Hello Bonsai принимает в контактах на сегодняшний день. По мере расширения API Hello Bonsai (в планах компании — добавление пользовательских полей), этот плагин будет развиваться вместе с ним.
Если контакт уже существует, Вы выбираете поведение для каждой ленты: обновить существующий контакт с помощью отправленных значений (по умолчанию) или оставить его без изменений. В любом случае, отправленные данные связываются с существующим контактом — дубликаты никогда не создаются, и пустое необязательное поле никогда не перезаписывает реальные данные в Hello Bonsai.
Сопоставление компаний
Hello Bonsai рассматривает домены веб-сайтов как уникальные в рамках вашей учетной записи — домен может принадлежать только одной компании — что делает сопоставление доменов чрезвычайно надежным. В разделе «Компания» каждого фида доступны три режима сопоставления:
- Домен, затем название компании. (по умолчанию) – сначала попробовать домен, затем использовать точное (без учета регистра) совпадение имени.
- Только домен
- Название компании (только название)
Присвойте значение полю «Веб-сайт/Домен», и плагин будет стандартизировать вводимые посетителями данные. https://www.acme.com/contact становится acme.com перед сопоставлением. Если поле домена не сопоставлено, используется домен контакта. Адрес электронной почты Используется автоматически, а бесплатные почтовые сервисы (gmail.com, outlook.com, yahoo.com, icloud.com и десятки других) игнорируются, поэтому вы никогда не окажетесь в компании, использующей “Gmail”. Разработчики могут корректировать список бесплатных почтовых сервисов с помощью фильтра.
Когда ничто не подходит, Вы выбираете для каждого фида: создать компанию (по умолчанию) или пропустить этот шаг. Созданные компании получают имена из поля «Название компании», указанного в шаблоне, или из своего домена, если имя не было указано — тот же принцип, который использует сам Hello Bonsai.
При сопоставлении с существующей компанией изменения в ней не происходят. А когда существующий контакт отправляет данные в компанию, с которой он еще не связан, плагин создает связь, не изменяя основного контактного лица компании — то, что API Hello Bonsai делает на удивление сложным, обрабатывая это за вас.
Сделки
Включите раздел «Сделки», и каждый привлеченный лид сможет открыть сделку на вашей доске сделок Hello Bonsai. Hello Bonsai требует, чтобы каждая сделка принадлежала компании, поэтому раздел «Компания» должен быть включен и корректно отображаться — это будет ясно указано как в редакторе ленты, так и в результатах поиска, если это не так.
- Название сделки – поддерживает теги слияния Gravity Forms, например.
Website lead – {Name:1}. По умолчанию используется заголовок формы. - Стоимость сделки – Можно сопоставить любое поле формы, содержащее денежную сумму. Поля товаров считываются с учетом валюты (цена, а не название), и числовые поля тоже отлично работают.
- Этап трубопровода – В режиме реального времени отображается список этапов вашей сделки, полученный из вашего аккаунта Hello Bonsai. По умолчанию отображается первый этап.
- Назначить кому – не назначенный, участник подключенной учетной записи или любой активный член команды (также подключается в режиме реального времени).
- Заключить сделку – при каждой отправке или только при новом контакте. Второй вариант предотвращает накопление дублирующих сделок у постоянных клиентов.
Комментарии к сделке
Включите опцию комментирования, и плагин опубликует отправленное сообщение в только что созданной сделке — шаблон по умолчанию выглядит следующим образом: {form_title} с последующим {all_fields}, И вы можете настроить его с помощью любых тегов слияния. Тот, кто подхватит сделку в Hello Bonsai, увидит полный запрос, не покидая доску объявлений. (Комментарии в Hello Bonsai представляют собой обычный текст; форматирование удаляется Hello Bonsai.)
Результаты участия и повторная отправка
Каждая заявка получает Привет, Бонсай В блоке на странице с подробной информацией показано, что именно произошло:
- Синхронизировано – Все запрошенные шаги выполнены.
- Частично синхронизировано – Контакт в Hello Bonsai в безопасности, но на следующем этапе (с компанией, сделкой или комментарием) требуется внимание. В сообщении точно указано, на каком именно этапе и почему.
- Синхронизация не удалась – Ничего написать не удалось; в сообщении содержится собственная ошибка Hello Bonsai.
Созданные идентификаторы контакта, компании и сделки: кликабельные ссылки прямо в ваш аккаунт Hello Bonsai, Идентификатор запроса Hello Bonsai отображается в любом диалоге со службой поддержки.
Он Отправить повторно в Hello Bonsai Кнопка позволяет безопасно повторить неудачную или частичную синхронизацию: компании и контакты сопоставляются заново, а не дублируются, уже созданная сделка никогда не создается заново, а уже опубликованный комментарий никогда не публикуется дважды. Она также работает с записями, созданными до появления плагина — откройте любую более старую запись и нажмите. Отправить в Hello Bonsai засыпать его.
Теги слияния
{bonsai_contact_id} – Контактный ID Hello Bonsai, связанный с этой записью.
{bonsai_company_id} – Идентификатор компании Hello Bonsai, связанный с этой записью.
{bonsai_deal_id} – Для этой записи открыт идентификатор предложения Hello Bonsai.
Используйте их в уведомлениях, подтверждениях и полезных нагрузках веб-хуков. Обработка данных происходит синхронно во время отправки, поэтому идентификаторы уже определены, когда Gravity Forms отправляет уведомления по той же отправке — никаких состояний гонки. Теги для записей, которые не были созданы (например, отсутствие сделки для повторной отправки), просто отображаются пустыми.
Несколько учетных записей
Агентства и команды, работающие с несколькими брендами, могут подключить более одной учетной записи Hello Bonsai. Каждая учетная запись проверяется при добавлении, отображается в таблице «Подключенные учетные записи» с возможностью проверки и удаления, и каждый фид сам выбирает, на какую учетную запись отправлять сообщения — при этом используется учетная запись по умолчанию, если фид не указывает конкретную учетную запись. Учетные данные хранятся на сервере в вашей базе данных WordPress и никогда не отображаются на странице после сохранения.
Уведомления об ошибках и повторная синхронизация
Уведомления об ошибках – Добавьте адрес электронной почты в разделе «Формы» → «Настройки» → «Hello Bonsai» → «Отчеты об ошибках», и вы будете получать электронное письмо всякий раз, когда синхронизация завершается с ошибкой или завершается лишь частично. В письме будет содержаться лента новостей, точное сообщение о результате, идентификатор запроса Hello Bonsai и прямая ссылка на запись, чтобы вы могли изучить проблему и отправить письмо повторно всего в два клика.
Повторная синхронизация редактирования записи – При желании можно повторно запустить ленту данных формы при редактировании записи в административной панели WordPress, чтобы связанный контакт и компания Hello Bonsai получили исправленные значения. Сделки никогда не создаются дважды для одной и той же записи, независимо от того, сколько раз происходит повторная синхронизация.
Часто задаваемые вопросы
Где я могу получить API-ключ Hello Bonsai?
В вашем аккаунте Hello Bonsai в Настройки → API, Создайте ключ API – он начинается с bonsai_at_. Вставьте его на страницу настроек плагина, и он будет проверен и сохранен за один шаг. Любая учетная запись Hello Bonsai, которая может создать там ключ API, будет работать с этим плагином.
Почему не было заключено соглашение по моей заявке?
Hello Bonsai требует, чтобы каждая сделка принадлежала компании, поэтому раздел «Компания» в ленте должен быть включен и должен соответствовать или создавать компанию. В поле Hello Bonsai в записи точно указано, что произошло на каждом этапе — если компания была пропущена или сделка не могла быть завершена, об этом сообщается в сообщении сделки простым языком.
Что произойдет, если один и тот же человек отправит заявку дважды?
Плагин находит существующий контакт по электронной почте — дубликаты никогда не создаются. Для каждого фида вы выбираете, обновляет ли отправка данные контакта или оставляет их без изменений, а также открывает ли она новую сделку или только сделки при первом контакте. Компании повторно сопоставляются таким же образом.
Могу ли я добавить записи, отправленные до установки плагина?
Да. Откройте любую запись и нажмите. Отправить в Hello Bonsai в блоке Hello Bonsai. Он обрабатывает данные из ленты формы по этой записи с полной защитой от дубликатов, поэтому заполнение обратной ссылки безопасно, даже если некоторые из этих людей уже зарегистрированы в вашем Hello Bonsai.
Могу ли я сопоставлять пользовательские поля или отправлять загруженные файлы?
Пока нет — публичный API Hello Bonsai в настоящее время не поддерживает пользовательские поля, вложения файлов или веб-хуки. Плагин обрабатывает все, что принимает API сегодня, и по мере расширения API Hello Bonsai будет расширяться и этот плагин. А пока опция комментариев к сделкам — отличный способ показать полную заявку (все поля) тому, кто работает с потенциальным клиентом.
Могу ли я отправлять в Hello Bonsai только определённые работы?
Да, каждый фид поддерживает условную логику Gravity Forms (“Отправить в Hello Bonsai, если…”), поэтому вы можете ограничить синхронизацию по любому полю: только для соответствующих бюджетов, только для определенных выбранных услуг, только для неспамовых сообщений — в зависимости от того, что подходит для вашей формы.
Какие данные покидают мой сайт?
Только значения, которые вы указываете в ленте (плюс шаблон комментария, если он включен), отправляются напрямую в официальный API Hello Bonsai по протоколу HTTPS. Никакие данные не отправляются третьим лицам, и ничего не отправляется вообще, если не соблюдены условия ленты.
Работает ли это с кэшированием/CDN и оптимизацией скриптов?
Да, ничего настраивать не нужно. Вся синхронизация происходит на стороне сервера при отправке формы — нет никаких скриптов на стороне клиента, поэтому ничего не нужно исключать из кэширования, минификации или плагинов отложенной отправки.
Работает ли это с формами Gravity Forms, поддерживающими AJAX?
Да. Это работает с AJAX-формы а также стандартные (не AJAX) формы Gravity Forms.
Что произойдет, если Hello Bonsai будет работать медленно или недоступен во время отправки заявки?
Ваш посетитель защищен: плагин кратковременно повторяет попытки при кратковременных сбоях, но ограничивает общее время, которое он потратит на одну отправку (по умолчанию 40 секунд, регулируется с помощью фильтра), поэтому медленный API никогда не сможет зависнуть вашей формой. Все, что не удалось завершить, честно записывается в запись как неудачная или частичная — и если вы настроили уведомление об ошибке по электронной почте, вы об этом узнаете — затем один клик по кнопке «Повторная отправка» завершит работу, как только Hello Bonsai снова заработает.
Работает ли это с многосайтовой сетью WordPress?
Да. Каждый дочерний сайт подключает свою собственную учетную запись (или учетные записи) Hello Bonsai и настраивает свои собственные каналы, а удаление очищает всю сеть. С лицензией Unlimited сетевой режим позволяет отправить один лицензионный ключ на каждый дочерний сайт за один раз.
Готов ли он к переводу?
Да, каждую строку можно перевести. Вы можете использовать бесплатную версию. Плагин Loco Translate Чтобы создать перевод для языка/локали вашего сайта. Если вы никогда раньше не пользовались Loco Translate, вот инструкция. Урок для начинающих.
Крючки
Фильтры
pb_gfhellobonsai_contact_payload
Перед отправкой в Hello Bonsai отфильтруйте текст сообщения — при отправке скорректируйте имя, адрес электронной почты, должность или номер телефона.
Параметры:
$contact_body(множество) – Конфигурированные поля контактной информации (имя, электронная почта, должность, номер телефона).$feed(множество) – Лента Gravity Forms.$entry(множество) – Текущая запись.$form(множество) – Текущая форма.
// Title-case every contact name on its way into Hello Bonsai.
add_filter( 'pb_gfhellobonsai_contact_payload', function( $contact_body, $feed, $entry, $form ) {
if ( isset( $contact_body['name'] ) ) {
$contact_body['name'] = ucwords( strtolower( $contact_body['name'] ) );
}
return $contact_body;
}, 10, 4 );pb_gfhellobonsai_company_payload
Перед созданием компании отфильтруйте ее корпоративный контент — скорректируйте название или домены.
Параметры:
$body(множество) – Поля компании (название, домены).$feed(множество) – Лента Gravity Forms.$entry(множество) – Текущая запись.$form(множество) – Текущая форма.
// Prefix companies created from forms so they're easy to spot in Hello Bonsai.
add_filter( 'pb_gfhellobonsai_company_payload', function( $body, $feed, $entry, $form ) {
$body['name'] = 'Lead: ' . $body['name'];
return $body;
}, 10, 4 );pb_gfhellobonsai_deal_payload
Перед отправкой отфильтруйте текст сделки — программно скорректируйте заголовок, стоимость, этап или исполнителя.
Параметры:
$deal(множество) – Поля сделки (title, company_id, contact_id, board_group_id, assignee_member_id, deal_value).$feed(множество) – Лента Gravity Forms.$entry(множество) – Текущая запись.$form(множество) – Текущая форма.
// Route big-budget leads into a different pipeline stage.
add_filter( 'pb_gfhellobonsai_deal_payload', function( $deal, $feed, $entry, $form ) {
if ( isset( $deal['deal_value'] ) && (float) $deal['deal_value'] >= 10000 ) {
$deal['board_group_id'] = 'your-priority-stage-uuid';
}
return $deal;
}, 10, 4 );pb_gfhellobonsai_free_email_domains
Отфильтруйте список бесплатных почтовых доменов, исключенных из сопоставления компаний на основе электронной почты (по умолчанию это gmail.com, outlook.com, yahoo.com, icloud.com и десятки других).
Параметры:
$free_domains(множество) – Домены в нижнем регистре, которые следует исключить.
// Also treat a local ISP's addresses as personal email.
add_filter( 'pb_gfhellobonsai_free_email_domains', function( $free_domains ) {
$free_domains[] = 'myisp.example';
return $free_domains;
} );pb_gfhellobonsai_record_url
Отфильтруйте URL-адрес приложения Hello Bonsai, используемый в качестве ссылки на синхронизированную запись в поле ввода. Верните пустую строку, чтобы отобразить простой ID без ссылки.
Параметры:
$url(нить) – URL-адрес приложения по умолчанию для данной записи.$type(нить) – Один из контактов, компаний, сделок.$id(инт) – Идентификатор записи Hello Bonsai.
pb_gfhellobonsai_run_time_budget
Настройте временной лимит (в секундах), распределяемый между всеми запросами Hello Bonsai в рамках одного запуска ленты. Обработка лент происходит синхронно во время отправки, поэтому это жесткий предел того, как долго неработающий API может удерживать вашего посетителя. Значение по умолчанию — 40.
Параметры:
$seconds(плавать) – Бюджет в секундах. По умолчанию 40.
// Tighten the budget on high-traffic sites.
add_filter( 'pb_gfhellobonsai_run_time_budget', function( $seconds ) {
return 20.0;
} );pb_gfhellobonsai_runtime_allowed
Обход лицензионного ограничения на обработку фидов. В основном полезно в средах тестирования и разработки.
Параметры:
$allowed(логическое значение) – Разрешена ли в настоящее время лицензия на переработку кормов?.
pb_gfhellobonsai_api_base_url
Переопределите базовый URL-адрес API Hello Bonsai. Это полезно только для разработки и тестирования с использованием фиктивного API — в продакшене это никогда не понадобится.
Параметры:
$url(нить) – Базовый URL API. По умолчаниюhttps://app.hellobonsai.com/public-api/v1.