erpnext/foundation
1
0
Fork 0
mirror of https://github.com/erpnext/foundation.git synced 2026-10-16 18:00:47 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add message formatting

Browse Source
This commit is contained in:
Charles-Henri Decultot
2018-10-03 15:19:08 +00:00
parent ecbfaaf351
commit 9821b34c1c
1 changed files with 42 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
foundation/www/docs/user/manual/en/setting-up/notifications/index.md
View File

@@ -88,18 +88,53 @@ Then you can use that as a condition in the **Condition** rules to ensure emails
---
### Configuring Slack notifications
# Slack Notifications
Instead of sending a notification through emails, you can configure a Slack Webhook URL and receive your notification directly in Slack.
If you prefer to have your notifications sent to a dedicated Slack channel, you can also choose the option "Slack" in the channel options and select the appropriate Slack Webhook URL.
1. Create a Slack App
### Slack Webhook url
A Slack webhook URL is an URL pointing directly to a Slack channel.
In order to generate webhook URLs, you need to create a new Slack App:
1. Go to https://api.slack.com/slack-apps
2. Click on "Create a Slack App"
<img class="screenshot" alt="Set Message" src="{{docs_base_url}}/assets/img/setup/notifications/slack_notification_1.png">
2. Create new Slack Webhook URLs
3. Give your App a name and choose the right workspace
Once your app is created, go to the "Incoming Webhooks" section and add a new Webhook to Workspace.
<img class="screenshot" alt="Set Message" src="{{docs_base_url}}/assets/img/setup/notifications/slack_notification_2.png">
3. Add the Slack Webhook URL to ERPNext
4. Copy the created link, go back to ERPNext and use it to create a new Slack Webhook URL in Integrations > Slack Webhook URL.
<img class="screenshot" alt="Set Message" src="{{docs_base_url}}/assets/img/setup/notifications/slack_notification_3.png">
4. Select Slack and your Slack channel in the channel and Slack channel fields within your notification
5. Select Slack and your Slack channel in the channel and Slack channel fields within your notification
### Message Format
Unlike Email messages, Slack doesn't allow HTML formatting.
Instead you can use markdown formatting: [Slack Documentation](https://get.slack.help/hc/en-us/articles/202288908-Format-your-messages)
Example:
{% raw %}
*Order Overdue*
Transaction {{ doc.name }} has exceeded Due Date. Please take necessary action.
{% if comments %}
Last comment: {{ comments[-1].comment }} by {{ comments[-1].by }}
{% endif %}
*Details*
• Customer: {{ doc.customer }}
• Amount: {{ doc.grand_total }}
{% endraw %}
<img class="screenshot" alt="Set Message" src="{{docs_base_url}}/assets/img/setup/notifications/slack_notification_4.png">
{next}