Zendeskでサポートチケットを作成する

サポートチケット作成アクションは、Zendeskにサポートチケットを追加します。このアクションは内部的に チケット作成 APIエンドポイントを呼び出します。呼び出しが失敗した場合、自動的に再試行します。

formspree.json ファイルにサポートチケット作成アクションを追加することは、Formspreeダッシュボードで Zendesk プラグインを追加することと同じ効果があります。詳細については、Zendesk プラグインのヘルプ記事をご覧ください。

APIトークンを取得する

まず、Zendeskアカウントにアクセスして、APIトークンを取得または作成します。
これは Admin->Channels->API から確認できます。Add API Token ボタンをクリックしてトークンを作成します。コピーしておいてください。formspree.json の設定で必要になります。

Formspree.json の設定

キー	型	説明
app	String	zendesk でなければなりません
type	String	createSupportTicket でなければなりません
subdomain	String	Zendeskのサブドメイン（.zendesk.com を除く）
zendeskEmail	String	Zendeskサブドメインの有効なアクセス用メールアドレス
apiToken	String	APIキー（$env変数参照である必要があります。必須）

例

{
  "forms": {
    "support": {
      "name": "Support Form",
      "actions": [
        {
          "app": "zendesk",
          "type": "createSupportTicket",
          "subdomain": "formspree",
          "zendeskEmail": "zendesk@formspree.io",
          "apiToken": "$ZENDESK_APITOKEN"
        }
      ]
    }
  }
}

バリデーションルール

サポートチケット作成アクションは、以下のバリデーションルールを暗黙的に追加します：

フィールド	バリデーションルール
email	型は email