Към основното съдържание

Създаване на бот

Публикувайте в канал с уебхук, дайте на общността си slash команди и сложете бутони под картите.

Три градивни елемента позволяват на вашата собствена услуга да говори в общността ви. Те работят заедно: една интеграция може да публикува карта, да отговори на /command, да реагира на бутон и да обнови собственото си съобщение.

Градивните елементи

  • Уебхукове: URL адрес, който публикува в канал. Вашата услуга му изпраща JSON и съобщението се появява под името, което сте дали на уебхука. Създадени са за известия: резултати от CI, мониторинг, тикети.
  • Тригери: собствените команди с наклонена черта (slash команди) на общността ви. Член пише /weather, mssgs изпраща съобщението към вашата уеб услуга и отговорът ѝ се появява в канала като карта.
  • Бутони: под карта те отварят линк, променят картата за всички или задействат някой от вашите тригери (вижте Карти и бутони на ботове).

Публикувайте първото си съобщение

1
В настолното приложение отворете Manage Server → Webhooks на общността си и кликнете Add Webhook.
2
Дайте му име, изберете в Channels каналите, в които може да публикува, копирайте Webhook Secret и кликнете Create Webhook.
3
Кликнете иконата за линк до уебхука (View webhook URL), изберете канал в Channel и копирайте URL адреса.
4
Изпратете JSON с POST към този URL, подписан с тайния ключ. Съобщението се появява в канала веднага.
BODY='{"content": "Build #1847 passed on main"}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$MSSGS_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST "$MSSGS_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -H "X-Mssgs-Signature: sha256=$SIG" \
  -d "$BODY"
Пазете URL адреса и тайния ключ в тайна. Заедно те позволяват на всеки да публикува в този канал, затова ги дръжте далеч от публични хранилища и код от страна на клиента. Заявка без валиден подпис се отхвърля.

Публикувате от GitHub? Не е нужен код: насочете уебхук на GitHub към URL адреса и поставете тайния ключ в полето му Secret. Вижте интеграции.

Добавете slash команда

1
Отворете Manage Server → Triggers и кликнете Create Trigger.
2
Попълнете Word to Match, например /weather, и URL Endpoint на вашата уеб услуга. В Allowed User Groups можете да ограничите командата до определени роли.
3
Когато член изпрати съобщение, което започва с /weather, mssgs го изпраща с POST към вашия URL. Отговорете с JSON до 5 секунди и отговорът се появява в канала като карта.

Нужно ви е повече време? Отговорете веднага с карта със зареждане (loader) и я довършете чрез callback_url от заявката, който работи 30 минути. Картата показва името на общността ви, а долният ѝ ред казва кой коя команда е използвал.

Бот като отделен член

Искате ботът да е отделен член, с име, аватар и етикет BOT? Създайте бот акаунт, свързан с вашия акаунт, и го управлявайте от таблото за ботове. Когато настолното приложение е влязло като бота, AI асистент може да публикува карти с бутони чрез неговия MCP сървър.

Всяко поле, отговор и код за грешка са в документацията за разработчици: уебхукове, slash команди, карти на съобщения, бутони и актуализации на живо. А ако искате поведение, задвижвано от AI, без да изграждате нищо, пътят през MCP може да е всичко, от което имате нужда.

Беше ли полезна тази статия?

Не намерихте това, което търсите? С радост ще помогнем.

Задайте въпроса си

Още имате нужда от помощ?

Нашият екип по поддръжката обикновено отговаря до 24 часа.

Свържете се с поддръжката