カスタムAPI呼び出し

このピースでできること

  • CallConnect APIの任意のエンドポイントに対してカスタムAPIコールを実行します。
  • 標準のピースにない操作もAPIを直接呼び出すことで実現できます。認証ヘッダーは接続情報から自動的に付与されます。

CallConnect の接続方法

workrun と CallConnect を接続するには、CallConnect の API トークン が必要です。

ステップ 1:API トークンを取得する

  1. CallConnect の管理画面にログインします。
  1. メニューから《管理》→連携》→CallConnect API》 を遷ります。
  1. APIトークンの発行》 ボタンをクリックしてトークンを発行し、表示されたトークンをコピーします。

ステップ 2:workrun に接続を追加する

  1. workrun で CallConnect のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. APIトークン》 フィールドに、ステップ 1 でコピーしたトークンを貼り付けます。
  1. 保存》 をクリックして接続を完了します。

ピースの設定項目

1. URL(必須)

  • 呼び出すAPIのURLを入力します。完全なURLまたはベースURLからの相対パスを指定できます。

2. メソッド(必須)

  • HTTPメソッドを選択します(GET / POST / PUT / DELETE など)。

3. ヘッダー(任意)

  • 追加のリクエストヘッダーをJSON形式で入力します。認証ヘッダー(X-Callconnect-Token)は接続から自動的に付与されるため、ここでの指定は不要です。

4. クエリパラメータ(任意)

  • クエリパラメータをJSON形式のキーと値で入力します。

5. ボディタイプ(任意)

  • リクエストボディの形式を選択します(JSON / Raw / Form-Data / None)。

6. ボディ(任意)

  • リクエストボディの内容を入力します。ボディタイプに合わせた形式で入力してください。

7. 失敗時にエラーにしない(任意)

  • 有効にすると、APIがエラーを返してもフローの実行を続行します。デフォルトはオフです。