growing hard days.

docomo Developer supportの雑談対話APIから自然対話APIへ移行しました

2018/08/03 2019/03/23

LINEやSlackのbotで重宝していた、雑談対話APIが終了する、とのことですので、後継の自然対話APIへ移行しました。
(2018年8月時点の情報です。2019年6月に自然対話APIサービスは終了します。)

目次

API利用申請

docomo Developer support のマイページにログインして、新たにAPI利用申請を行いました。
「自然対話：雑談対話」を選択しました。

ユーザー登録

API経由でユーザー登録をして、アプリケーションIDを取得しなければなりません。

初回のみですので、PostmanからPOSTして取得しました。

リクエスト情報

リクエストURL

https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/registration

リクエストヘッダ

Content-Type : application/json;charset=UTF-8

パラメータ

APIKEY : (API利用申請により発行されたAPI key)

リクエストボディ

{
    "botId": "Chatting",
    "appKind": "Smart Phone"
}

1

2

3

4

5

{

"botId": "Chatting",

"appKind": "Smart Phone"

}

botIdのChattingは固定。
appKindは任意ですが、サンプルのままにしました。

レスポンス

{
    "appId": (アプリケーションID)
}

1

2

3

4

{

"appId": (アプリケーションID)

}

実装例

Pythonで実装して、API Gateway + Lambdaで動かす想定の実装例です。

import requests, json

docom_app_id = '(アプリケーションID)'
docomo_api_key = '(API key)'
docomo_endpoint = 'https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/dialogue?APIKEY={api_key}'.format(
    api_key=docomo_api_key
)

headers = {
    'Content-type': 'application/json;charset=UTF-8'
}

payload = {
    "language": "ja-JP",
    "botId": "Chatting",
    "appId": docom_app_id,
    "voiceText": (発信するテキスト),
    "appRecvTime": "2018-08-02 22:44:22",
    "appSendTime": datetime.now().strftime("%Y-%m-%d %H:%M:%S")
}

response = requests.post(
　　　　docomo_endpoint, 
　　　　data=json.dumps(payload), 
　　　　headers=headers
)

data = response.json()
return data['systemText']['expression']

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

import requests, json

docom_app_id = '(アプリケーションID)'

docomo_api_key = '(API key)'

docomo_endpoint = 'https://api.apigw.smt.docomo.ne.jp/naturalChatting/v1/dialogue?APIKEY={api_key}'.format(

api_key=docomo_api_key

)

headers = {

'Content-type': 'application/json;charset=UTF-8'

}

payload = {

"language": "ja-JP",

"botId": "Chatting",

"appId": docom_app_id,

"voiceText": (発信するテキスト),

"appRecvTime": "2018-08-02 22:44:22",

"appSendTime": datetime.now().strftime("%Y-%m-%d %H:%M:%S")

}

response = requests.post(

　　　　docomo_endpoint,

　　　　data=json.dumps(payload),

　　　　headers=headers

)

data = response.json()

return data['systemText']['expression']

無事、動きました。

雑談対話以外にも、FAQ、意図解釈、知識検索、キャラクタ変換？などなどあるみたいなので、今後試してみようと思います。
docomoさん、いつもありがとう。

最後までお読みいただきましてありがとうございました！

「AWS認定資格試験テキスト＆問題集　AWS認定ソリューションアーキテクト - プロフェッショナル改訂第2版」という本を書きました。

「AWS認定資格試験テキスト AWS認定クラウドプラクティショナー改訂第3版」という本を書きました。

「ポケットスタディ AWS認定デベロッパーアソシエイト［DVA-C02対応］」という本を書きました。

「要点整理から攻略するAWS認定ソリューションアーキテクト-アソシエイト」という本を書きました。

「AWSではじめるLinux入門ガイド」という本を書きました。

開発ベンダー5年、ユーザ企業システム部門通算9年、ITインストラクター5年目でプロトタイプビルダーもやりだしたSoftware Engineerです。
質問はコメントかSNSなどからお気軽にどうぞ。
出来る限りなるべく答えます。

このブログの内容/発言の一切は個人の見解であり、所属する組織とは関係ありません。
このブログは経験したことなどの共有を目的としており、手順や結果などを保証するものではありません。
ご参考にされる際は、読者様自身のご判断にてご対応をお願いいたします。

また、勉強会やイベントのレポートは自分が気になったことをメモしたり、聞いて思ったことを書いていますので、登壇者の意見や発表内容ではありません。

- API, Python api, docomo, python

Tweet

関連記事

: 「API Meetup Tokyo #29 ニッポンのAPIエコノミー最前線〜国産APIが社会を変える〜」に参加しました

API Meetup Tokyoに来ました〜会場はおしゃれなDEJIMAさんで …

: 個人のGoogleカレンダーの予定をPythonで取得する

Google Calendar Twilio ReminderのGoogleカレ …

: Pepper 開発ワークショップ初級~中級~番外編に1日で一気に参加した

Pepperの開発方法が知りたかったので、Pepperアトリエ秋葉原 with …

: Apple Silicon M1 MacBook ProにJupyter Notebookをインストールしました

Python – Jupyter NotebookをMac M1 搭 …

: Slackでチームを作成してbotから投稿出来るようにする

Slackで新しいチームを作成して、botが投稿出来るように設定します。 ※20 …

: Linux Mint 17 MATE 64bit にIPython Notebookをインストールする

今日行く勉強会でIPython Notebookの環境が必要なため、手持ちのLi …

: Redmine REST APIを操作するpython_redmineを試してみた

Redmine のGUIの登録が面倒なのでコマンドで登録、更新、時間の記録が出来 …

: IPython Notebookで梅田のラーメン屋さんの統計情報を抽出するというハンズオンに行ってきました

IPython Notebookで梅田のラーメン屋さんの情報をWebスクレイピン …

: SQLAlchemyのModelクラスをMySQLから自動生成する

SQLAlchemyのMySQLモデルを書くのが面倒で、きっと何かツールがあるの …

: 「streamlit勉強会」に参加しました

streamlitってなんだろう？と思いながら参加しまししました。 fin-p …

PREV: 2,999円の体重・体組成計を買ってみたら意外に良かった
NEXT: 再会の日 ~re:Union 2018 Osaka by JAWS-UG~