Skip to main content

​
Typeform

ShanoneのTypeform連携は、フォームの作成・更新、回答の読み取り・削除、テーマ/画像の管理、ワークスペースの整理を行う31個のツールをエージェントに提供します——フォーム作成と回答処理をエージェント主導のタスクとして扱うことに絞り込んだセットです。

​
はじめに

1

OAuthで接続する

エージェントにTypeform関連の作業を依頼(例: 「フィードバックフォームの最新の回答を見せて」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Typeformアカウントを許可する

Shanoneにアクセスさせたいフォームを持つアカウントで、TypeformのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、typeform_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはTypeform向けに31個のツールを、以下のカテゴリに整理して提供しています。
typeform_list_forms, typeform_get_form, typeform_create_form, typeform_update_form, typeform_patch_form, typeform_delete_form, typeform_get_form_messages, typeform_update_form_messages
typeform_list_responses, typeform_delete_responses
typeform_list_themes, typeform_get_theme, typeform_create_theme, typeform_update_theme, typeform_delete_theme
typeform_list_images, typeform_get_image, typeform_upload_image, typeform_delete_image, typeform_get_image_by_size
typeform_list_webhooks, typeform_get_webhook, typeform_create_or_update_webhook, typeform_delete_webhook, typeform_list_webhook_deliveries
typeform_list_workspaces, typeform_get_workspace, typeform_create_workspace, typeform_update_workspace, typeform_delete_workspace
typeform_get_me

​
よくあるユースケース

回答のダイジェスト

前回確認以降の新しい回答を取得し、傾向を要約したり緊急のフィードバックにフラグを立てたりする

フォームテンプレート化

新しいキャンペーン用に、フォームの構造/メッセージをプログラムで複製・調整する

ブランドの一貫性

ワークスペース内のすべてのフォームに共通のテーマを適用する

データのクリーンアップ

実際の回答を分析する前に、テストやスパムの回答をまとめて削除する

​
トラブルシューティング

回答はページネーションされ、日付/完了ステータスでフィルタできます——typeform_list_responsesのshanone_get_tool_schemaを確認し、1回の呼び出しで全件返ると考えるのではなくsince/untilやcompletedを明示的に指定してください。
typeform_update_formはフォーム定義全体を置き換えます(PUTの挙動)——特定フィールドの部分更新には代わりにtypeform_patch_formを使ってください。
Webhookタグがフォームごとに一意であること、フォームが実際に回答を受信していることを確認してください——typeform_list_webhook_deliveriesで最近の配信試行と失敗を確認できます。