ansible/awx

Integrated notifications with Microsoft Teams

Open

#885 opened on Dec 24, 2017

View on GitHub
 (27 comments) (23 reactions) (0 assignees)Python (13,071 stars) (3,333 forks)batch import
Hacktoberfestcomponent:apigood first issuehelp wantedtype:enhancement

Description

ISSUE TYPE
  • Feature Idea
COMPONENT NAME
  • UI
SUMMARY

I'm trying to setup webhooks notifications with Microsoft Teams, but i'm getting errors. Maybe a misconfiguration, but there is no documentation about how to do it.

Maybe someone already achieved this by webhooks, but it would be great to add an option to do it like slack.

ENVIRONMENT
  • AWX version: 1.0.2.303
  • AWX install method: docker on linux
  • Ansible version: 2.4.2.0
  • Operating System: Ubuntu
  • Web Browser: Firefox
STEPS TO REPRODUCE

as described here: https://docs.ansible.com/ansible-tower/latest/html/userguide/notifications.html#webhook

and here: https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/connectors

EXPECTED RESULTS

Select notification type Microsoft Teams, and configure the options. Or a documentation of how to do it with webhook option.

ACTUAL RESULTS

With webhook I'm receiving this error. ERROR awx.main.notifications.webhook_backend Error sending notification webhook: Summary or Text is required.

ADDITIONAL INFORMATION

Contributor guide

Tech stack
pythonrest api
Domain
backendapidocumentation
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
AWX notification systemMicrosoft Teams webhooksPythonREST API
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60
Research direction
Examine the existing Slack notification implementation in AWX (likely in awx/main/notifications/) to understand the pattern. Look at the webhook backend (awx/main/notifications/webhook backend.py) to see why the 'Summary or Text is required' error occurs. Design a new Teams notification backend following the Slack approach, and add UI options in the notification configuration forms. Test the integration with a Microsoft Teams webhook URL and update documentation with setup steps. Refer to the Microsoft Teams connectors documentation for payload format.