Оформете карти на съобщения

Устройство на картата

Частите на картата, отгоре надолу. Пропуснете това, което не ви трябва: карта само със заглавие също е наред.

#github

Message from GitHub• acme/web

Отворен е pull request #212

Open

По-бързо търсене в списъка с канали

Търсенето вече работи при всяко натискане на клавиш, с debounce от 120 ms.

Автор

maya

Рецензенти

dani, sam

10:03

+86-12

1. Горна част„Message from“ и име: името на уебхука или, при отговор на команда, името на вашата общност. Отговорът може да добави badge, например хранилището.
2. Заглавие и статусtitle, който става линк, когато зададете title_url, с етикета status до него.
3. ПодзаглавиеВтори удебелен ред, sub_title.
4. ОписаниеОсновният текст, в markdown.
5. ПолетаРедове с етикет и стойност, с бутон за копиране.
6. Долна частЧасът, както и добавените и премахнатите редове, ако ги изпратите.

{
  "message_container": {
    "type": "embed_message",
    "badge": "acme/web",
    "color": "purple",
    "title": "Pull request #212 opened",
    "title_url": "https://github.com/acme/web/pull/212",
    "status": { "label": "Open", "color": "green", "icon": "pull_request" },
    "sub_title": "Faster search in the channel list",
    "description": "Search now runs **per keystroke** with a 120 ms debounce.",
    "fields": [
      { "field": "Author", "value": "maya" },
      { "field": "Reviewers", "value": "dani, sam" }
    ],
    "additions": 86,
    "deletions": 12,
    "files_changed": 3
  }
}

Всички полета

Те се слагат в message_container. Картата трябва да има описание или индикатор за зареждане. Полетата с означение „Отговори на команди“ отпадат, когато публикувате чрез уебхук.

Статус и статистика на diff

Етикетът за статус разказва историята, преди някой да прочете текста. Стои до заглавието или, ако няма заглавие, в долната част; статистиката на diff се показва до часа. И двете работят в отговори на команди и ги използва вградената интеграция с GitHub. Уебхукът ги премахва.

#github

Message from GitHub• acme/web

Pull request #212 е обединен

Merged

11:20

Message from CI• acme/web

Build на main се провали

Failing

search.test.js: 2 от 212 теста не минаха.

11:24

Message from GitHub• acme/web

maya направи push в main

Commit

11:31

+14-3

{
  "message_container": {
    "color": "red",
    "title": "Build failed on main",
    "status": { "label": "Failing", "color": "red" },
    "description": "`search.test.js`: 2 of 212 tests failed."
  }
}

Икони

Съответствие, което работи за GitHub

Вградената интеграция с GitHub използва тези стойности; копирайте ги за собствените си инструменти.

Зареждане и разсъждения

За всичко, което отнема малко време, като AI отговор или дълга задача, първо публикувайте карта с индикатор за зареждане, а после я заменете с резултата. Индикаторът работи от уебхукове и в отговори на команди. В отговор на команда можете също да сложите разсъжденията на модела в thinking: членовете виждат превключвател Show thinking вместо стена от текст.

#assistant

Message from Assistant

Мисля…Чета последните 50 съобщения

09:02

Първо: индикаторът за зареждане

#assistant

Message from Assistant

maya: кога е standup-ът?

Standup-ът е в 09:30, в #daily.

Show thinking

Проверих закачените съобщения и повтарящото се събитие в #daily.

09:02

После: отговорът, с прибрани разсъждения

{
  "message_container": {
    "type": "embed_message",
    "color": "blue",
    "loader": true,
    "loader_text": "Thinking…",
    "loader_sub_text": "Reading the last 50 messages"
  }
}

{
  "message_container": {
    "type": "embed_message",
    "color": "blue",
    "sub_title": "maya: when is the standup?",
    "description": "Standup is at **09:30**, in #daily.",
    "thinking": "Checked the pinned messages and the recurring event in #daily…"
  }
}

За да смените индикатора с отговора, обновете съобщението с нова карта без loader. Как става това, вижте в обновления на живо.

Дълги описания

Описанието може да е до 50 000 байта. След първите 1000 членовете виждат началото и бутон Show more, който зарежда останалото, така че дълъг отчет не залива канала.

Системни съобщения

Задайте "type": "system_message" за известие вместо публикация от бот: планирана поддръжка, промени в правилата, всичко, което говори от името на самата общност. Приема същите полета и бутони.

{
  "message_container": {
    "type": "system_message",
    "color": "orange",
    "title": "Maintenance tonight",
    "description": "The build servers are down from 22:00 to 23:00."
  }
}

Цветове

Цветът на ръба е най-бързият сигнал в картата. Използвайте всеки път един и същ цвят за един и същ вид новини.