Creează carduri de mesaj

Anatomia unui card

Părțile unui card, de sus în jos. Lasă deoparte ce nu îți trebuie: și un card doar cu titlu este în regulă.

#github

Message from GitHub• acme/web

Pull request-ul #212 a fost deschis

Open

Căutare mai rapidă în lista de canale

Căutarea rulează acum la fiecare tastă, cu un debounce de 120 ms.

Autor

maya

Revieweri

dani, sam

10:03

+86-12

1. Antet„Message from” și un nume: numele webhook-ului sau, la un răspuns la o comandă, numele comunității tale. Un răspuns poate adăuga un badge, de exemplu repository-ul.
2. Titlu și statustitle, care devine link când setezi title_url, cu eticheta status alături.
3. SubtitluO a doua linie îngroșată, sub_title.
4. DescriereConținutul, în markdown.
5. CâmpuriRânduri cu etichetă și valoare, cu un buton de copiere.
6. SubsolOra, plus liniile adăugate și șterse, dacă le trimiți.

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

Toate câmpurile

Acestea merg în message_container. Un card are nevoie de o descriere sau de un loader. Câmpurile marcate „Răspunsuri la comenzi” sunt eliminate când postezi printr-un webhook.

Status și statistici de diff

O etichetă de status spune povestea înainte ca cineva să citească textul. Stă lângă titlu sau, dacă nu există titlu, în subsol; statisticile de diff apar lângă oră. Ambele funcționează în răspunsurile la comenzi, iar integrarea GitHub încorporată le folosește. Un webhook le elimină.

#github

Message from GitHub• acme/web

Pull request-ul #212 a fost integrat

Merged

11:20

Message from CI• acme/web

Build-ul a eșuat pe main

Failing

search.test.js: 2 din 212 teste au eșuat.

11:24

Message from GitHub• acme/web

maya a făcut push pe 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."
  }
}

Iconițe

O mapare care funcționează pentru GitHub

Integrarea GitHub încorporată folosește aceste valori; copiază-le pentru propriile tale unelte.

Loader și raționament

Pentru orice durează puțin, cum ar fi un răspuns AI sau un job lung, postează mai întâi un card cu un spinner, apoi înlocuiește-l cu rezultatul. Loader-ul funcționează din webhook-uri și din răspunsurile la comenzi. Într-un răspuns la o comandă poți pune și raționamentul modelului în thinking: membrii văd un comutator Show thinking în loc de un zid de text.

#assistant

Message from Assistant

Mă gândesc…Citesc ultimele 50 de mesaje

09:02

Întâi: loader-ul

#assistant

Message from Assistant

maya: când e standup-ul?

Standup-ul e la 09:30, în #daily.

Show thinking

Am verificat mesajele fixate și evenimentul recurent din #daily.

09:02

Apoi: răspunsul, cu raționamentul pliat

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

Ca să înlocuiești loader-ul cu răspunsul, actualizează mesajul cu un card nou fără loader. Cum se face afli la actualizări live.

Descrieri lungi

O descriere poate avea până la 50.000 de octeți. După primii 1.000, membrii văd începutul și un buton Show more care încarcă restul, așa că un raport lung nu inundă canalul.

Mesaje de sistem

Setează "type": "system_message" pentru un anunț în loc de o postare de bot: ferestre de mentenanță, schimbări de reguli, orice vorbește în numele comunității însăși. Acceptă aceleași câmpuri și butoane.

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

Culori

Culoarea marginii este cel mai rapid semnal de pe un card. Folosește aceeași culoare pentru același tip de veste, de fiecare dată.