Zum Hauptinhalt springen
connic
Starte kostenlos

Jira

Lass connic-Agenten auf neue Issues, Änderungen und Kommentare in Jira Cloud reagieren. Die Agenten antworten mit Kommentaren oder legen neue Issues an.

Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
Jira Docs
Publisher
Von connic

Reagiere auf Jira-Issues und Kommentare

Passt ein Issue zu den Events und dem JQL-Filter einer eingehenden Verbindung, startet jeder damit verknüpfte Agent. Eine ausgehende Verbindung mit derselben Connection kommentiert das Ergebnis im Issue.

Events und JQL-Filter wählen
Zur Wahl stehen jira:issue_created, jira:issue_updated und comment_created. Nur Issues, die zum JQL-Filter passen, etwa project = SUP, starten einen Run.
Mehrere Verbindungen pro Site
Beobachte ein Projekt mit der einen und ein anderes mit der zweiten Verbindung, oder nutze eine pro Environment. Jede Verbindung registriert ihren eigenen Webhook.
Keine Schleifen, keine doppelten Runs
Events, die das Konto der Connection selbst auslöst, werden ignoriert, und ein Event, das Jira erneut zustellt, startet keinen zweiten Run.
  1. In Jira passiert etwas

    Jemand legt ein Issue an, ändert eines oder schreibt einen Kommentar.

    jira:issue_created
  2. connic prüft und bestätigt das Event

    connic prüft die Signatur mit dem Secret des Webhooks und antwortet Jira sofort.

    X-Hub-Signature
  3. Verknüpfte Agenten starten

    Der Run bekommt das Event, Key und Projekt des Issues, die Zusammenfassung, die Beschreibung oder den Kommentar, einen Link und den Autor.

    comment_created
  4. Die Antwort landet als Kommentar

    Eine ausgehende Verbindung mit derselben Connection kommentiert im Issue, aus dem der Run stammt.

Verbinde deine Jira-Site mit einem API-Token

Eine Jira-Connection enthält die URL deiner Site, die E-Mail-Adresse eines Atlassian-Kontos und dessen API-Token. Eine eingehende Verbindung wählt Events und einen JQL-Filter, und connic registriert den Webhook auf deiner Site.

Dein Konto, dein Token
Kommentare und Issues schreibt connic als das Atlassian-Konto der Connection. Erstelle das API-Token ohne Scopes. Unterstützt wird nur Jira Cloud.
Webhook ohne Handarbeit
Beim Speichern einer eingehenden Verbindung registriert connic einen Webhook für ihre Events und ihren JQL-Filter, signiert mit einem generierten Secret. Löschst du die Verbindung, entfernt connic auch den Webhook. Dafür braucht das Konto die globale Berechtigung Administer Jira.
Token rechtzeitig ersetzen
API-Tokens von Atlassian laufen nach spätestens 365 Tagen ab. Ersetze das Token vorher in der Connection. Alle Verbindungen dieser Connection übernehmen das neue Token.
connectors/jira-support.yaml
type: jira
mode: inbound
connection: acme-jira
config:
  events:
    - jira:issue_created
    - comment_created
  jql: project = SUP
agents:
  - support-triage

Kommentiere Issues oder lege neue an

Eine ausgehende Jira-Verbindung postet den Output des Agenten als reinen Text, egal ob der Run auf ein Jira-Issue antwortet oder von einer anderen Verbindung oder einem Zeitplan kommt.

Routing
Ein issue_key im Output hat Vorrang. Ohne ihn kommentiert ein Run, den ein Jira-Issue über dieselbe Connection gestartet hat, genau dort. Jeder andere Run legt ein Issue im Projekt der Verbindung an, als Task, solange du keinen anderen Issue-Typ wählst.
Drei Wege zu senden
Sende nach jedem abgeschlossenen Run, gib dem Modell ein Tool oder rufe send_connector aus Middleware auf, wenn dein Code entscheidet.
Rate Limits inklusive
Drosselt Jira die Anfrage für einen Kommentar oder ein Issue, etwa wegen der Schreiblimits pro Issue, wartet connic und sendet erneut.
output.json
{
  "summary": "EUR totals are rounded twice at checkout",
  "body": "Orders in EUR are one cent off since release 2.14."
}
connector-payload.json
{
  "body": "Reproduced on staging: the total is rounded twice.",
  "issue_key": "SUP-142"
}

Wo Jira passt

Wähle ein Szenario und sieh, was beim Agenten ankommt und was er in Jira postet.

Ein Kunde meldet ein Problem im Support-Projekt, und der Agent fragt nach fehlenden Angaben und nennt den wahrscheinlich betroffenen Bereich.

Neues Issue
Inbound Jira
support-triage
Kommentar im Issue
jira-payload.json
{
  "event": "jira:issue_created",
  "issue_key": "SUP-418",
  "project": "SUP",
  "summary": "Refund button does nothing",
  "text": "Clicking Refund on an order shows no error and no refund.",
  "url": "https://acme.atlassian.net/browse/SUP-418",
  "author": "Jana Weber"
}
output.json
{
  "body": "Likely the refunds service. Which order ID and browser?"
}

Jemand stellt in einem Kommentar eine Frage, und der Agent antwortet im selben Issue.

Neuer Kommentar
Inbound Jira
issue-assistant
Antwort im Issue
jira-payload.json
{
  "event": "comment_created",
  "issue_key": "SUP-402",
  "project": "SUP",
  "summary": "CSV export times out",
  "text": "Still failing after the update. Is there a workaround?",
  "url": "https://acme.atlassian.net/browse/SUP-402?focusedCommentId=10231",
  "author": "Sam Lee"
}
output.json
{
  "body": "Until the fix ships, export one month at a time."
}

Dein Helpdesk sendet einen Bug-Report, und der Agent legt daraus ein Jira-Issue an.

Helpdesk
Inbound Webhook
bug-reporter
Neues Issue in ENG
ticket.json
{
  "ticket_id": "T-20931",
  "customer_id": "C-1042",
  "subject": "Invoice PDF shows the wrong VAT rate",
  "message": "Since Monday our invoices show 16% instead of 19%."
}
output.json
{
  "summary": "Invoice PDF uses 16% VAT instead of 19%",
  "body": "Reported in T-20931: invoices since Monday use 16%."
}

Dein Monitoring meldet einen neuen Fehler, und der Agent legt ein Issue mit allem an, was er darüber weiß.

Error-Monitoring
Inbound Webhook
error-triage
Issue zum Fehler
alert.json
{
  "service": "checkout-api",
  "error": "Order ord_88412 has no currency",
  "first_seen": "2026-11-16T09:12:04Z",
  "events_last_hour": 214
}
output.json
{
  "summary": "checkout-api: orders without a currency fail",
  "body": "214 errors in the last hour, first seen at 09:12 UTC."
}

FAQ zu Jira

Mit Jira-Cloud-Sites wie https://acme.atlassian.net. Jira Data Center und Jira Server werden nicht unterstützt.

Mit dem Atlassian-Konto, dessen E-Mail-Adresse und API-Token du in der Jira-Connection speicherst. Kommentare und neue Issues erscheinen unter diesem Konto. Für eingehende Verbindungen braucht das Konto die globale Berechtigung Administer Jira, damit connic Webhooks registrieren kann.

Ja. API-Tokens von Atlassian laufen nach spätestens 365 Tagen ab. Erstelle vorher ein neues Token ohne Scopes und ersetze damit das alte in der Connection.

Nein. Events, die das Konto der Connection selbst auslöst, etwa eigene Kommentare und Issues, werden ignoriert. So startet sich ein Agent nicht selbst erneut.

Ja, mit type: jira und dem Namen einer Jira-Connection. Site-URL, E-Mail-Adresse und API-Token bleiben in der Connection und gehören nie in die Datei.