NB Desk : Slack Integration with Frappe HelpDesk

NB DESK

Introducing NB Desk—a powerful feature designed to enhance your experience with Frappe HelpDesk through Slack Integration.

With this new app, users can seamlessly create tickets directly from their Slack Channel. Moreover, it offers the convenience of individual threads for each ticket, facilitating two-way communication effortlessly.

Slack Integration

NOTE: This Integration is specifically for private channels for frappe helpdesk.*

Key Features

• After installation of NB Desk app, user can send Notification to the Slack Channel
• Using /Ticket command, users can create tickets directly from Slack, seamlessly integrating with their Frappe site.
• User can reply to specific threads in Slack and can view all responses seamlessly reflected in their Frappe desk.
• Replies from the Frappe desk are also mirrored within Slack threads.

Installation

Get the app

bench get-app nb_desk {github_url} --branch version-14

Install the NB Desk app

  bench --site{site_name} Install-app nb_desk

Create a New Slack app

Go to App Manifest :-

Copy this and paste it into the app manifest section of your app.

{
    "display_information": {
        "name": "Frappe Integrator",
        "description": "An app to Integrate Frappe with Slack",
        "background_color": "#464e63"
    },
    "features": {
        "bot_user": {
            "display_name": "FrappeDesk",
            "always_online": true
        },
        "slash_commands": [
            {
                "command": "/ticket",
                "url": "{Your live site link}/api/method/nb_desk.api.slack_event.create_slack_ticket",
                "description": "Please Write about your issue",
                "usage_hint": "Use Subject key for writting the subject and desc for description",
                "should_escape": false
            }
        ]
    },
    "oauth_config": {
        "scopes": {
            "user": [
                "groups:history",
                "groups:read"
            ],
            "bot": [
                "calls:read",
                "channels:history",
                "chat:write",
                "conversations.connect:read",
                "conversations.connect:write",
                "incoming-webhook",
                "metadata.message:read",
                "users:read",
                "users:read.email",
                "groups:history",
                "groups:read",
                "commands"
            ]
        }
    },
    "settings": {
        "event_subscriptions": {
            "request_url": "{Your live site link}/api/method/nb_desk.api.slack_event.reply_creation",
            "user_events": [
                "message.groups"
            ]
        },
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
    }
}

Note: Change the live site url

Now, Install the app to your workspace.

After installing the app, you will get a bot token in the OAuth & Permission section and Webhook url at Incoming webhook section. Put it in the Slack Webhook url.

*Fill all the Fields like Webhook URL, Slack token and the Channel Name where you have installed the slack app, Set these details to default and save your settings.*

Now, you can Create Notification against communication by setting the trigger to new.