Skip to main content

​
Calendly

ShanoneのCalendly連携は、イベントタイプ、予定済みイベント、参加者、空き時間、組織、チーム、ルーティングフォームを管理する51個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにCalendly関連の作業を依頼(例: 「今後の予定済みイベントを一覧表示して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。どちらの場合も、ShanoneをCalendlyアカウントに対して許可するためのconnect_linkが発行されます。
2

Calendlyアカウントを許可する

Shanoneに操作させたいアカウント(該当する場合は組織も含む)について、CalendlyのOAuth同意画面を承認します。
3

リクエストを再実行する

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

​
利用可能なツール

ShanoneはCalendly向けに51個のツールを、以下のカテゴリに整理して提供しています。
calendly_list_scheduled_events, calendly_get_scheduled_event, calendly_cancel_scheduled_event, calendly_list_event_invitees, calendly_get_invitee, calendly_create_event_invitee, calendly_mark_invitee_no_show, calendly_delete_invitee_no_show
calendly_list_event_types, calendly_get_event_type, calendly_create_event_type, calendly_update_event_type, calendly_create_one_off_event_type, calendly_get_event_type_availability, calendly_update_event_type_availability, calendly_list_event_type_hosts, calendly_list_group_event_types, calendly_get_group_event_type, calendly_list_group_relationships
calendly_create_scheduling_link, calendly_create_single_use_scheduling_link, calendly_list_event_type_available_times, calendly_list_user_busy_times, calendly_list_user_availability_schedules, calendly_get_user_availability_schedule, calendly_update_user_availability_schedule, calendly_get_user_availability
calendly_get_organization, calendly_get_organization_membership, calendly_list_organization_memberships, calendly_invite_user_to_organization, calendly_remove_user_from_organization, calendly_list_organization_invitations, calendly_revoke_organization_invitation, calendly_list_teams, calendly_get_team, calendly_list_team_memberships, calendly_get_team_membership
calendly_list_routing_forms, calendly_get_routing_form, calendly_list_routing_form_submissions, calendly_get_routing_form_submission
calendly_list_webhook_subscriptions, calendly_create_webhook_subscription, calendly_delete_webhook_subscription
calendly_create_share, calendly_delete_share
calendly_delete_invitee_data, calendly_delete_scheduled_event_data
calendly_list_activity_log_entries, calendly_get_current_user

​
よくあるユースケース

ミーティング準備

通話の前に本日の予定済みイベントと参加者の詳細を取得する

ノーショー対応

ノーショーを検出し、スケジューリングリンクを使って再調整メールの案を作成する

リードのルーティング

ルーティングフォームの回答を読み取り、CRMやタスク管理ツールに整理する

チームアクセス管理

組織メンバーの招待・削除やチームメンバーシップの確認を行う

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

参加者をプログラムで作成するにはCalendlyのEnterpriseプランが必要です。それ以外のプランでは、代わりにcalendly_create_scheduling_linkを使ってそのリンクを参加者に送ってください。
メンバーシップ/チーム管理系のエンドポイントは、接続しているユーザーがCalendly組織の管理者またはオーナーであることを必要とします。一般メンバーのアカウントでは他ユーザーの情報を参照できません。
ルーティングフォームはCalendly上で公開され、実際に回答を受け付けている状態である必要があります。calendly_list_routing_formsは接続ユーザーまたはその組織が所有するフォームのみを返します。