ServiceNowで受信(Inbound)メールでIncidentを起票する

Version: Kingston

前回の記事ではREST APIを利用してServiceNowにIncidentを起票してみましたが本記事ではEmailでIncidentを起票してみます

[REST API ExplorerのコードサンプルでServiceNowインスタンスにHTTP Request(POST)を飛ばしてIncidentを起票する]
https://qiita.com/20_percent_cooler/items/ce23175f25c87bb08ea6

# 作るもの
ServiceNowのインスタンスで受信(Inbound)メールの内容で
<img width="461" alt="mailpng.png" src="https://qiita-image-store.s3.amazonaws.com/0/193272/60b3f6a9-2882-7511-38c6-1fb0ea79fb07.png">
Incidentを起票します
<img width="1035" alt="FireShot Screen Capture #077 - &#x27;Incidents I ぽんぽこシステム&#x27; - -now_com_nav_to_do_uri=_incident_list_do_sysparm_userpref_module=b55b4ab0c0a80.png" src="https://qiita-image-store.s3.amazonaws.com/0/193272/7468ddfc-e77d-8629-6a36-bdee7776ca65.png">
# メールを受信する設定
Filter navigatorに"email properties"と入力してメニューを絞り込むなどして[System Propertiy] - [Email Properties]を表示します
![FireShot Screen Capture #070 - 'Email Properties I ぽんぽこシステム' - -now_com_nav_to_do_uri=_email_properties_do.png](https://qiita-image-store.s3.amazonaws.com/0/193272/aaa235c2-3a9e-ac7c-b902-241c2d372288.png)
[Email Properties]の"Inbound Email Configuration"のEmail receiving enabledをチェックして有効にして
![FireShot Screen Capture #071 - 'Email Properties I ぽんぽこシステム' - -now_com_nav_to_do_uri=_email_properties_do.png](https://qiita-image-store.s3.amazonaws.com/0/193272/4da23f73-6609-606a-a439-549c48426d26.png)
[Save]します
![FireShot Screen Capture #072 - 'Email Properties I ぽんぽこシステム' - -now_com_nav_to_do_uri=_email_properties_do.png](https://qiita-image-store.s3.amazonaws.com/0/193272/6f828fb2-b5b3-054d-b02a-a23f9b407c0d.png)
# 受信(Inbound)メールでのActionの確認
※何も編集していなければ以下の設定になっていると思います
Filter navigatorに"inbound"などと入力し[System Policy] - [Inbound Actions]を選択して"Create Incident"のActionが有効(Activeがtrue)になっていることを確認します
![FireShot Screen Capture #073 - 'Inbound Email Actions I ぽんぽこシステム' - -now_com_nav_to_do_uri=_sysevent_in_email_action_list_do_sysparm_u.png](https://qiita-image-store.s3.amazonaws.com/0/193272/9b0ee8c8-a9b6-b3e7-7481-93efc3bf6c3d.png)
"Create Incident"をクリックしてTargetがIncidentになっていてWhen to runに特に設定がないことを確認しますこの状態だと無条件でメールを受信したときに実行されます特定の件名のときにだけ実行したいときなどはConditionでSubjectがcontainで特定の件名が含む文字列を指定するとかで実現できます
![FireShot Screen Capture #074 - 'Create Incident I Inbound Email Actions I ぽんぽこシステム' - -now_com_nav_to_do_uri=_sysevent_in_email_action.png](https://qiita-image-store.s3.amazonaws.com/0/193272/13eddcbe-aefc-58c6-fdc0-dcebd561440b.png)
Actionが以下の内容になっていることを確認します
![FireShot Screen Capture #075 - 'Create Incident I Inbound Email Actions I ぽんぽこシステム' - -now_com_nav_to_do_uri=_sysevent_in_email_action.png](https://qiita-image-store.s3.amazonaws.com/0/193272/f34bc74d-e712-0f86-c1bd-5c0df14917b7.png)
Scriptの中ではIncidentのどの項目に何の値を設定するかなどをが記述されている様です例えば5行目はメールの件名をIncidentのShort Descriptionに設定しています

>current.short_description = email.subject;

Scriptを編集するにはオリジナルをそのまま編集して保存しても構いませんがオリジナルを残して置きたい場合はNameを変更して画面上部の灰色部分で右クリックして表示されるメニューからInsertかInsert and Stayを選択することで別名で同じ内容のActionが追加されるのでそちらを編集してみます
![FireShot Screen Capture #078 - 'Create Incident I Inbound Email Actions I ぽんぽこシステム' - -now_com_nav_to_do_uri=_sysevent_in_email_action.png](https://qiita-image-store.s3.amazonaws.com/0/193272/fbc07d2f-63b2-c0a8-179a-86060ad16173.png)
# メール受信でのIncident起票の確認
## メール送信
インスタンス名@service-now.comにメールを送信しますdeveloperインスタンスだとdev*****@service-now.comになっているはずです
[Email accounts | ServiceNow Docs]
https://docs.servicenow.com/bundle/london-servicenow-platform/page/administer/notification/concept/c_EmailAccounts.html

> By default, the ServiceNow POP3 server provides each instance with its own mailbox at the address instance@service-now.com. 

最近お気に入りのprotonmailからメールを送信してみます
<img width="461" alt="mailpng.png" src="https://qiita-image-store.s3.amazonaws.com/0/193272/fd902a34-1105-64b0-a720-4a29e5f0fd02.png">
## メール受信
[System Mailboxes] - [Received]でメールが受信出来たことを確認します
<img width="1035" alt="FireShot Screen Capture #076 - &#x27;Emails [Inbox view] I ぽんぽこシステム&#x27; - -now_com_nav_to_do_uri=_sys_email_list_do_sysparm_userpref_module=92.png" src="https://qiita-image-store.s3.amazonaws.com/0/193272/9edcc96f-4d8e-9675-49de-31bbbc98f279.png">
[Incident] - [All]でIncidentが起票出来たことが確認出来ました
<img width="1035" alt="FireShot Screen Capture #077 - &#x27;Incidents I ぽんぽこシステム&#x27; - -now_com_nav_to_do_uri=_incident_list_do_sysparm_userpref_module=b55b4ab0c0a80.png" src="https://qiita-image-store.s3.amazonaws.com/0/193272/5ec35ddc-3490-92cf-79e3-57f67e5cc02b.png">
※ヘンなメールが届いても困るのでdeveloperインスタンスのEmail receiving enabledは普段は無効にして置こうと思います