osTicket webhook integration to send notifications to MS Teams when new ticket is issued or created

License: MIT License

PHP 100.00%

osticket-plugin teams microsoft-teams osticket

osticket-microsoft-teams-plugin's Introduction

osTicket-microsoft-teams

An plugin for osTicket which posts notifications to a Microsoft Teams channel.

Originally forked from: https://github.com/clonemeagain/osticket-slack.

Info

This plugin uses CURL and was designed/tested with osTicket-1.10.1 and updated for use with osTicket-1.17.2 Note This has also been updated to fix the first message being repeated for each notification. It should now show new messages as they come in.

Requirements

php_curl
A Office 365 account

Install

Clone this repo or download the zip file and place the contents into your include/plugins folder.
Now the plugin needs to be enabled & configured, so login to osTicket, select "Admin Panel" then "Manage -> Plugins" you should be seeing the list of currently installed plugins.
Click on MS Teams Notifier and paste your Teams Endpoint URL into the box (MS Teams setup instructions below).
Click Save Changes! (If you get an error about curl, you will need to install the Curl module for PHP).
After that, go back to the list of plugins and tick the checkbox next to "MS Teams Notifier" and select the "Enable" button.

MS Teams Setup:

Open MS Teams, navigate to channel and open COnnectors from elipsoids (...) menu
Select Incoming Webhook and configure
Choose webhook name and optionally change associated image
Click Create
Scroll down and copy the Webhook URL entirely, paste this into the osTicket -> Admin -> Plugin -> Teams config admin screen.

The channel you select will receive an event notice, like:

Ivan Pavlovic has set up a connection to Incoming Webhook so group members will be notified for this configuration with name osTicket

Test!

Create a ticket!

Notes, Replies from Agents and System messages shouldn't appear, usernames are links to the user's page in osTicket, the Ticket subject is a link to the ticket, as is the ticket ID.

osticket-microsoft-teams-plugin's People

Contributors

Stargazers

Watchers

Forkers

gauravshres fngaserin edozier antoniovelasquez gerundt raithsphere jcornwell-river gardium-technologies gschechter totalgrifflock gadgrandez tobilobaajibola brothers-morrison cci-help dhimelick perryk milestone-financial-engineers codewow graphichealer

osticket-microsoft-teams-plugin's Issues

Compatibility with osTicket v1.16 (PHP 8.0)

Hi there. First of all thank you for your excellent plugin.

We have updated our helpdesk to the latest version running on PHP8.0 and this plugin no longer works. Can you please update to work with new version?

No phar file to upload

hi - i tried to install this plugin by downloading the contents as zip file and uploaded either by individual files to /plugins folder or by the zip file renamed as .phar file in to this directory.
but none works. It doesnt show in the list of plugins in my OSticket admin panel.

How dio i bring in the phar file to this plugins directory?

add message

Is there a way for the message on teams to contain the contents of the tickets? instead of just the name if the issue and the email?

Error 500 on creating a new ticket

I've just added the plugin, and after configuring the Webhook URL on the instance, I get the error 500 when creating new tickets. They are created, but no notification is sent to teams.

Environment details:

osTicket version 1.17.3
webserver Apache 2.4.52 (Ubuntu)
MySQL 10.6.12
PHP 8.1.18

Task Notification

The notification system gets messed up when the task is closed. This distinction needs to be included in the code.

Notification per Department

Hi First thing first, this plugin is really great, i just installed and tested it, But is there a way to add to have the notification per department? If a ticket is been assign to a certain department a notification is sent to the teams on that department, rather than it will only trigger the notification for new ticket.

Each department will have its own webhook url generated on the each group in the MS Teams

Wrong link in Teams message 'View in osTicket'

Hi there,

Thanks for creating this plugin I ran into an issue however. As you can see in the image below I highlighted. The double slash makes the link broken and also we renamed the directory instead of the default 'osticket'. I tried modifying the code but not sure where to start..

Problemas after update to new url

Teams was imposing that a new Webhook URL be generated, as some security improvements were made. However, after generating and inserting the plugin, the notifications are no longer working.

Webhook URL for Microsoft Teams Plugin Too Long

When attempting to configure the plugin, I encounter an issue where the webhook URL provided by Microsoft Teams exceeds the character limit allowed by the plugin's settings field in osTicket. I can save but it looks like the URL is shorten and does not take in the whole URL.

Steps to Reproduce

Obtain the webhook URL from Microsoft Teams.
Go to the osTicket admin panel and navigate to the plugin's configuration page.
Paste the webhook URL into the corresponding field.

Is there a known workaround for this issue? Has anyone modified the plugin to support longer URLs, or is there a way to shorten the Microsoft Teams webhook URL that will still allow it to function correctly?

Environment

osTicket Version: v1.14.3
Image: rlieback/osticket

data-tech-international / osticket-microsoft-teams-plugin Goto Github PK