Tervezz üzenetkártyákat

Egy kártya felépítése

A kártya részei fentről lefelé. Hagyd el, amire nincs szükséged: egy csak címből álló kártya is rendben van.

#github

Message from GitHub• acme/web

Pull request #212 megnyitva

Open

Gyorsabb keresés a csatornalistában

A keresés mostantól minden billentyűleütésnél lefut, 120 ms-os debounce-szal.

Szerző

maya

Bírálók

dani, sam

10:03

+86-12

1. Fejléc„Message from” és egy név: a webhook neve, vagy parancsra adott válasznál a közösséged neve. A válasz egy badge jelvényt is kaphat, például a repository nevét.
2. Cím és státuszA title, amely linkké válik, ha megadod a title_url mezőt, mellette a status címkével.
3. AlcímEgy második félkövér sor, sub_title.
4. LeírásA törzs, markdownban.
5. MezőkCímke–érték sorok, másolás gombbal.
6. LáblécAz időpont, valamint a hozzáadott és törölt sorok, ha elküldöd őket.

{
  "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
  }
}

Összes mező

Ezek a message_container objektumba kerülnek. A kártyához leírás vagy betöltésjelző kell. A „Parancsválaszok” jelölésű mezők kimaradnak, ha webhookon keresztül küldesz.

Státusz és diff-statisztika

A státuszcímke már azelőtt elmondja a lényeget, hogy bárki elolvasná a szöveget. A cím mellett áll, vagy ha nincs cím, a láblécben; a diff-statisztika az időpont mellett jelenik meg. Mindkettő működik parancsokra adott válaszokban, és a beépített GitHub-integráció is használja őket. A webhook elhagyja őket.

#github

Message from GitHub• acme/web

Pull request #212 beolvasztva

Merged

11:20

Message from CI• acme/web

Sikertelen build a main ágon

Failing

search.test.js: 212 tesztből 2 elbukott.

11:24

Message from GitHub• acme/web

maya pusholt a main ágra

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."
  }
}

Ikonok

GitHubhoz bevált megfeleltetés

A beépített GitHub-integráció ezeket használja; másold át őket a saját eszközeidbe.

Betöltésjelző és gondolatmenet

Ha valami eltart egy darabig, például egy AI-válasz vagy egy hosszú feladat, előbb küldj egy kártyát forgó jelzővel, majd cseréld le az eredményre. A betöltésjelző webhookokból és parancsválaszokból is működik. Parancsválaszban a modell gondolatmenetét is elhelyezheted a thinking mezőben: a tagok szövegfal helyett egy Show thinking kapcsolót látnak.

#assistant

Message from Assistant

Gondolkodom…Olvasom az utolsó 50 üzenetet

09:02

Először: a betöltésjelző

#assistant

Message from Assistant

maya: mikor van a standup?

A standup 09:30-kor kezdődik, a #daily csatornában.

Show thinking

Átnéztem a kitűzött üzeneteket és a #daily ismétlődő eseményét.

09:02

Utána: a válasz, összecsukott gondolatmenettel

{
  "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…"
  }
}

Ha a betöltésjelzőt le akarod cserélni a válaszra, frissítsd az üzenetet egy új kártyával, amelyből kihagyod a loader mezőt. A módját az élő frissítések oldal írja le.

Hosszú leírások

Egy leírás legfeljebb 50 000 bájt lehet. Az első 1000 bájt után a tagok az elejét látják, és egy Show more gombot, amely betölti a többit, így egy hosszú jelentés nem árasztja el a csatornát.

Rendszerüzenetek

Állítsd be a "type": "system_message" értéket, ha közleményt küldesz, nem botbejegyzést: karbantartási időszakról, szabályzatváltozásról, bármiről, ami magának a közösségnek a nevében szól. Ugyanazokat a mezőket és gombokat fogadja.

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

Színek

A szegély színe a leggyorsabb jelzés egy kártyán. Ugyanahhoz a hírtípushoz mindig ugyanazt a színt használd.