GitHub Helpdesk Integration for Frappe

Connect GitHub issues, pull requests, comments, commits, and developer activity directly with Frappe Helpdesk.

This app helps support and development teams work from one shared flow by automatically creating Helpdesk tickets from GitHub issues, syncing comments between GitHub and Frappe, and keeping ticket status, priority, assignments, and issue metadata aligned.

Features

GitHub → Helpdesk (inbound)

• Issues and pull requests become HD Tickets, governed by a configurable creation rule: Bug Label Only, Configured Labels, All Opened Issues, or Disabled. PR ticket creation is opt-in, globally or per repository.

• Issue, PR review and commit comments are appended to the linked ticket as Communication records.

• GitHub markdown is rendered and sanitised; inline images are downloaded and stored as private Frappe files on the ticket.

• GitHub assignees are mapped to Helpdesk agents and assigned via ToDo.

• Labels, organization issue types, repositories, installations and organization members are synced into their own DocTypes so mappings reference real GitHub data instead of free text.

• Push events ingest commits and roll up into per-day, per-repo, per-author activity.

Helpdesk → GitHub (outbound)

• Agent replies (Communication, Sent) and Comments-tab entries (HD Ticket Comment) post back as GitHub comments.

• Ticket status → issue open/closed, priority → labels, ticket type → issue type, subject → issue title, assignment → GitHub assignees.

• Description → issue body is off by default (see Configuration), because it overwrites the reporter's original text.

• Every outbound call goes through the BMA GitHub Outbox with an idempotency key, bounded retries, terminal-vs-transient error classification, and Retry-After-aware backoff.

Operations

• Webhook deliveries are HMAC-SHA256 verified and de-duplicated by X-GitHub-Delivery; every delivery is logged in BMA GitHub Webhook Event with retry from the desk.

• Loop prevention: an outbound footer marker, an inbound-sync flag, and a comment-sync ledger independently stop echo syncs.

• Master enable switch, health metrics, and daily retention sweeps for webhook events and commit payloads.

• 24 DocTypes and 7 query reports for agent and repository activity.

Requirements

• Frappe Framework v16 (frappe>=16.0.0,<17.0.0)

• Frappe Helpdesk (declared as a required app; pulls in telephony)

• Python 3.14 — Frappe v16 pins >=3.14,<3.15 and uses PEP 695 syntax, so earlier interpreters cannot build it

• A GitHub App you control, installed on the target organization or repositories

• A publicly reachable HTTPS URL for the webhook endpoint

Security & Reliability

The integration uses a GitHub App installation model with signed webhook verification, idempotent event handling, short-lived installation tokens, and configurable repository and organization access rules.

Ideal for teams using Frappe Helpdesk and GitHub who want a reliable bridge between customer support, issue tracking, and development activity.