{% extends '../layout/admin.html' %} {% block html_title %}{{ t('Notification settings') }} ยท {{ path }}{% endblock %} {% block layout_header %}
{% endblock %} {% block content_main %}
{% include './widget/menu.html' with {current: 'notification'} %}
{% set smessage = req.flash('successMessage') %} {% if smessage.length %}
{% for e in smessage %} {{ e }}
{% endfor %}
{% endif %} {% set emessage = req.flash('errorMessage') %} {% if emessage.length %}
{% for e in emessage %} {{ e }}
{% endfor %}
{% endif %}
Slack App Configuration

NOT RECOMMENDED

This is the way that compatible with the official Crowi,
but not recommended in crowi-plus because it is too complex.

Please use Slack incomming webhooks Configuration instead.

{% if hasSlackWebClientConfig %}
{% if hasSlackToken %}

Crowi and Slack is already connected. You can re-connect to refresh and overwirte the token with your Slack account.

Disconnect from Slack Reconnect to Slack {% else %}

Slack clientId and clientSecret is configured. Now, you can connect with Slack.

Connect to Slack {% endif %}
{% endif %} {# {% if not hasSlackWebClientConfig %} #}

How to configure Slack App?

  1. Register Slack App
    1. Create App from this link, and fill the form out as below:
      App Name
      crowi-plus
      Development Slack Workspace
      Select the workspace you want to notify to.
    2. Save it.
  2. Get App Credentials
    1. Go To "Basic Information" page and make a note "Client ID" and "Client Secret".
  3. Set Redirect URLs
    1. Go to "OAuth & Permissions" page.
    2. Add /admin/notification/slackAuth .
    3. Don't forget to save.
  4. Set Permission Scopes to the App
    1. Go to "OAuth & Permissions" page.
    2. Add "Send messages as crowi-plus"(chat:write:bot).
    3. Don't forget to save.
  5. Create a bot user
    1. Go to "Bot Users" page and add.
  6. Install the app
    1. Go to "Install App to Your Workspace" page and install.
  7. (At Workspace) Approve the app
    1. Go to the management Apps page for the workspace you installed the app and approve crowi-plus.
  8. (At Workspace) Invite the bot to your workspace
    1. Invite the user you created in 4. Add a bot user to the channel you notify to.
  9. (At crowi-plus) Input "clientId" and "clientSecret" and submit on this page.
  10. (At crowi-plus) Click "Connect to Slack" button to start OAuth process.
{# {% endif %} #}
Slack Incoming Webhooks Configuration
Prioritize Incoming Webhook than Slack App

Check this option and crowi-plus use Incoming Webhooks even if Slack App settings are enabled.


How to configure Incoming Webhooks?

  1. (At Workspace) Add a hook
    1. Go to Incoming Webhooks Configuration page.
    2. Choose the default channel to post.
    3. Add.
  2. (At crowi-plus) Set Webhook URL
    1. Input "Webhook URL" and submit on this page.

Default Notification Settings for Patterns

{% for notif in settings %} {% endfor %}
Pattern Channel Operation

Path name of wiki. Pattern expression with * can be used.

Slack channel name. Without #.

{{ notif.pathPattern }} {{ notif.channel }}
{% endblock content_main %} {% block content_footer %} {% endblock content_footer %}