Создание ботов — Документация — Мета для разработчиков
Создание ботов для Workplace в группах и чате
Боты в группах | |
Боты в чате |
Обзор
С помощью пользовательских интеграций для Workplace теперь можно создавать мощных ботов, которые могут взаимодействовать с людьми в группах и общаться в чате.
Вы можете создать бота, который автоматически публикует контент в группы, отвечает на вопросы с дополнительной информацией или выполняет действия, когда упоминается в комментариях к сообщению. Вы также можете создавать ботов, которые могут общаться с людьми в Work Chat, предоставлять информацию в режиме реального времени или обрабатывать запросы со структурированными элементами беседы, такими как быстрые ответы и постоянные меню.
Чтобы создать бота для своего сообщества, вам потребуется роль системного администратора.
Если вы не являетесь администратором своего сообщества Workplace, вам потребуется помощь администратора для создания бота.
Боты в виде страниц
В Workplace, аналогично платформе Messenger, боты представлены в виде страниц. Страница создается автоматически при создании пользовательского приложения интеграции. Люди в вашем сообществе Workplace могут находить вашего бота и взаимодействовать с ним через эту страницу
Страницы бота являются общедоступными для компании, поэтому любой член сообщества Workplace может видеть бота, отмечать его и отправлять ему сообщения. Однако в зависимости от уровня разрешений, который вы выбрали при создании своего бота, он может не иметь возможности просматривать и взаимодействовать со всем содержимым на рабочем месте.
Например, если ваш бот имеет разрешение Чтение содержимого группы , он сможет просматривать содержимое в группах. И если у вашего бота нет разрешения Публиковать в группы , он не сможет отвечать на контент ни в одной группе.
Кроме того, люди смогут найти вашего бота и отправить ему сообщение в Work Chat, только если у него есть разрешение Сообщить любому участнику .
Боты в группах
В группах боты могут делать многое из того, что могут делать люди. Это означает, что вы можете создавать ботов, которые публикуют новый контент, комментируют контент с новой информацией и лайкают публикации, чтобы показать подтверждение или одобрение.
Боты также могут @упоминать людей, чтобы привлечь их внимание, и быть @упомянутыми, чтобы запустить определенный рабочий процесс или задать вопрос.
Наконец, боты могут подписываться на группы и веб-перехватчики @mention, которые предоставляют возможность отслеживать контент и гибко взаимодействовать с пользователями.
Боты в чате
В то время как в группах боты могут асинхронно потреблять и обмениваться информацией между группой людей, боты в чате лучше всего подходят для прямого взаимодействия в реальном времени с одним человеком или определенной группой людей.
Например, чат-бот можно использовать для отправки важных напоминаний или уведомлений кому-либо в связи с предстоящим событием, таким как собеседование или встреча. Рабочие чат-боты также можно использовать для взаимодействия с пользователем в беседе и выполнения последующих действий на основе полученных отзывов.
Эта модель взаимодействия основана на тех же концепциях, что и платформа Messenger. В результате боты рабочего чата могут использовать такие функции, как постоянное меню, быстрые ответы и шаблоны, чтобы улучшить взаимодействие с пользователем.
Бот может отвечать только в ветке чата, участником которой является бот (чат 1-1 или групповые чаты). Кроме того, бот должен иметь разрешение Message Any Member .
Чат между ботами и пользователями
Когда бот имеет разрешение Message Any Member , ему будет разрешено отправлять прямое сообщение любому человеку на Workplace через его адрес электронной почты или идентификатор Workplace через API отправки Messenger.
Бот в новом вводе сообщения
Разрешение Message Any Member также позволяет вашему боту отображаться в вводе текста на поверхностях чата Workplace.
Бот в новом типе сообщения
Подписавшись на веб-перехватчики Page Message, ваш бот также будет получать уведомления, когда пользователь отправляет вашему боту сообщения, и вы можете построить поток беседы, комбинируя отправку и получение.
Разговор между ботами и пользователями
Групповой чат между ботами
Боты также могут создавать, управлять и добавляться в потоки группового чата с несколькими людьми. Боты могут создавать новые групповые темы, указывая список получателей, и могут переименовывать темы, чтобы создавать обсуждения в чате на определенные темы с определенными людьми.
Именованный тред с конкретными людьми, созданный ботом.
Включение ботов для групповых чатов
Чтобы разрешить боту создавать групповые чаты с пользователями Workplace, откройте панель «Разрешения» диалогового окна «Редактировать пользовательскую интеграцию» и установите флажок Разрешить этой интеграции работать в групповых чатах .
Включение пользовательского интеграционного бота для поддержки группового чата.
Включив поддержку группового чата, ваш бот появится в списке Добавить людей вводных слов в существующей ветке группового чата. Затем он будет получать веб-перехватчики для каждого сообщения, отправленного людьми в этом потоке, и может отвечать на этот поток, используя свой идентификатор потока .
Добавление бота в групповой чат, а затем @-упоминание бота
Создание новых именованных потоков
Чтобы создать новый поток с определенными получателями, выполните запрос POST к конечной точке /me/messages , указав массив из идентификаторов получателей и начального сообщение полезная нагрузка следующим образом:
POST /me/messages
{
"получатель": {
"id": []
},
"сообщение":
} Вы получите ответную полезную нагрузку, содержащую идентификатор потока , который можно использовать для последующих сообщений.
Если вы снова используете ту же конечную точку с тем же списком получателей, будет создан новый поток. Чтобы отправить последующие сообщения в уже созданный поток, выполните запрос получателя следующим образом:
POST /me/messages
{
"получатель": {
"thread_key":
},
"сообщение":
} Чтобы переименовать поток, созданный вашим ботом, отправьте запрос POST к краю /{thread}/threadname следующим образом:
POST /t_/threadname { "имя": "новое имя" }
Обратите внимание на необходимость префикса thread_id с » t_ » в пограничном пути.
Вы также можете получить список участников потока, выполнив запросы GET на границе /{thread}/?fields=participants следующим образом:
GET /t_/?fields=participants
Вы также можете добавлять и удалять участников из потоков, отправляя запросы POST или DELETE на границе /{thread}/participants следующим образом:
POST t_/ участники { "кому": [ ] } УДАЛИТЬ t_ /участники { "кому": [ ] }
Партнеры по платформе ботов
Workplace имеет ряд партнеров по платформе ботов, которые обеспечили поддержку ботов в Workplace.
Вы можете увидеть их список здесь. Вы можете использовать одну из этих платформ для создания мощного бота, не написав ни одной строки кода.
Передовой опыт
Используйте правильный канал
При принятии решения о создании группового или чатового взаимодействия для вашего бота стоит подумать, где ваш бот будет наиболее полезен.
- Если вы создаете бота, с которым одновременно могут взаимодействовать несколько человек, или бота, который публикует контент для просмотра несколькими людьми, имеет смысл создать бота, который публикует сообщения в группах и отвечает на комментарии и упоминания в сообщениях. в группах.
- Если вы создаете бота, который должен предупредить кого-то о чем-то немедленном, о чем-то, что может потребовать быстрого реагирования, или о чем-то, с чем люди должны взаимодействовать наедине, вы должны поддерживать беседы в Work Chat для своего бота.
Одно приложение может обрабатывать оба канала. Могут быть случаи, когда, например, ваш бот службы поддержки принимает сообщения в рабочем чате, а иногда ему необходимо публиковать сообщения в группах и получать ответы.
Групповые взаимодействия
После того, как ваше приложение будет подписано на веб-перехватчики, ваш бот получит уведомление, когда оно будет упомянуто в групповом сообщении или комментарии. Для вашего бота важно своевременно реагировать на упоминания. Если ваш бот должен обработать запрос, прежде чем ответить, полезно поставить лайк комментарию, чтобы указать человеку, что бот знает, что он был упомянут.
Затем, если вы предоставляете информацию после того, как вас упомянули в комментарии, добавьте ветку ответа, чтобы продолжить групповой разговор.
Если вашему боту необходимо предоставить информацию исходному автору, добавьте комментарий к самому посту, чтобы он тоже получил уведомление.
Взаимодействия в чате
Взаимодействия ботов в Work Chat поддерживают функции, аналогичные платформе Messenger. Это включает в себя кнопки быстрого ответа и шаблоны, которые помогут вам реализовать деревья решений в беседах с ботами.
Это значительно упрощает создание полезных рабочих процессов и сокращает объем ввода, который необходимо выполнять людям, без необходимости сложной обработки естественного языка, что значительно упрощает интернационализацию, если вы создаете ботов для глобальной рабочей силы.
Создание ботов — Документация — Мета для разработчиков
Создание ботов для Workplace в группах и чате
Боты в группах | |
Боты в чате |
Обзор
С помощью пользовательских интеграций для Workplace теперь можно создавать мощных ботов, которые могут взаимодействовать с людьми в группах и общаться в чате.
Вы можете создать бота, который автоматически публикует контент в группы, отвечает на вопросы с дополнительной информацией или выполняет действия, когда упоминается в комментариях к сообщению. Вы также можете создавать ботов, которые могут общаться с людьми в Work Chat, предоставлять информацию в режиме реального времени или обрабатывать запросы со структурированными элементами беседы, такими как быстрые ответы и постоянные меню.
Чтобы создать бота для своего сообщества, вам потребуется роль системного администратора.
Если вы не являетесь администратором своего сообщества Workplace, вам потребуется помощь администратора для создания бота.
Боты в виде страниц
В Workplace, аналогично платформе Messenger, боты представлены в виде страниц. Страница создается автоматически при создании пользовательского приложения интеграции. Люди в вашем сообществе Workplace могут находить вашего бота и взаимодействовать с ним через эту страницу
Страницы бота являются общедоступными для компании, поэтому любой член сообщества Workplace может видеть бота, отмечать его и отправлять ему сообщения. Однако в зависимости от уровня разрешений, который вы выбрали при создании своего бота, он может не иметь возможности просматривать и взаимодействовать со всем содержимым на рабочем месте.
Например, если ваш бот имеет разрешение Чтение содержимого группы , он сможет просматривать содержимое в группах. И если у вашего бота нет разрешения Публиковать в группы , он не сможет отвечать на контент ни в одной группе.
Кроме того, люди смогут найти вашего бота и отправить ему сообщение в Work Chat, только если у него есть разрешение Сообщить любому участнику .
Боты в группах
В группах боты могут делать многое из того, что могут делать люди. Это означает, что вы можете создавать ботов, которые публикуют новый контент, комментируют контент с новой информацией и лайкают публикации, чтобы показать подтверждение или одобрение.
Боты также могут @упоминать людей, чтобы привлечь их внимание, и быть @упомянутыми, чтобы запустить определенный рабочий процесс или задать вопрос.
Наконец, боты могут подписываться на группы и веб-перехватчики @mention, которые предоставляют возможность отслеживать контент и гибко взаимодействовать с пользователями.
Боты в чате
В то время как в группах боты могут асинхронно потреблять и обмениваться информацией между группой людей, боты в чате лучше всего подходят для прямого взаимодействия в реальном времени с одним человеком или определенной группой людей.
Например, чат-бот можно использовать для отправки важных напоминаний или уведомлений кому-либо в связи с предстоящим событием, таким как собеседование или встреча. Рабочие чат-боты также можно использовать для взаимодействия с пользователем в беседе и выполнения последующих действий на основе полученных отзывов.
Эта модель взаимодействия основана на тех же концепциях, что и платформа Messenger. В результате боты рабочего чата могут использовать такие функции, как постоянное меню, быстрые ответы и шаблоны, чтобы улучшить взаимодействие с пользователем.
Бот может отвечать только в ветке чата, участником которой является бот (чат 1-1 или групповые чаты). Кроме того, бот должен иметь разрешение Message Any Member .
Чат между ботами и пользователями
Когда бот имеет разрешение Message Any Member , ему будет разрешено отправлять прямое сообщение любому человеку на Workplace через его адрес электронной почты или идентификатор Workplace через API отправки Messenger.
Бот в новом вводе сообщения
Разрешение Message Any Member также позволяет вашему боту отображаться в вводе текста на поверхностях чата Workplace.
Бот в новом типе сообщения
Подписавшись на веб-перехватчики Page Message, ваш бот также будет получать уведомления, когда пользователь отправляет вашему боту сообщения, и вы можете построить поток беседы, комбинируя отправку и получение.
Разговор между ботами и пользователями
Групповой чат между ботами
Боты также могут создавать, управлять и добавляться в потоки группового чата с несколькими людьми. Боты могут создавать новые групповые темы, указывая список получателей, и могут переименовывать темы, чтобы создавать обсуждения в чате на определенные темы с определенными людьми.
Именованный тред с конкретными людьми, созданный ботом.
Включение ботов для групповых чатов
Чтобы разрешить боту создавать групповые чаты с пользователями Workplace, откройте панель «Разрешения» диалогового окна «Редактировать пользовательскую интеграцию» и установите флажок Разрешить этой интеграции работать в групповых чатах .
Включение пользовательского интеграционного бота для поддержки группового чата.
Включив поддержку группового чата, ваш бот появится в списке Добавить людей вводных слов в существующей ветке группового чата. Затем он будет получать веб-перехватчики для каждого сообщения, отправленного людьми в этом потоке, и может отвечать на этот поток, используя свой идентификатор потока .
Добавление бота в групповой чат, а затем @-упоминание бота
Создание новых именованных потоков
Чтобы создать новый поток с определенными получателями, выполните запрос POST к конечной точке /me/messages , указав массив из идентификаторов получателей и начального сообщение полезная нагрузка следующим образом:
POST /me/messages
{
"получатель": {
"id": [ ]
},
"сообщение":
} Вы получите ответную полезную нагрузку, содержащую идентификатор потока , который можно использовать для последующих сообщений.
Если вы снова используете ту же конечную точку с тем же списком получателей, будет создан новый поток. Чтобы отправить последующие сообщения в уже созданный поток, выполните запрос POST к конечной точке /me/messages, используя ключ 9.0109 thread_id в полезной нагрузке получателя следующим образом:
POST /me/messages
{
"получатель": {
"thread_key":
},
"сообщение":
} Чтобы переименовать поток, созданный вашим ботом, отправьте запрос POST к краю /{thread}/threadname следующим образом:
POST /t_/threadname { "имя": "новое имя" }
thread_id с » t_ » в пограничном пути. Вы также можете получить список участников потока, выполнив запросы GET на границе /{thread}/?fields=participants следующим образом:
GET /t_/?fields=participants
Вы также можете добавлять и удалять участников из потоков, отправляя запросы POST или DELETE на границе /{thread}/participants следующим образом:
POST t_/ участники { "кому": [ ] } УДАЛИТЬ t_ /участники { "кому": [ ] }
Партнеры по платформе ботов
Workplace имеет ряд партнеров по платформе ботов, которые обеспечили поддержку ботов в Workplace.
Вы можете увидеть их список здесь. Вы можете использовать одну из этих платформ для создания мощного бота, не написав ни одной строки кода.
Передовой опыт
Используйте правильный канал
При принятии решения о создании группового или чатового взаимодействия для вашего бота стоит подумать, где ваш бот будет наиболее полезен.
- Если вы создаете бота, с которым одновременно могут взаимодействовать несколько человек, или бота, который публикует контент для просмотра несколькими людьми, имеет смысл создать бота, который публикует сообщения в группах и отвечает на комментарии и упоминания в сообщениях. в группах.
- Если вы создаете бота, который должен предупредить кого-то о чем-то немедленном, о чем-то, что может потребовать быстрого реагирования, или о чем-то, с чем люди должны взаимодействовать наедине, вы должны поддерживать беседы в Work Chat для своего бота.
Одно приложение может обрабатывать оба канала. Могут быть случаи, когда, например, ваш бот службы поддержки принимает сообщения в рабочем чате, а иногда ему необходимо публиковать сообщения в группах и получать ответы.
Групповые взаимодействия
После того, как ваше приложение будет подписано на веб-перехватчики, ваш бот получит уведомление, когда оно будет упомянуто в групповом сообщении или комментарии. Для вашего бота важно своевременно реагировать на упоминания. Если ваш бот должен обработать запрос, прежде чем ответить, полезно поставить лайк комментарию, чтобы указать человеку, что бот знает, что он был упомянут.
Затем, если вы предоставляете информацию после того, как вас упомянули в комментарии, добавьте ветку ответа, чтобы продолжить групповой разговор.
Если вашему боту необходимо предоставить информацию исходному автору, добавьте комментарий к самому посту, чтобы он тоже получил уведомление.
Взаимодействия в чате
Взаимодействия ботов в Work Chat поддерживают функции, аналогичные платформе Messenger. Это включает в себя кнопки быстрого ответа и шаблоны, которые помогут вам реализовать деревья решений в беседах с ботами.
Это значительно упрощает создание полезных рабочих процессов и сокращает объем ввода, который необходимо выполнять людям, без необходимости сложной обработки естественного языка, что значительно упрощает интернационализацию, если вы создаете ботов для глобальной рабочей силы.
