De Mokapen-gids

Slack

Koppel de Slack-workspace om meldingen van Mokapen te ontvangen en taken aan te maken zonder Slack te verlaten. Het synchroniseert geen kanalen, berichten of bestanden: het publiceert de gebeurtenissen die je kiest en opent een taak wanneer iemand het commando of de snelkoppeling gebruikt.

Overzicht: Integraties.

Vereisten

• Recht om een app in de Slack-workspace te installeren. Als de Slack-beheerder externe apps blokkeert, stopt de autorisatie daar: goedkeuring gebeurt in het Slack-portaal, niet in Mokapen.
• Mokapen-plan Medium.
• Mokapen-gebruikers met hetzelfde e-mailadres als het Slack-account, als je wilt dat de taaktoewijzing bij de juiste persoon terugkomt.

Koppelen en meldingen kiezen

Gebruikersmenu → Integraties → Slack en autoriseer de workspace. Daarna, op de pagina:

• Kanaal — waar Mokapen publiceert. Zonder kanaal start de testmelding niet.
• Taak toegewezen / nieuwe opdracht — een bericht wanneer een taak wordt toegewezen.
• Nieuwe opmerking op de taak — een bericht wanneer er een opmerking binnenkomt.
• Testmelding versturen — controleer het kanaal voordat je gebeurtenissen aanzet. De testtekst zegt dat de integratie werkt.

Slack-gebruikers worden aan Mokapen-gebruikers gekoppeld via e-mail. Heeft iemand in Slack een ander e-mailadres, corrigeer de regel in de gebruikerskaart: anders maakt het commando de taak, maar komt de toewijzing niet bij die persoon terug.

Een taak vanuit Slack aanmaken

In het kanaal schrijf je het slash-commando met de app-slug en de titel, in de vorm die op de pagina staat (/slug De titel). Alternatief gebruik je de snelkoppeling op het bericht. De Mokapen-pagina toont de URL om in de Slack-app te plakken als Request URL van Slash Commands en Interactivity, en de URL van Event Subscriptions (…/slack/events). Die twee adressen horen in de Slack-appconfiguratie: zonder komen kanaalcommando's niet bij Mokapen aan, ook als OAuth gekoppeld lijkt.

Het commando maakt een taak. Het werkt geen opportunity bij, sluit geen ticket en antwoordt niet aan de klant. Is de titel leeg, is er niets om aan te maken.

Wanneer het kanaal stil blijft

• De gebeurtenis staat niet aan, of het kanaal is een ander dan je bekijkt.
• De taak is toegewezen aan een gebruiker die Slack niet in de kaart heeft: de gebeurtenis kan toch starten, maar de persoon wordt in het bericht niet herkend.
• De Slack-app is ingetrokken door workspacebeheerders. Ontkoppel in Mokapen en autoriseer opnieuw, nadat de app weer is toegelaten.