Skip to main content

Luma

ShanoneのLuma連携は、イベント運営を一貫して行う36個のツールをエージェントに提供します——イベントの作成・更新、ゲストとホストの管理、チケット、クーポン、カレンダーメンバーシップまでカバーします。

はじめに

1

Luma APIキーを取得する

Lumaのカレンダー設定で、APIセクションからAPIキーを発行します(Luma Plus以上のプランが必要です)。
2

Shanoneにキーを追加する

ShanoneダッシュボードのIntegrations > Lumaで、そのAPIキーを貼り付けます。
3

リクエストを再実行する

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

利用可能なツール

ShanoneはLuma向けに36個のツールを、以下のカテゴリに整理して提供しています。
luma_list_events, luma_get_event, luma_create_event, luma_update_event, luma_add_event_to_calendar, luma_check_event_existence, luma_get_event_admin_info
luma_list_guests, luma_get_guest, luma_add_guests, luma_update_guest_status, luma_send_invites
luma_add_event_host, luma_remove_event_host, luma_update_event_host
luma_list_ticket_types, luma_get_ticket_type, luma_create_ticket_type
luma_list_event_coupons, luma_list_calendar_coupons, luma_create_event_coupon, luma_create_calendar_coupon
luma_list_person_tags, luma_create_person_tag, luma_delete_person_tag, luma_apply_tag_to_members, luma_manage_event_tags
luma_list_membership_tiers, luma_add_user_to_membership, luma_list_people, luma_import_people
luma_get_self, luma_get_user_info, luma_generate_upload_url, luma_list_webhooks, luma_create_webhook

よくあるユースケース

イベントセットアップ

イベントを作成し、ホストを追加し、チケットタイプを一連の流れで設定する

ゲストリスト管理

ゲストリストを一括インポートし、参加者にタグ付けして招待を送る

プロモーション

単一イベントまたはカレンダー全体に適用される割引クーポンを作成する

リアルタイム連携

Webhookを登録し、登録情報が自動的に別システムへ流れるようにする

トラブルシューティング

チケットやクーポン機能は、カレンダーが有料のLumaプランであることが必要です——無料カレンダーでもゲストやイベントの管理はできますが、有料チケット機能は使えません。
ゲストの追加と招待の送信は別のステップです——追加したゲストに実際にメールを送るには、その後にluma_send_invitesを呼び出してください。
重複したメールアドレスや不正な形式の行はエラーにならずスキップされます。完全にインポートされたと決めつけず、レスポンスでスキップ/失敗したエントリを確認してください。