Створення бота

Публікуйте в канал через вебхук, дайте спільноті власні слеш-команди й додайте кнопки під картками.

Три будівельні блоки дають вашому власному сервісу змогу говорити у спільноті. Вони працюють разом: одна інтеграція може опублікувати картку, відповісти на /команду, відреагувати на кнопку й оновити власне повідомлення.

З чого це складається

  • Вебхуки: URL, який публікує в канал. Ваш сервіс надсилає на нього JSON, і повідомлення з'являється під ім'ям, яке ви дали вебхуку. Створено для сповіщень: результати CI, моніторинг, заявки.
  • Тригери: власні слеш-команди вашої спільноти. Учасник вводить /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. Див. інтеграції.

Додайте слеш-команду

1
Відкрийте Manage Server → Triggers (керування сервером, тригери) і натисніть Create Trigger (створити тригер).
2
Заповніть Word to Match (слово для збігу), наприклад /weather, і URL Endpoint (адреса) вашого вебсервісу. У полі Allowed User Groups (дозволені групи користувачів) можна залишити команду лише певним ролям.
3
Коли учасник надсилає повідомлення, що починається з /weather, mssgs надсилає його POST-запитом на ваш URL. Дайте відповідь у форматі JSON протягом 5 секунд, і вона з'явиться в каналі як картка.

Потрібно більше часу? Одразу відповідайте карткою завантаження й завершіть її через callback_url із запиту, який діє 30 хвилин. На картці видно назву вашої спільноти, а в її нижній частині зазначено, хто яку команду використав.

Окремий бот

Хочете, щоб бот був окремим учасником з іменем, аватаром і міткою BOT? Створіть обліковий запис бота, пов’язаний із вашим власним, і керуйте ним на панелі ботів. Коли настільний застосунок увійшов в обліковий запис бота, ШІ-асистент може публікувати картки з кнопками через його MCP-сервер.

Усі поля, відповіді й коди помилок описано в документації для розробників: вебхуки, слеш-команди, картки повідомлень, кнопки і оновлення наживо. А якщо вам потрібна поведінка на основі ШІ без жодної розробки, можливо, вистачить шляху через MCP.

Чи була ця стаття корисною?

Не знайшли те, що шукали? Ми радо допоможемо.

Поставте запитання
Пов'язані статті
Що таке mssgs MCP? Підключення ШІ (Claude, Cursor та інші) Картки та кнопки ботів Безпека та приватність MCP

Досі потрібна допомога?

Наша служба підтримки зазвичай відповідає протягом 24 годин.

Звернутися до підтримки