Koppelingen en apps

Conserio spreekt aan de buitenkant de taal van Slack. Een koppeling die met Slack werkt, werkt meestal met Conserio door alleen een adres te veranderen, of een adres en een token. Apps en webhooks beheer je in de desktop-app onder Voorkeuren, tabblad Apps. Alleen beheerders van het bedrijf zien daar de knoppen om iets aan te maken.

Meldingen van andere systemen: webhooks

Monitoring, CI en automatisering (Uptime Kuma, Grafana, Prometheus Alertmanager, GitHub Actions, n8n, Jenkins, Zabbix en vele andere) sturen hun meldingen naar een webhook.

1. Open Voorkeuren, Apps, en kies onder Webhooks het kanaal waar de meldingen moeten komen. Geef de webhook een naam, bijvoorbeeld “Uptime Kuma”.
2. Je ziet twee adressen, maar één keer. Kopieer het Slack-adres (eindigt op /api/slack/hooks/…).
3. Plak dat adres in de tool, op de plek van de Slack-webhook-URL. Verder verander je niets.
4. Stuur een testmelding vanuit de tool.

Een melding verschijnt als een kaart: een kop, tekst, velden in twee kolommen, eventueel een afbeelding en knoppen met een link, en links een gekleurde streep. Groen, oranje en rood volgen de kleuren van Conserio. Een webhook hoort bij één kanaal; maak er per kanaal een.

Eigen apps en bots

Heeft je team een eigen Slack-app, bijvoorbeeld een bot die nieuwe leads plaatst met de knoppen Versturen en Weggooien? Die stapt over zonder de code te veranderen.

1. Kies Nieuwe app, of Slack-manifest importeren en plak het App Manifest (YAML of JSON) van api.slack.com/apps. Naam, Request URL, slash-commando’s en gebeurtenissen komen dan mee.
2. Na App maken zie je één keer de Basis-URL, het Bottoken en het Signing secret. Kopieer ze meteen met Kopiëren.
3. Kies bij Wijzigen de Kanalen waar de app in mag. Een app ziet en doet alleen iets in die kanalen.
4. Zet in de instellingen van de app de basis-URL, het token en het signing secret. Bij Bolt en de Slack-SDK is dat meestal een omgevingsvariabele.

Wat een app kan:

• berichten plaatsen, bijwerken en verwijderen, ook in een thread;
• kaarten met knoppen; een klik gaat naar de Request URL van de app, ondertekend zoals bij Slack, en de app kan het bericht daarna bijwerken;
• Slash-commando’s: een collega typt bijvoorbeeld /lead Van Dijk in het berichtveld; het directe antwoord van de app ziet alleen hij;
• Gebeurtenissen: berichten, vermeldingen van de app, reacties en nieuwe leden;
• reacties plaatsen en kanalen, berichten en gebruikers opvragen.

Heeft de app geen publiek adres, bijvoorbeeld omdat hij in jullie eigen netwerk draait? Zet dan Eigen verbinding (Socket Mode) aan. De app maakt dan zelf verbinding met Conserio.

Wat niet werkt

• Officiële “Add to Slack”-apps van andere bedrijven, zoals die van Jira Cloud, Google Drive, Sentry of Zoom. Die installeren zich via Slack zelf. Bijna allemaal bieden ze ook een gewone Slack-webhook; gebruik die met het Slack-adres van Conserio.
• Berichten die alleen één persoon ziet, formulieren in een pop-up en bestanden uploaden door een app. Deze volgen later.
• Op iPhone, iPad en Android zie je kaarten en werken knoppen, maar apps beheren en slash-commando’s typen kan alleen op de desktop.

Een stap-voor-stapgids per tool, voor wie de koppelingen inricht, staat in de overstapgids “Je Slack-koppelingen naar Conserio”.