Slack
De Slack-integratie koppelt een Slack-workspace aan Pyn. Eenmaal geïnstalleerd kunnen stappen een direct message sturen, in een kanaal posten of iemand voor een kanaal uitnodigen, kunnen medewerkers polls en formulieren beantwoorden zonder Slack te verlaten, en worden Slack-leden op e-mailadres aan medewerkers gematcht. Berichten komen van de Pyn Bot, van een custom bot met je eigen naam en icoon, of van een collega die zichzelf als Slack-sender heeft toegevoegd.
Voordat je begint
Section titled “Voordat je begint”- Je bent admin of owner in Pyn.
- Je kunt apps autoriseren in de Slack-workspace, of je Slack-beheerder keurt het verzoek goed dat Slack je toont.
- Zorg dat je in je browser bij die Slack-workspace bent ingelogd. Slack toont de workspace rechtsboven op zijn autorisatiepagina.
- Botscopes die Pyn vraagt:
app_mentions:read,channels:read,channels:write.invites,chat:write,groups:read,groups:write.invites,im:history,im:read,im:write,team:read,users:readenusers:read.email. De bot kan geen kanaalberichten lezen en niet uit zichzelf lid worden van kanalen; hij post alleen waar hij is uitgenodigd.

Koppelen
Section titled “Koppelen”-
Open in Pyn Settings in de linkernavigatie, en dan Available onder Integrations.
-
Selecteer de tegel Slack. Slack opent.
-
Controleer of de workspace rechtsboven de juiste is, bekijk de rechten en selecteer Allow.
-
Slack stuurt je terug naar Pyn. De tegel Slack toont Active onder Installed.
-
Open de tegel. Details toont het Team Id, Requires Reauthentication (false) en de verversingstijden. Nodig desgewenst vanuit Slack de Pyn Bot uit in de kanalen waarin je wilt posten.
Heeft een workspace een tegel Slack met Ready to Connect, open die dan en selecteer Connect Now: “Connecting to Slack allows you to send timely, automated messages to your employees.” Pyn kan één integratie per Slack-workspace hebben; Connect another workspace in het menu … voegt een tweede toe.
Wat er wordt gesynchroniseerd
Section titled “Wat er wordt gesynchroniseerd”- Leden: naam, handle, e-mailadres, avatar en tijdzone van elke Slack-gebruiker, ongeveer één keer per uur ververst. Een lid wordt op Slack-id of op e-mailadres aan een medewerker gematcht; zie Synchronisatiefrequentie en matching. Zodra een lid is gematcht, neemt het profiel van de medewerker meteen diens Slack-avatar over.
- Kanalen: in workspaces waar het verversen van kanalen is ingeschakeld, toont een tabblad Channels de Public Channels, en onder Private Channels de kanalen waarvan de Pyn Bot lid is, elk als
#name - n members (Slack Identifier: id); kanaalleden worden dagelijks bijgewerkt. Een kanaal verschijnt in de lijst To van een stap zodra het hier staat. - Senders: de Pyn Bot wordt samen met de integratie aangemaakt; custom bots en persoonlijke senders worden later toegevoegd.
- Deliveries: elk bericht, elk kanaalbericht en elke kanaaluitnodiging is een delivery in Activity.
Testen
Section titled “Testen”Open de tegel Slack, open het menu … en selecteer Test Connection. “Test successfully sent. Check your Slack account for the test message.” betekent dat de Pyn Bot je een direct message heeft gestuurd. “Slack appears to be configured, but we could not find you as a Slack Member to send the test message.” betekent dat je Pyn-e-mailadres met geen enkel lid in die workspace overeenkomt. “There is a misconfiguration preventing the test. Please contact support.” betekent dat de integratie zelf is mislukt.
Opnieuw koppelen of ontkoppelen
Section titled “Opnieuw koppelen of ontkoppelen”- Trekt Slack het token in, dan toont het paneel “This integration is not operational as it requires re-authentication. This can happen if credentials are revoked.” met Reconnect, dat terugkeert naar dezelfde Slack-workspace. De tegel verschijnt ook onder Needs Attention 🚨 en een melding heeft dezelfde knop.
- Deactivate stopt elke Slack-sender en -delivery; Activate hervat ze.
Problemen oplossen
Section titled “Problemen oplossen”| Wat je ziet | Wat het betekent |
|---|---|
| “We could not start the Slack connection. Please contact support.” | Pyn kon het inloggen bij Slack niet starten. Probeer het opnieuw en neem daarna contact op met support. |
| Slack toont een scherm voor goedkeuring door een beheerder | Je workspace vereist goedkeuring van een beheerder voor apps. Dien het verzoek in, laat een Slack-beheerder het goedkeuren en koppel daarna opnieuw. |
| Een kanaal ontbreekt in de lijst To van een stap | De bot zit niet in een privékanaal, of het kanaal is aangemaakt na de laatste verversing. Nodig de bot uit en wacht een paar minuten; de stap toont “No results” wanneer de sender geen kanalen heeft. |
| Een kanaalbericht mislukt | De sender is geen lid van het kanaal. Nodig de bot of custom bot uit, of word zelf lid van het kanaal. |
| Iemand wordt niet gematcht | Zijn of haar Slack-e-mailadres verschilt van het zakelijke e-mailadres in je HRIS. Corrigeer een van beide, of gebruik Disconnect op het record van de medewerker om een verkeerde match te wissen. |
| Je hebt de verkeerde workspace gekoppeld | Kies Deactivate voor die workspace, gebruik Connect another workspace in het menu … om de juiste toe te voegen, en vraag support om de verkeerde te verwijderen. |
Gerelateerd
Section titled “Gerelateerd”- Een custom bot toevoegen om vanuit je eigen botnaam en -icoon te versturen.
- Een Slack-sender toevoegen om als jezelf te versturen.
- Een auth-link maken voor een sender zonder Pyn-login.
- Synchronisatiefrequentie en matching voor hoe leden medewerkers worden.
- Een bericht opmaken om de medewerker, een collega op Slack-gebruikersnaam of een heel kanaal te mentionen.