Respond.io использует пользовательские параметры Dialogflow для расширения функционала приложения в соответствии с несколькими сценариями.
В Dialogflow параметры обычно используются для связывания слов и фраз в ответе пользователя с сущностями. Если кто-то скажет "Мой день рождения 13 марта," то фраза "13 марта" будет автоматически распознана и обработана как дата. Подробнее о параметрах можно прочитать в документации Dialogflow.
С помощью платформы respond.io вы можете использовать параметры для охвата большего количества случаев. Вы можете использовать их для сохранения и сбора информации, предоставленной вашими контактами, например, присваивая динамические теги и устанавливая пользовательские поля. Вы даже можете уведомить представителей поддержки, когда контакту требуется помощь. Вы также можете использовать платформу respond.io для хранения и легкого управления вашими ответами на намерения.
Существует множество возможностей для достижения результатов, когда вы используете платформу respond.io совместно с параметрами намерений Dialogflow.
Список параметров, которые вы можете использовать в Dialogflow для взаимодействия с платформой respond.io.
Название параметра | Значение | Описание |
---|---|---|
RB_АДДТЕГИ | тег1, [тег2, ...] | Добавляет указанные тег(и) к профилю Контакта на платформе respond.io. |
RB_УДАЛИТЕГИ | тег1, [тег2, ...] | Удаляет указанные тег(и) из профиля Контакта на платформе respond.io. |
RB_СТАТУСБОТА | ложь | Отключает бота для определенного контакта. Это полезно в случаях, когда вы хотите передать разговор от бота к человеку. |
RB_МАРКИРОВАТЬЗАВЕРШЕННЫМ | true/false | Открывает или закрывает разговор для Контакта. Это полезно для поддержки. Открывает разговор для контактов, которые еще что-то ожидают, в то время как закрытие разговора символизирует контакты, к которым уже обращались. |
RB_УВЕДОМЛЕНИЕ | уведомление_сообщение | Отправляет уведомление людям на платформе respond.io вместе с сообщением об уведомлении. |
Подписаться. | true/false | Подписывает или отказывает подписку для Контакта. Не подписавшиеся контакты не будут получать сообщения рассылки. |
RB_ПОЛЕ_ИМЯПЕРВОЕ | значение | Заполняет поле Имя контактного профиля с указанным значением |
Поле Фамилия | значение | Заполняет поле Фамилия контактного профиля с указанным значением |
Полное имя | значение | Заполняет поле Полное Имя Контактного профиля с указанным значением |
Электронная почта | значение | Заполняет поле "Адрес электронной почты" профиля контакта с указанным значением |
Номер телефона | значение | Заполняет поле номер телефона контактного профиля с указанным значением |
Язык | значение | Заполняет поле Язык контактного профиля заданным значением, например, en-us |
RB_FIELD_[ИМЯ] | значение | Добавляет настраиваемое поле в Контакт'с профиль с указанным значением. Это лучше всего подходит для нединамической информации, такой как электронная почта, день рождения и т.д. |
УДАЛИТЬ | field1, [field2, ...] | Удаляет указанное настраиваемое поле из контактов на платформе |
RB_USER_ASSIGN | значение | Назначает контакта одному пользователю в вашей команде |
RB_SNIPPET | сниппет_id | Отправляет указанный сниппет контакту |
RB_FILE | идентификатор файла | Отправляет указанный файл на платформе контакту |
Информация контактов может храниться в виде тегов. Теги могут быть добавлены или удалены вручную в Модуле контактов или Модуле входящей почты, программно добавлены или удалены с помощью Рабочих процессов, а также добавлены или удалены с использованием параметров в намерениях Dialogflow.
Важно: Теги используются для сегментации аудитории в трансляциях. Учтите это, когда добавляете или удаляете теги, используя намерения Dialogflow.
С помощью параметра RB_ADDTAGS
можно назначить контакту тег. Теги будут добавлены в контакт на основе значения параметра. У вас есть возможность добавить несколько тегов, разделив их запятыми.
Обратите внимание, что имена тегов не могут содержать пробелы. Вы можете вместо этого использовать знак подчеркивания.
С помощью параметра RB_REMOVETAGS
можно удалить тег из контакта. Теги будут добавлены в контакт на основе значения параметра. У вас есть возможность удалить несколько тегов, разделив их запятыми.
При создании новых тегов хорошая идея определить короткие, но значимые имена, легко идентифицируемые. В идеале, вы хотите, чтобы другие люди могли понимать теги, связанные с пользователем.
С помощью слота наполнения с помощью сущностей у вас есть возможность динамически создавать новые теги. Тем не менее, это не рекомендуется, так как это может быстро привести к загрязнению тегов.
Чтобы уменьшить загрязнение тегами, старайтесь не использовать слишком специфические или слишком щедрые теги, чтобы минимизировать их количество.
При использовании тегов, чтобы отслеживать интерес пользователя к теме, вы можете использовать один и тот же тег в нескольких намерениях, имеющих одну и ту же тему. Это может определить, что пользователь имеет конкретный интерес или беспокойство при уменьшении тега загрязнения.
Dialogflow Bot можно включать/выключать вручную из модуля «Входящие» и автоматически с помощью рабочих процессов . В дополнение к этому, бот также может быть отключен с помощью параметров в намерениях Dialogflow.
Использование намерения Dialogflow для отключения статуса бота контакта может быть использовано для создания передачи полномочий человеку в рабочем процессе бота.
Когда бот отключен для контакта, сообщения не передаются в Диалог-поток. Контакты с отключенным ботом будут отображаться на платформе в разделе Не назначенные в панели управления.
С помощью RB_BOTSTATUS
вы можете отключить бота для конкретного пользователя, установив значение false
.
Резервное намерение не включает место для добавления параметров. При отключении бота в Dialogflow вы должны создать быстрый ответ в вашем намерении Fallback, спрашивая Контакт, хочет ли он поговорить с человеком. Если контакт отвечает быстрым ответом да , это должно привести его к намерению с параметром RB_BOTSTATUS
.
При использовании этого параметра для отключения бота, вы также можете обновить статус пользователя на платформе с помощью RB_MARKDONE
и отправить уведомление на платформу с параметром RB_NOTIFY
в рамках одного намерения.
Назначение и закрытие системы разговоров открывают новое обсуждение для всех новых контактов и всех контактов с новыми сообщениями. Это гарантирует, что все контакты, которым требуется помощь, будут отображаться в неназначенном списке .
По умолчанию платформа откроет новую беседу для всех новых контактов и контактов, которые посылают новое сообщение.
Разговор можно открыть или закрыть для контакта вручную в модуле контактов или модуле входящих сообщений; открыть или закрыть программно с помощью рабочих процессов и закрыть, используя параметры в намерениях Dialogflow.
Чтобы закрыть беседу контакта из Dialogflow, используйте параметр RB_MARKDONE
в намерениях Dialogflow.
Чтобы закрыть разговор контакта, используйте параметр RB_MARKDONE
в намерении вашего Диалога и установите значение true
.
Любой контакт, который вызывает намерение с помощью параметра RB_MARKDONE
со значением true
, будет иметь свой разговор закрытым на платформе respond.io.
По умолчанию, все новые контакты и контакты с новыми сообщениями откроют новую беседу. Вы хотите добавить RB_MARKDONE
как true
для намерений, которые не требуют присутствия человека при срабатывании.
Вы можете захотеть задуматься об использовании этого намерения в сочетании с RB_NOTIFY
для вызова уведомления, когда разговор открыт для контакта. Сообщение уведомления может использоваться для передачи информации о том, что нужно сделать для конкретного контакта.
Чтобы назначить контакт пользователю из Dialogflow, используйте параметр RB_USER_ASSIGN
в намерениях Dialogflow.
Для назначения контакта пользователю, используйте параметр RB_USER_ASSIGN
в своем намерении Диалога и установите значение в качестве электронной почты пользователя, которого вы хотите назначить.
Любой контакт, который вызывает намерение с помощью параметра RB_USER_ASSIGN
с действительным электронным адресом пользователя в Значение, назначается этому Пользователю в ответе. платформа.
По умолчанию Система уведомлений будет отправлять уведомления пользователям платформы, когда контакт посылает новое сообщение. Дополнительные уведомления можно создать и отправить пользователям платформы с помощью параметров в намерениях Dialogflow.
Чтобы отправить уведомление пользователям платформы, используйте параметр RB_NOTIFY
в намерениях Dialogflow.
На платформу можно отправить уведомление, используя в качестве имени параметра RB_NOTIFY
. Значение параметра будет отправлено в виде уведомления.
Совет: Вы можете использовать динамическую переменную в значении параметра, набрав $dynamic.variable.
Используйте динамическую переменную $contact.name, чтобы уведомить пользователя платформы, какой контакт требует внимания.
Используйте RB_NOTIFY
вместе с RB_BOTSTATUS
и RB_MARKDONE
для обеспечения того, чтобы Контакт привлек к себе внимание, которое ему нужно.
Совет: Узнайте больше о том, как работают уведомления на платформе, здесь.
Периодически вы будете получать текстовое сообщение от контакта с текстом "STOP". Это, вероятно, связано с тем, что они больше не хотят получать трансляции. Установка RB_SUBSCRIBE
в значение false
в Dialogflow отключит подписку контактов на все будущие трансляции.
Ответы на бот и личные сообщения не будут затронуты.
С помощью RB_SUBSCRIBE
, вы можете подписаться или отписаться от контакта боту, установив значение true
или false
соответственно. Контакты, отменившие подписку, будут исключены из будущих трансляций платформы.
Если вы используете параметр RB_SUBSCRIBE
для управления разрешениями рассылки, необходимо создать настраиваемое поле в respond.io для отображения статуса подписки контакта. Это можно сделать, используя параметр RB_FIELD_[NAME]
вместе с параметром RB_SUBSCRIBE
.
Информация контактов может храниться в виде значений в Полях Контактов.
В дополнение к полям по умолчанию, пользовательские поля могут быть добавлены & удалены в модуле настроек. Новые настраиваемые поля также могут быть созданы в Dialogflow.
Если вы используете параметр поля в Диалоге и соответствующее настраиваемое поле не существует в платформе, будет создано новое настраиваемое поле.
Значения полей контакта могут быть изменены вручную в модуле Контактов или входящего модуля, программно изменены с помощью автоматизированных работ, или изменены с использованием параметров в целях Dialogflow.
Вы можете редактировать значение пользовательского поля контакта с помощью RB_FIELD_[FIELD_ID]
, где «[FIELD_ID]» заменяется идентификатором пользовательского поля. ID настраиваемого поля генерируется как имя настраиваемого поля в SNAKE_CASING. Значение настраиваемого поля будет установлено в качестве значения в параметре. Например, если вы собираете группы крови контактов, и у контакта группа крови AB положительная, вы должны отправить параметр RB_FIELD_BLOODTYPE
со значением AB+.
Совет: Вы можете использовать значения пользовательских полей в качестве динамических переменных.
Поля по умолчанию
То же самое можно сделать для любого из полей Контакта по умолчанию. Например, параметр RB_FIELD_PHONE
может быть использован для обновления значения номера телефона контакта.
По умолчанию, контакты на respond.io имеют следующие поля контакта:
Имя поля | ID | Описание |
---|---|---|
Имя | Имя | Имя контакта |
Фамилия | Фамилия | Фамилия контакта |
Полное имя | FULLNAME | Полное имя контакта, т.е., Имя + Фамилия |
Email Address | Адрес электронной почты контакта | |
Номер телефона | Телефон | Номер телефона контакта |
Язык | Язык | Язык контакта |
Эти поля по умолчанию заполняются автоматически, используя доступную информацию, предоставленную каналом при первом создании Контакта.
Чтобы очистить значение поля контакта, вы можете использовать параметр RB_REMOVEFIELDS
. Значением будут имена полей, которые вы хотите удалить. Вы можете очистить несколько полей одновременно, разделив их запятыми.
Система шаблонов ответов используется для хранения содержания распространенных ответов на платформе respond.io.
Шаблоны ответов можно отправлять вручную в модуле «Входящие», чтобы сократить объем ввода текста, или отправлять с использованием параметров в намерениях Dialogflow.
Отправляя шаблоны ответов в вашем Агенте Диалога, вы можете хранить содержимое ваших ответов на платформе respond.io, где их можно легко управлять и редактировать.
Множество намерений также могут использовать один и тот же сниппет. В этом случае при редактировании шаблона ответа будет обновляться содержимое ответа во всех намерениях.
Чтобы отправить шаблон ответа с помощью намерений Dialogflow, используйте параметр RB_SNIPPET
. Триггерное намерение будет отвечать содержимым шаблона ответа.
С помощью RB_SNIPPET
вы можете отправить шаблон ответа в качестве ответа. Установите значение параметра на ID шаблона ответа, который вы хотите отправить.
Обновление или изменение имени или содержимого сниппета сохранит существующий идентификатор сниппета.
Файлы можно отправлять вручную в модуле «Входящие» или отправлять с использованием параметров в намерениях Dialogflow.
Используя параметр RB_FILE
, вы можете отправлять файлы, хранящиеся в Файловом менеджере, контактам, которые активируют намерение Dialogflow.
Прежде чем отправить файл, вы должны загрузить файл (файлы) на respond.io диспетчер файлов. Затем используйте параметр RB_FILE
с идентификатором файла в качестве значения для отправки файла контакту.
Только файлы, загруженные в пространство, подключенное к Dialogflow, будут отправлены. Файлы, загруженные в другие пространства, не будут отправлены контакту.
Соответствующие статьи 👩💻