Новый
🔥 Станьте первым, кто попробует WhatsApp Business Calling API (открытую бета-версию)!
arrow-icon
All Collections >
Интеграции >
Диалог >
Диалогфлоу: Параметры

Диалогфлоу: Параметры

Avatar
Susan Swier
· 04 Apr 2025
менее минуты чтения

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

EMAIL

Адрес электронной почты контакта

Номер телефона

Телефон

Номер телефона контакта

Язык

Язык

Язык контакта

Эти поля по умолчанию заполняются автоматически, используя доступную информацию, предоставленную каналом при первом создании Контакта.

Очистка полей

Чтобы очистить значение поля контакта, вы можете использовать параметр RB_REMOVEFIELDS. Значением будут имена полей, которые вы хотите удалить. Вы можете очистить несколько полей одновременно, разделив их запятыми.

Сниппеты

Система шаблонов ответов используется для хранения содержания распространенных ответов на платформе respond.io.

Шаблоны ответов можно отправлять вручную в модуле «Входящие», чтобы сократить объем ввода текста, или отправлять с использованием параметров в намерениях Dialogflow.

Отправляя шаблоны ответов в вашем Агенте Диалога, вы можете хранить содержимое ваших ответов на платформе respond.io, где их можно легко управлять и редактировать.

Множество намерений также могут использовать один и тот же сниппет. В этом случае при редактировании шаблона ответа будет обновляться содержимое ответа во всех намерениях.

Чтобы отправить шаблон ответа с помощью намерений Dialogflow, используйте параметр RB_SNIPPET. Триггерное намерение будет отвечать содержимым шаблона ответа.

Использование параметра сниппет

С помощью RB_SNIPPET вы можете отправить шаблон ответа в качестве ответа. Установите значение параметра на ID шаблона ответа, который вы хотите отправить.

Обновление или изменение имени или содержимого сниппета сохранит существующий идентификатор сниппета.

Отправка файлов

Файлы можно отправлять вручную в модуле «Входящие» или отправлять с использованием параметров в намерениях Dialogflow.

Используя параметр RB_FILE, вы можете отправлять файлы, хранящиеся в Файловом менеджере, контактам, которые активируют намерение Dialogflow.

Использование параметра файла

Прежде чем отправить файл, вы должны загрузить файл (файлы) на respond.io диспетчер файлов. Затем используйте параметр RB_FILE с идентификатором файла в качестве значения для отправки файла контакту.

Только файлы, загруженные в пространство, подключенное к Dialogflow, будут отправлены. Файлы, загруженные в другие пространства, не будут отправлены контакту.

Поделиться этой статьей
Telegram
Facebook
Linkedin
Twitter

Соответствующие статьи 👩‍💻

Dialogflow: Выполнение запроса Webhook
Узнайте, как использовать запросы вебхука для выполнения, чтобы передавать данные от respond.io в Dialogflow.
Dialogflow: Пользовательские полезные нагрузки
Узнайте о поддерживаемых пользовательских полезных нагрузках на respond.io.
Dialogflow: Шаблоны ответов
Узнайте, как использовать шаблоны ответов для отправки ответов контактам.
Диалогпоток: События
Узнайте, как использовать события для срабатывания намерений диалога.
Dialogflow: Управление намерениями
Персонализируйте ответы бота через настройку намерений.

Не удается найти то, что вы ищете? 🔎