OpenXE/userdata/wiki/XentralHandbuch/changelog/slacknotification/content_1
2021-05-21 08:49:41 +02:00

2 lines
6.4 KiB
Plaintext

<p><strong><span style="font-size:28px;">Slack Benachrichtigungen</span></strong></p><p>Mit dem Modul &quot;Slack Benachrichtigungen&quot; k&ouml;nnen Sie Ereignisse in Xentral als Nachricht an einen bestimmten Slack Channel schicken lassen. Im Moment k&ouml;nnen Sie jedes mal wenn ein Angebot oder ein Auftrag weggeschickt wurde, eine automatische Benachrichtigung an Slack senden. Dies ist vor allem hilfreich wenn das Vertriebs-Team &uuml;ber alle versendeten Angebote und Auftr&auml;ge auf dem Laufenden bleiben will.<br /><br />Slack: https://slack.com<br /><br />Beispiel-Benachrichtung im Slack Channel:<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=1" /></p><h1>Einstellungen</h1><p>Im Reiter &quot;Einstellungen&quot; k&ouml;nnen Sie die Benachrichtigungen konfigurieren.<br />&nbsp;</p><p><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=2" /></p><h2>Auftrag Versendet</h2><p>F&uuml;llen Sie die nachfolgenden Felder aus, wenn Sie bei einem versendeten Auftrag eine Benachrichtigung an Slack schicken wollen.</p><ul><li>Webhook-URL: Die URL aus der installierten Slack App, siehe Anleitung unterhalb zum Erstellen einer Slack-App f&uuml;r Xentral.</li><li>Benachrichtigungstext: Der Text, der in der Nachricht in Slack angezeigt wird.</li><li>Bild-URL (optional): Eine &ouml;ffentliche URL eines Bildes (kein lokaler Link). Dies wird auch in der Benachrichtigung in Slack angezeigt</li></ul><h2><br />Angebot Versendet</h2><p>F&uuml;llen Sie die nachfolgenden Felder aus, wenn Sie bei einem versendeten Angebot eine Benachrichtigung an Slack schicken wollen.</p><ul><li>Webhook-URL: Die URL aus der installierten Slack App, siehe Anleitung unterhalb zum Erstellen einer Slack-App f&uuml;r Xentral.</li><li>Benachrichtigungstext: Der Text, der in der Nachricht in Slack angezeigt wird.</li><li>Bild-URL (optional): Eine &ouml;ffentliche URL eines Bildes (kein lokaler Link). Dies wird auch in der Benachrichtigung in Slack angezeigt</li></ul><p>&nbsp;</p><h2>Variablen und Formatierung</h2><p>Variablen f&uuml;r den Text: {BELEGNUMMER}, {KUNDENNAME}, {KUNDENNUMMER}, {BEARBEITER}, {BETRAG}<br />Formatierung: *fett*, _kursiv_ und ~durchgestrichen~<br />&nbsp;</p><h2>Slack App erstellen f&uuml;r Webhook-URL</h2><p>Die Erstellung einer App in Slack f&uuml;r die Webhook-URL ist relativ unkompliziert und wird im Folgenden sehr ausf&uuml;hrlich mit einem Screenshot f&uuml;r jeden Schritt beschrieben.</p><p>1. Slack Desktop App - Einstellungen Icon + Neue App erstellen<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=3" /><br /><br />2. Slack Weboberfl&auml;che - Erstellen<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=4" /><br /><br />3. Slack Weboberfl&auml;che - Start Building<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=5" /><br /><br />4. Slack Weboberfl&auml;che - Create App<br />App Name frei w&auml;hlen und Slack Workspace ausw&auml;hlen f&uuml;r die Benachrichtigungen.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=6" /><br /><br />5. Slack Weboberfl&auml;che - Incoming Webhooks<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=7" /><br /><br />6. Slack Weboberfl&auml;che - Activate Incoming Webhooks<br />Incoming Webhooks an dieser Stelle aktivieren:<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=8" /><br /><br />7. Slack Weboberfl&auml;che - Add new Webhook to Workspace<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=9" /><br /><br />8. Slack Weboberfl&auml;che - Add new Webhook to Workspace<br />W&auml;hlen Sie einen Slack-Channel aus, in dem die Benachrichtigungen ver&ouml;ffentlicht werden sollen.<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=10" /><br /><br />9. Slack Weboberfl&auml;che - Add new Webhook to Workspace<br />Danach kommen Sie in die Maske, in der Sie die Webhook URL mit dem &quot;Copy&quot; Button kopieren k&ouml;nnen.<br />Diese k&ouml;nnen Sie direkt in die entsprechenden Felder in den Einstellungen des Moduls in Xentral eingeben.<br />&nbsp;</p><p><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=11" /><br /><br />Kopieren Sie die Webhook URL und f&uuml;gen Sie diese in die Slack Einstellung in Xentral ein:<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=2" /><br /><br /><strong>Hinweis</strong>: Wenn Sie die erstellte App nochmal einsehen / &auml;ndern wollen, m&uuml;ssten Sie &uuml;ber die URL https://api.slack.com/ und dann &quot;Your Apps&quot; oben rechts gehen.<br />&nbsp;</p><h1>Slack Benachrichtigung automatisch versenden</h1><h2>Ausl&ouml;ser f&uuml;r eine Slack Benachrichtigung</h2><p>Sobald die entsprechenden Einstellungen get&auml;tigt werden, wird die entsprechende Nachricht an den hinterlegten Slack-Channel geschickt, sobald ein Angebot / Auftrag per E-Mail &uuml;ber den Abschicken Dialog (Aktions-Men&uuml; im Beleg) verschickt wurde.<br />&nbsp;</p><p><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=12" /><br /><br />Oder direkt wenn der Auftrag mit einer E-Mail freigegeben wurde:<br /><br /><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=13" /><br />&nbsp;</p><h2>Slack Benachrichtigung in der Slack App</h2><p>Die Slack Benachrichtigung sieht dann mit den Beispiel-Einstellungen von oben, so aus:<br />&nbsp;</p><p><img src="index.php?module=wiki&amp;action=getfile&amp;workspacefolder=XentralHandbuch&amp;article=slacknotification&amp;fileid=1" /></p><p>&nbsp;</p><br /><br /><br />&nbsp;<pre>
&nbsp;</pre>