Zum Hauptinhalt springen

Jira-Vorgang anlegen

Anforderung​

Telefonischer Support findet häufig statt, wird aber nicht immer unmittelbar dokumentiert.
Wenn nach einem erfolgreich angenommenen Anruf automatisch ein Jira-Ticket erzeugt wird, gehen wichtige Informationen nicht verloren und die weitere Bearbeitung kann direkt im Ticketsystem erfolgen.

In diesem Beispiel wird nach einem erfolgreichen eingehenden Anruf auf eine bestimmte Rufnummer automatisch ein Jira-Ticket angelegt. Der Ticket-Betreff lautet dabei: Telefonischer Support für {{callerName}}.

EventBridge Konfiguration​

Wechseln Sie innerhalb der EventBridge Modulkonfiguration auf den Tab und aktivieren dort den Schalter . Im darunter befindlichen Bereich werden anschließend live alle Ereignisse aufgelistet, die von der STARFACE ausgelöst bzw. verarbeitet werden.

Suchen Sie hier das für Ihren Anwendungsfall relevante bzw. passende Event.

Über die Schaltfläche kann das Event direkt in die Event Handling Konfiguration übernommen werden.

Das Event​

Bei erfolgreichen Anrufen entstehen ebenfalls Ruflisteneinträge, auf die mit der EventBridge reagiert werden kann. Das relevante Event ist das NewCallListEntryEvent mit "result": "ANSWERED".

Die gewünschte Zielrufnummer wird in der Regel über calledNumber identifiziert. Der Anrufername steht in callDescription, die Rufnummer des Anrufers in callerNumber.

Beispiel: de.starface.bo.events.NewCallListEntryEvent
{
  "accountId": 5470,
  "requesterAccountId": 5470,
  "callListEntry": {
    "id": "161258",
    "calledNumber": "12345",              // Rufnummer, auf die reagiert werden soll
    "callerNumber": "+497112345678",      // Rufnummer des Anrufers
    "callDescription": "Max Mustermann",  // Name in der Rufliste
    "startTime": 1768202654880,
    "duration": 183,
    "direction": "INBOUND",
    "result": "ANSWERED",
    "voicemailId": "",
    "answeredBy": "max.mustermann",
    "groupId": "5470",
    "callerJabberId": "max.mustermann@example.com",
    "callPartnerAccountId": "4508",
    "calledBack": false
  },
  "accountIdsOfUsers": [
    4508,
    5470
  ]
}

Der passende Event-Handler​

Die entsprechende Konfiguration des Event-Handlers sieht wie folgt aus:

  1. Event: de.starface.bo.events.NewCallListEntryEvent
  2. Event-Daten/Extraktion:
    • calledNumber $.callListEntry.calledNumber
    • result $.callListEntry.result
    • callerName $.callListEntry.callDescription
    • callerNumber $.callListEntry.callerNumber
    • answeredBy $.callListEntry.answeredBy
    • duration $.callListEntry.duration
  3. Bedingung: result == "ANSWERED" && calledNumber == "12345"
  4. Aktion: Webhook / HTTP-POST-Request
    URL: https://your-domain.atlassian.net/rest/api/3/issue
    Header:
    Content-Type: application/json
    Accept: application/json
    Authorization: Basic <base64-aus-email-und-api-token>
    Body:
{
  "fields": {
    "project": {
      "key": "SUP"
    },
    "issuetype": {
      "id": "10001"
    },
    "summary": "Telefonischer Support für {{callerName}}",
    "description": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "Es wurde automatisch nach einem erfolgreichen Telefonat ein Ticket angelegt."
            }
          ]
        },
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "Anrufer: {{callerName}} ({{callerNumber}})"
            }
          ]
        },
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "Gewählte Rufnummer: {{calledNumber}}"
            }
          ]
        },
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "Angenommen von: {{answeredBy}}"
            }
          ]
        },
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "Gesprächsdauer: {{duration}} Sekunden"
            }
          ]
        }
      ]
    }
  }
}
de.starface.bo.events.NewCallListEntryEvent
calledNumber
$.callListEntry.calledNumber
result
$.callListEntry.result
callerName
$.callListEntry.callDescription
callerNumber
$.callListEntry.callerNumber
answeredBy
$.callListEntry.answeredBy
duration
$.callListEntry.duration
result == "ANSWERED" && calledNumber == "12345"
summary: Telefonischer Support für {{callerName}}

Hinweise zu Jira​

Die Felder project.key und issuetype.id müssen an Ihre Jira-Umgebung angepasst werden. Je nach Jira-Projekt können weitere Pflichtfelder erforderlich sein. Ergänzen Sie diese bei Bedarf direkt im JSON-Body.

Wird in Ihrer STARFACE kein Anrufername aufgelöst, kann alternativ auch die Rufnummer im Betreff verwendet werden, beispielsweise mit Telefonischer Support für {{callerNumber}}.

Inhaltsverzeichnis