Dokumentation

Chattplattformar

Gör Slack- och Telegram-meddelanden till förfrågningar och få uppdateringar om uppgifter i Slack.

Coroid har plattformsbotar för Slack, Discord, Telegram och SMS. Konfigurera dem i det här avsnittet: Inställningar → Anslutningar → Kanaler.

Så här fungerar de i dag:

PlattformMeddelanden blir förfrågningarTar emot uppdateringar
SlackJa, via en händelseautomatiseringUppgiftsuppdateringar via en inkommande webhook
TelegramJa, via en händelseautomatiseringNej
DiscordNejNej
SMSNejNej

Du kan spara en Discord- eller SMS-bot, men inget använder den i dag. På samma sida finns även kanalbryggor, som inte fungerar än. Se Kanalbryggor.

Plattformsbotar

Boten är den identitet som Coroid använder på plattformen. Installera den en gång per arbetsyta eller server och ge den åtkomst till kanalerna den ska läsa. Slack och Telegram behöver sin bot för att en händelseautomatisering ska kunna läsa meddelanden.

Om en Slack-bot tas bort från en kanal kan Coroid inte längre läsa den kanalen, och det meddelas inte. Om Slack-meddelanden slutar bli förfrågningar kontrollerar du att boten fortfarande finns i kanalen.

Endast ägare och administratörer kan lägga till, ändra eller ta bort en bot. Varje plattform skickar sina händelser till en webhook-URL på API-gatewayen, som Coroid visar för varje bot. Coroid avvisar leveranser som inte signerats med botens hemlighet.

Starta arbete från en kanal

Ett Slack- eller Telegram-meddelande kan bli en arbetsförfrågan. Meddelanden från Discord och SMS kan inte det.

Ett meddelande blir en förfrågan via en händelseautomatisering. Det är användbart för förfrågningar som ”kan någon bara fixa …”, som annars aldrig skulle bli spårbart arbete.

Ett matchande meddelande skickas till Kvalificering som en förfrågan. Kvalificeringen granskar den, letar efter dubbletter och avgör vad den ska bli. Inget skapas förrän den har godkänts. Se Så kan du starta arbete.

Coroid kopplar inte Slack- eller Telegram-konton till Coroid-konton, så alla som kan skriva i en matchande chatt kan skicka in en förfrågan. Därför startar arbete från en chatt aldrig automatiskt. En kvalificerad uppgift skapas och väntar på att någon startar den, och en plan väntar på godkännande.

Se Utlösare och destinationer.

Slack

  1. Konfigurera Slack-boten i det här avsnittet: Plattformsbotar. Den behöver botens token och Slack-appens signeringshemlighet.
  2. I Slack-appen skickar du kanalmeddelanden och omnämnanden av appen till webhook-URL:en som Coroid visar: https://api.coroid.ai/api/v1/webhooks/slack/events.
  3. Bjud in boten till varje kanal den ska läsa.
  4. Aktivera Slack i Kvalitetskontroll → Organisationens standardinställningar → Innan arbetet börjar → Var förfrågningarna kommer ifrån. Endast ägare och administratörer kan aktivera en källa, och bara när boten är ansluten.

När du aktiverar Slack läggs en automatisering till som skickar matchande meddelanden som förfrågningar. Den finns under Mjukvarufabrik → Automatiseringar, där du kan ändra filtret. Om du inaktiverar Slack pausas automatiseringen och filtret behålls.

Automatiseringens filter avgör vilka meddelanden som räknas. Till att börja med matchar det meddelanden som innehåller den här omnämningen: @coroid. Ett filter kan också begränsa automatiseringen till en kanal eller till meddelanden som publicerats av botar, till exempel aviseringar.

Coroid kör högst 10 Slack-automatiseringar per minut i en kanal.

Telegram

  1. Lägg till Telegram-boten i det här avsnittet: Plattformsbotar. Coroid registrerar dess webhook hos Telegram och skyddar den med en webhook-hemlighet. Om du lämnar hemligheten tom genererar Coroid en åt dig.
  2. Lägg till boten i gruppen eller gör den till administratör för kanalen.
  3. Aktivera Telegram i Kvalitetskontroll → Organisationens standardinställningar → Innan arbetet börjar → Var förfrågningarna kommer ifrån. Automatiseringen finns under Mjukvarufabrik → Automatiseringar, där du kan ändra filtret.
  4. Börja varje förfrågan i chatten med det här kommandot: /coroid.

Telegrams sekretessläge, som är aktiverat som standard, gör att boten kan se kommandon men inte vanliga meddelanden. Ett filter kan också begränsa automatiseringen till en chatt med hjälp av dess chatt-ID. Boten ignorerar direktmeddelanden om inte filtret tillåter dem.

Vem som helst kan lägga till din bot i en annan grupp och skicka in förfrågningar därifrån. För att förhindra det kan du begränsa automatiseringen till din chatt eller hindra boten från att gå med i grupper med det här BotFather-kommandot: /setjoingroups.

Coroid tar emot högst 10 matchande meddelanden per minut från en chatt. Om automatiseringen är begränsad till ett projekt skickas förfrågningarna dit.

Kanalbryggor

En brygga kopplar en kanal till en session med chattassistenten.

Det går inte att prata med assistenten via en brygga. En brygga vidarebefordrar inte meddelanden till assistenten och kan därför inte starta eller styra arbete.

Uppdateringar i en kanal

Slack är den enda chattplattformen som tar emot uppdateringar. Coroid publicerar i en Slack-kanal när en uppgift slutförs, misslyckas eller eskaleras, och när den försöker igen eller ger upp vid en merge-konflikt. Meddelandena skickas via en inkommande Slack-webhook som är ansluten till din organisation, inte via Slack-boten. Det finns ännu ingen inställningssida där du kan ansluta webhooken.

Discord, Telegram och SMS tar inte emot några uppdateringar. Allt annat visas i portalen. Se Aviseringar.