Ticket Orchestrator 用 HaloITSM プラグイン

2.0.0

Added

• 設定パラメータにチケットタイプのサポートを追加しました。
• カスタムステータスフィールドのマッピング機能を追加しました。
• チケットの種類に基づいた動的なキューマッピングのサポートを追加しました。
• エラーログに関する解決策を追加しました。

1.0.0

Added

• 初回リリース。

このプラグインは、HaloITSMのURLを利用して、指定されたURL宛てのPOSTリクエストを介してデータ送信を実行します。

使うAPI一覧

APIのレート制限は、5分間のローリングウィンドウごとに300リクエストです。

認証トークンを生成する

Endpoint: https://{tenant}.haloitsm.com/auth/token
Method:ポスト
Data:

Headers:

Sample Response

{
    "scope": "openid email profile offline_access roles read:tickets edit:tickets all",
    "token_type": "Bearer",
    "access_token": "CfDJ8POGWkxqFLROkzHJBRga06w4J4GVbrS1eqMbBFcdMKAPM6d0Jwh4_itC4LczIyl4m9PXonkWZSf-_r-r-WSxxohaWiY_7bi194Q0X9Ni7q-_0pRKlBqd9HAgM91l***********",
    "expires_in": 32400,
    "refresh_token": "2WRrwD8D30fnTiBOng896VePzfXKYuLYhIwrTVnbyznGJXdg1Vu0wCFlfWK1fOJph_AJoBYTScOkHQHPJal_NotAxJN5chrEqv-UqJXr**************",
    "id_token": "3CT3rLSo6E3urFRo9l4NI8TlviYLNQw36_k_aOAASZKoK-3ZmTKrp5fbjg-v827rih4_NSOAKtI2xmWiDzFU***********"
}

チケットを作成する

Endpoint: https://{tenant}.haloitsm.com/api/Tickets
Method:ポスト
Request Body

[
    {
        "tickettype_id": 1,
        "summary": "This is an example summary",
        "details": "This is an example details message.",
        "category_1": "Accounts & Access>Active Directory Account>Creation",
        "impact": 1,
        "urgency": 2
    }
]

Headers

Sample Response

HTTP/1.1 201  Created
Content-Type: application/json

{
    "id": 3710,
    "dateoccurred": "2026-05-29T09:31:32.8213202Z",
    "summary": "This is an example summary",
    "details": "This is an example details message.",
    "status_id": 1,
    "tickettype_id": 1,
    "sla_id": 1,
    "sla_name": "Incident SLA",
    "priority_id": 2,
    "priority": {
        "id": "ca8f3c6e-110c-e811-8915-b01041c8667a",
        "slaid": 1,
        "priorityid": 2,
        "name": "High",
        "fixtime": 2.0,
        "fixunits": "H",
        "enterslaexcuse": false,
        "responsetime": 1.0,
        "responseunits": "H",
        "ishidden": false,
        "fixendofday": false,
        "responseendofday": false,
        "colour": "#fe9200",
        "catprompt": -1,
        "workdaysoverride": -1,
        "responsestartofday": false,
        "responsestartofdaytime": "00:00:00",
        "startofday": false,
        "startofdaytime": "00:00:00",
        "setfixtostartdate": false,
        "setfixtotargetdate": false,
        "firstresponsetime": 0.0,
        "firstresponseunits": "H"..................
 }

チケットの詳細を見る

Endpoint: https://{tenant}.haloitsm.com/api/ticket/{ticket_id}
Method: GET
Headers

Sample Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": 3710,
    "dateoccurred": "2026-05-29T09:31:32.8213202Z",
    "summary": "This is an example summary",
    "details": "This is an example details message.",
    "status_id": 1,
    "tickettype_id": 1,
    "sla_id": 1,
    "sla_name": "Incident SLA",
    "priority_id": 2,
    "priority": {
        "id": "ca8f3c6e-110c-e811-8915-b01041c8667a",
        "slaid": 1,
        "priorityid": 2,
        "name": "High",
        "fixtime": 2.0,
        "fixunits": "H",
        "enterslaexcuse": false,
        "responsetime": 1.0,
        "responseunits": "H",
        "ishidden": false,
        "fixendofday": false,
        "responseendofday": false,
        "colour": "#fe9200",
        "catprompt": -1,
        "workdaysoverride": -1,
        "responsestartofday": false,
        "responsestartofdaytime": "00:00:00",
        "startofday": false,
        "startofdaytime": "00:00:00",
        "setfixtostartdate": false,
        "setfixtotargetdate": false,
        "firstresponsetime": 0.0,
        "firstresponseunits": "H"....................
  },

チームを獲得する

Endpoint: https://{tenant}.haloitsm.com/api/Team
Method: GET
Headers

Sample Response

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "id": 1,
        "guid": "5c481f56-4369-401c-a608-4b1407f63aff",
        "name": "1st Line Support",
        "sequence": 10,
        "forrequests": true,
        "foropps": false,
        "forprojects": true,
        "ticket_count": 0,
        "department_id": 3,
        "department_name": "Crest data systems - IT",
        "inactive": false,
        "override_column_id": 0,
        "teamphotopath": "",
        "hide_agents_in_tree_if_no_tickets": false,
        "use": "team"
    }
]

チケットの種類を取得する

Endpoint: https://{tenant}.haloitsm.com/api/TicketType

Method: 得る

Headers

Sample Response

HTTP/1.1 200 OK
Content-Type: application/json
[
   {
        "id": 1,
        "guid": "c996841d-096e-43a8-bf1b-b50a47cc60a5",
        "name": "Incident",
        "use": "tickets",
        "sequence": 10,
        "default_sla": 1,
        "group_id": 0,
        "group_name": "",
        "jira_issue_type": "",
        "cancreate": true,
        "agentscanselect": true,
        "itilrequesttype": 1,
        "allow_all_clients": true,
        "allowattachments": true,
        "copyattachmentstochild": false,
        "copyattachmentstorelated": false,
        "is_sprint": false,
        "enduserscanselect": true,
        "anonymouscanselect": true,
        "project_type": 0,
        "kanbanstatuschoice": [
            {
                "id": "1",
                "name": "1"
            },
            {
                "id": "2",
                "name": "2"
            },
            {
                "id": "9",
                "name": "9"
            },
            {
                "id": "27",
                "name": "27"
            },
            {
                "id": "28",
                "name": "28"
            }
        ],
        "kanbanstatuschoice_list": "[\"1\",\"2\",\"9\",\"27\",\"28\"]",
        "default_agent": 1,
        "default_team": "1st Line Support",
        "default_priority": 4,
        "visible": true
    },
    {
        "id": 24,
        "guid": "0a2f855b-0bac-4585-8bdf-9c8da6c7844f",
        "name": "Major Incident",
        "use": "tickets",
        "sequence": 10,
        "default_sla": 4,
        "group_id": 0,................
    }
]

チケットにメモを追加する

Endpoint: https://{tenant}.haloitsm.com/api/Actions

Method: 役職

Headers

Request Body

[
  {
    "ticket_id": 3335, 
    "note_html": "Note added successfully.",
    "outcome": "Note"
  }
]

Sample Response

{
    "ticket_id": 8985,
    "id": 8,
    "outcome": "Note",
    "who": "abci",
    "who_type": 1,
    "who_agentid": 3,
    "datetime": "2026-05-29T09:45:30.686529Z",
    "note": "Note added successfully.",
    "replied_to_ticket_id": 0,
    "replied_to_action_id": 0,
    "created_from_ticket_id": 0,
    "created_from_action_id": 0,
    "action_contract_id": -1,
    "action_travel_contract_id": -1,
    "project_id": 8985,
    "customfields": [
        {
            "id": 223,
            "name": "CFAIKBCreationConfirmation",
            "label": "Would you like to create a Knowledge Base Article using AI?",........
}

チケットステータスを取得する

Endpoint: https://{tenant}.haloitsm.com/api/Status

Method: 得る 

Parameters

Headers 

Sample Response

[
    {
        "id": 2,
        "guid": "00931d19-ee9c-4d47-926c-9b154b66df59",
        "name": "In Progress",
        "shortname": "In Progress",
        "type": 0,
        "sequence": 20,
        "colour": "#0f75b1",
        "slaaction": "removehold",
        "showonquickchange": true,
        "timeuntilloffhold": 0.0,
        "statuschangeto": 0,
        "statuschangetofreq": 0.0,
        "useworkinghours": 0,
        "statusemailfreqdays": 0,
        "statusemailid": -1,
        "statusnochangehours": 0.0,
        "nochangehoursrecurring": false,
        "statusnochangehoursmanager": 0,
        "statusnochangehoursmanagerrecurring": false,
        "statusnochangehourssection": 0.0,
        "statusnochangehourssectionrecurring": false,
        "nochangetemplate": -1,
        "includeinloadbalance": true,
        "useworkinghours_statusnochangehours": 0,
        "useworkinghours_statusnochangehourssection": 0,
        "useworkinghours_statusnochangehoursmanager": 0
    }
]

ユーザー（割り当てられたエージェント）の詳細を取得します

Endpoint: https://{tenant}.haloitsm.com/api/Users

Method: 得る

Parameters

Headers: 

Sample Response

{
    "record_count": 1,
    "users": [
        {
            "id": 26,
            "name": "Jenifier",
            "site_id": 18.0,
            "site_id_int": 18,
            "site_name": "Main",
            "client_name": "data",
            "firstname": "Dev",
            "surname": "Vashi",
            "initials": "DV",
            "emailaddress": "abci@gmail.com",
            "phonenumber_preferred": "",
            "sitephonenumber": "",
            "phonenumber": "",
            "telpref": 0,
            "activedirectory_dn": "",
            "onpremise_activedirectory_dn": "",
            "login": "",
            "inactive": false,
            "colour": "#00ceff",
            "isimportantcontact": false,
            "neversendemails": false,
            "priority_id": 0,
            "linked_agent_id": 3,
            "isserviceaccount": false,
            "isimportantcontact2": false,
            "connectwiseid": 0,
            "autotaskid": -1,
            "sitetimezone": "",
            "use": "user",
            "key": 26,
            "table": 4,
            "client_id": 12,
            "overridepdftemplatequote": -1,
            "is_prospect": false,
            "azureoid": "",
            "lastupdate": "2025-11-06T17:30:24.25"
        }
    ]
}