Closed15

zendeskアプリ開発

Takaaki KakeiTakaaki Kakei

(共通)ZCLIのセットアップ

インストール

npm install @zendesk/zcli -g

確認

zcli help
Takaaki KakeiTakaaki Kakei

認証関連のコマンド

  • リスト
zcli profiles:list
  • 認証情報削除
zcli logout
  • 特定サブドメインにおける認証情報削除
zcli profiles:remove {subdomain}
  • サブドメインのスイッチ
zcli profiles:use {subdomain}
Takaaki KakeiTakaaki Kakei

プロジェクト作成

zcli apps:new
Enter a directory name to save the new app (will create the dir if it does not exist): hello_world_zcli
Enter this app authors name: kakei.takaaki               
Enter this app authors email: kakei.takaaki@example.com
Enter this app authors website (optional): 
Enter a name for this new app: hello_world_zcli
Takaaki KakeiTakaaki Kakei

ローカルで起動したアプリをZendesk環境にアタッチする方法

ローカルサーバーを起動した状態で以下のURLにブラウザでアクセスする

https://{subdomain}.zendesk.com/agent/tickets/{123}?zcli_apps=true

キャッシュの影響を受けないために、シークレット ウィンドウで開くの推奨。

Takaaki KakeiTakaaki Kakei

デプロイ

zcli apps:create

自動でzcli.apps.config.jsonが作成され、app_idも払い出される

Successfully installed app: useful_links with app_id: 1234567

Takaaki KakeiTakaaki Kakei

manifest.jsonのnameには、-を使わない方が良さそう。アプリインストール時に怒られる模様。

Takaaki KakeiTakaaki Kakei

zcli.apps.config.jsonはサブドメインごとに必要そう
ステージごとにフォルダを分けた

% tree                                                                                                                                                                                                                                                                                                             2023/05/08 13:22:11 
.
├── README.md
├── dev
│   ├── LICENSE
│   ├── assets
│   │   ├── iframe.html
│   │   ├── logo-small.png
│   │   ├── logo.png
│   │   ├── logo.svg
│   │   └── screenshots-image.png
│   ├── manifest.json
│   ├── tmp
│   ├── translations
│   │   └── en.json
│   └── zcli.apps.config.json
└── prod
    ├── LICENSE
    ├── assets
    │   ├── iframe.html
    │   ├── logo-small.png
    │   ├── logo.png
    │   ├── logo.svg
    │   └── screenshots-image.png
    ├── manifest.json
    ├── tmp
    ├── translations
    │   └── en.json
    └── zcli.apps.config.json
このスクラップは2023/05/08にクローズされました