Chat Destinasjoner

Chat destinasjoner legge arbeidsområde kort aktivitet rett inn i kanalen der teamet allerede snakker.

De er innebygd. Du trenger ikke REST API, en mellomvaretjeneste eller en bot av din egen: velg en leverandør, lim inn tilkoblingen chatteverktøyet genererer, velg hendelsene verdt å legge ut, og Kanera formater og leverer hver melding innfødt for den plattformen.

Leverandør	Tilkobling du oppgir
Slack	En innkommende webhook-URL fra en Slack-app.
Discord	En webhook-URL for kanal fra kanalinnstillinger.
Telegram	En bot token og chat ID, med en valgfri emne tråd.
Zulip	En Slack-kompatibel innkommende webhook URL.

Chat destinasjoner er en ANDRE feed, omsluttet til ett arbeidsområde eller frittstående tavle. For dine egne private varsler, bruk Personlige leveringskanaler i stedet.

Når du skal bruke dem

Bruk et chatmål når en gruppe trenger å se arbeid i bevegelse uten å åpne Kanera:

En leveringskanal. Postkort opprettet, status endret, og kommentar opprettet slik at teamet ser en tavle hjerteslag i kanalen de allerede ser på.
En kunde eller interessentkanal. Kun statusen for innlegg endres til en delt kanal, slik at interessenter ser fremgang uten tilgang til tavlen.
En eskaleringskanal. Tilordne et Prioritet-tilpasset felt og kun legge inn prioritetsendringer, slik at et kort flyttes til Haster De står foran folk som reagerer på det.
En gjennomgangskanal. Innleggsbeskrivelse endret og kommentar opprettet for en tavle der ordlyd og beslutninger har betydning.
En standup-kanal. Postkort opprettet og status endret til en lagkanal med en emnetråd i Telegram eller Zulip, slik at den daglige flyten forblir på ett sted.

Chat destinasjoner legge aktivitet for hele arbeidsområdet, ikke per person. Alle i kanalen ser meldingen, uavhengig av oppgave. Husk det for tavler med sensitive korttitler.

Krav

Du må være en arbeidsområde admin — den samme tillatelsen som brukes til å administrere API-nøkler og webhooks.
Chat destinasjoner trenger Pro eller 30-dagers Pro-rettssaken. De er ikke tilgjengelige på verts Free.
Kanera må kunne nå leverandøren over offentlig HTTPS.

Åpne Arbeidsområdeinnstillinger -> Integrasjoner. Frittstående boards har samme Integrasjoner fanen i sine egne bordinnstillinger.

På vert Free fanen viser Chat destinasjoner er ikke tilgjengelig på planen din I stedet for form.

Et varslingsmål som er opprettet under en prøveperiode eller med Pro, slettes aldri når organisasjonen går over til Free, men det slutter å sende. Kanera setter det på pause, ingen nye varsler når kanalen, og varsler som venter på å bli sendt, forkastes i stedet for å komme sent, og Send test og re-aktivering er ikke tilgjengelig. Oppgradering tilbake til Pro slår de pausede destinasjonene på igjen, med deres hendelser, prioriterte kartlegging og lagret tilkobling intakt. Se Webhooks for den fullstendige nedgraderingsadferden, som chattedestinasjoner deler.

Velg hva som skal publiseres

Hvert reisemål abonnerer på sitt eget sett med hendelser under Post når:

Hendelse	Posts når
Kortet er opprettet	Nytt arbeid er lagt til tavlen.
Status endret	Et kort flytter seg mellom lister. Meldingen gir navn til listen den forlot og listen den skrev inn.
Prioritet endret	Det tilordnede egendefinerte feltet endrer verdi.
Tittel endret	Et kort får nytt navn. Meldingen bruker den nye tittelen.
Beskrivelse endret	Kortdetaljer er oppdatert. Meldingen inneholder et utdrag i klartekst.
Kommentar opprettet	Noen kommenterer et kort. Meldingen inneholder et kommentarutdrag.

Nye destinasjoner starter med alt unntatt Prioritet endret Trim det ned: en kanal som legger ut hver beskrivelse redigering på en opptatt tavle blir dempet raskt, og en dempet kanal er verre enn ingen kanal.

Prioritet endret behov en feltkartlegging

Kanera har ikke et fast prioritetsbegrep — prioritet er et egendefinert felt som arbeidsområdet ditt definerer. Når du velger Prioritet endretDu kan også velge hvilket felt du vil se på under Prioritert egendefinert felt.

Feltet må være aktivt Velg eller tekst custom-feltet i det arbeidsområdet.
Målinnleggene endres bare til det ene feltet. Andre egendefinerte feltredigeringer ignoreres.
Hvis det tilordnede feltet senere arkiveres eller slettes, vises det en advarsel om at målet er satt på pause til du tilordner et aktivt felt igjen.

Sett opp Slack

Gå til Slack-apper og opprett en app i arbeidsområdet ditt, eller åpne en eksisterende.
Slå på Innkommende Webhooks.
Klikk Legg til ny Webhook til arbeidsområdet Velg kanalen du vil legge inn.
Kopier den genererte webhook-URLen. Det starter med https://hooks.slack.com/services/.
I Kanera, åpne Arbeidsområdeinnstillinger -> Integrasjoner, velg Slackog navngi målet etter kanalen, for eksempel #product-updates.
Lim inn webhook-URLen, velg dine hendelser og klikk Legg til destinasjon.
Klikk på send-ikonet på den nye destinasjonen for å legge inn en testmelding, og bekreft at den lander i riktig kanal.

Kanera godtar bare Slack innkommende webhook URL-adresser på hooks.slack.com eller hooks.slack-gov.com. Hver melding kommer med korttittelen som en kobling og arbeidsområdet og tavlen som heter under, og Slack utvider ikke en forhåndsvisning av koblingen.

Sett opp Discord

I splid, åpen Kanalinnstillinger -> Integrasjoner -> Webhooks.
Opprett en webhook, velg kanalen, og angi eventuelt navn og avatar.
Klikk Kopier Webhook- URL. Det begynner med https://discord.com/api/webhooks/.
I Kanera, velg Discord, navn destinasjonen, lim inn URL, velg dine hendelser, og klikk Legg til destinasjon.
Send en testmelding og bekreft at den kommer.

Meldinger kommer som en splid innebygging: korttittelen som en lenke, et utdrag under den, og arbeidsområdet og tavlen langs bunnen. Tekst fra et kort blir aldri behandlet som en ekte omtale, så kortinnhold kan aldri ping @everyone eller en rolle.

Sett opp Telegram

Telegram bruker en bot i stedet for en webhook URL.

Melding @BotFar i Telegram, send /newbotFølg instruksjonene (se nedenfor).
Kopier bot token BotFar returnerer.
Legg til boten i gruppen eller kanalen som skal motta oppdateringer, og gi den tillatelse til å legge ut.
Finn chat-ID. Den enkleste måten er å sende en melding i chatten, og deretter åpne https://api.telegram.org/bot<token>/getUpdates og lese result[].message.chat.idGruppe- og kanal-ID-er er negative, som -1001234567890.
I Kanera, velg Telegram, navn på målet, og lim inn Bot token og Chat ID.
Hvis gruppen bruker emner og du vil ha ett bestemt emne, skriver du inn den numeriske id-en i Emnetråd. La den stå tom for å legge inn i hovedtråden.
Velg dine arrangementer, klikk Legg til destinasjonSend en testmelding.

Meldinger kommer formatert, med korttittelen som en link og ingen utvidet link forhåndsvisning. I Kanera viser destinasjonslisten chat-id delvis skjult, pluss emne-id når man er satt, slik at du kan fortelle to Telegram-destinasjoner fra hverandre uten at legitimasjonen er på skjermen.

Sett opp Zulip

I Zulip, åpne Personlige innstillinger -> Botseller organisasjonens integrasjonsside, og legg til Slack-kompatibel webhook integrasjon.
Velg strømmen og emnet som skal motta oppdateringer.
Kopier den genererte integrasjonsadressen. Den er på Zulip-verten og inkluderer botens API-nøkkel.
I Kanera, velg Zulip, navn målet, og lim inn den URL-adressen.
Velg dine arrangementer, klikk Legg til destinasjonSend en testmelding.

Zulip Cloud og selvbetjent Zulip fungerer begge, siden URL-en peker på din egen Zulip. Kanera sender meldinger i det formatet som integrasjonen forventer.

Hva en melding inneholder

Hver melding er bygget fra de samme bitene, og deretter formatert for leverandøren:

Hvem og hva — personens navn og handlingen, for eksempel flyttet et kort fra Under utvikling til Gjennomgang.
Kortet — tittelen, med lenke til kortet i Kanera.
Sammenheng — navnene på arbeidsområdet og tavlen.
Et utdrag — for beskrivelser og kommentarer, opptil 500 tegn med ren tekst.

Kortbeskrivelser og kommentarer er skrevet i Markdown, så Kanera konverterer dem til lesbar tekst først: overskrifter, bilder, kodeblokker og lenker kommer som ord i stedet for rå formatering. Link forhåndsvisninger er slått av for å holde kanalen ryddig, og nevner i kortinnhold blir aldri behandlet som ekte nevner, slik at ingen kan pinge en hel kanal ved å skrive inn et kort.

Meldingen lenker til kortet, men gir ikke tilgang til det. Noen som følger lenken trenger fortsatt tillatelse til å åpne tavlen.

Administrere et mål

Hvert mål i listen viser leverandøren, tilkoblingssammendraget, abonnerte hendelser og siste vellykkede levering med disse handlingene:

Handling	Bruk
Send test	Legg inn en testmelding for å bekrefte at tilkoblingen fungerer. Destinasjonen må være aktivert.
Rediger	Gi nytt navn til den, endre hvilke hendelser den legger ut, eller endre det tilordnede prioritetsfeltet.
Erstatt tilkobling	Lim inn en ny webhook-URL eller ny Telegram-legitimasjon uten å gjenopprette målet. Bruk dette etter å ha rotert en webhook i Slack eller Discord.
Pause / Aktiver	Stopp eller gjenoppta innlegg uten å slette oppsettet.
Slett	Fjern destinasjonen permanent.

Kretifikatene lagres kryptert og vises aldri igjen. For å endre dem, bruk Erstatt tilkobling.

Levering og pålitelighet

Meldinger sendes i bakgrunnen, så det å legge ut på chat bremser aldri opp tavlen for teamet som bruker det.

Hvis Slack, Discord, Telegram eller Zulip har en dårlig ettermiddag, blir meldinger ikke tapt. Kanera fortsetter å prøve, venter lenger mellom forsøk, i opptil åtte forsøk før den registrerer meldingen som mislykket. Hver destinasjon holder en leveringshistorikk du kan åpne for å se hva som gikk ut og hva som mislyktes, og du kan prøve en mislykket melding selv når leverandøren er frisk. Den historien dekker omtrent den siste uken med vellykkede innlegg og de siste to ukene med feil.

Når du setter en destinasjon på pause, stopper du å legge ut innlegg fra det øyeblikket. Aktiviteten under pause lagres ikke og leveres når du fortsetter, så en kanal som er satt på pause, tar opp det som skjer neste gang, i stedet for å spille av det den gikk glipp av.