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

Карти и бутони на ботове

Карти с цвят, полета, изображения и статус, плюс бутони, които променят картата за всички.

Това, което публикува уебхук, slash команда или бот акаунт, не е задължително да е обикновен текст. Може да е карта, структурирано съобщение, което схващате с един поглед, с бутони отдолу.

Карти

Една карта може да има:

  • цветен ръб: син (по подразбиране), зелен, червен, оранжев, жълт или лилав
  • заглавие (по желание като линк), подзаглавие и описание в markdown
  • полета: редове с етикет и стойност, които членовете копират с едно докосване
  • изображения: едно изображение или галерия
  • loader: въртящ се индикатор с ваш собствен текст, например „Мисля…“, който заменяте с резултата, когато е готов

Отговорът на slash команда може да показва повече: статус етикет като Open, Merged или Passing, значка в заглавката, добавени и премахнати редове и разсъждения, скрити зад превключвател. Карта, публикувана чрез уебхук, ги пропуска, а заглавката ѝ винаги показва собственото име на уебхука.

Мислете за pull request-и, внедрявания и тикети за поддръжка: ясни от пръв поглед вместо стена от текст.

Бутони

Бутоните стоят под картата. Техният type определя какво прави натискането:

  • url:{url} отваря линк.
  • webhook_action изпълнява стъпките, които сте запазили с бутона: обновява картата, премахва я, добавя реакция или публикува отговор. Те се изпълняват на сървъра на mssgs и всички в канала виждат резултата, така че за „Одобри“ или „Отвори портата“ не ви трябва собствен сървър.
  • trigger:{guid} задейства някой от тригерите на общността ви с данните на бутона, все едно някой е написал командата. Отговорът пристига като нова карта.

Обратна връзка

Публикация от уебхук с бутони получава в отговор stream_url, а всяка заявка от slash команда носи такъв: поток на живо с натисканията, реакциите и отговорите под това съобщение. Той остава отворен 10 минути (за публикации от уебхук при поискване един час) и не пази нищо за по-късно, затова се свържете веднага. За да промените съобщението след това, използвайте неговия callback_url, който работи 30 минути. Бот акаунтът научава за картите си вместо това чрез MCP сървъра.

Изграждали сте по старата документация? Бутони от тип button със стъпки ws:send, local:update_message, local:remove_message, условия като previous:success и expire_in_seconds вече не работят за външни податели. Използвайте webhook_action със стъпките по-горе: те достигат до всички, не само до човека, който е натиснал.

Всяко поле на картата, заедно с конструктор на карти на живо, е на страницата карти на съобщения. Стъпките на бутоните, събитията и грешките са на бутони, а потокът и callback URL адресът на актуализации на живо.

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

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

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

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

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

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