> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailchimp

> Mailchimpのメール/SMSマーケティングとEコマース連携を運用 — オーディエンス、キャンペーン、オートメーション、テンプレート、レポート

# Mailchimp

ShanoneのMailchimp連携は、Marketing APIのほぼ全体をカバーする279個のツールをエージェントに提供します——オーディエンス、キャンペーン、オートメーション、SMS、Eコマース、テンプレート、ランディングページ、レポートまで扱えます。

## はじめに

<Steps>
  <Step title="OAuthで接続する">
    エージェントにMailchimp関連の作業を依頼(例: 「今月のメールキャンペーンを一覧表示して」)するか、Shanoneダッシュボードの**連携**から事前に接続しておきます。
  </Step>

  <Step title="Mailchimpアカウントを許可する">
    Shanoneに操作させたいアカウントについて、MailchimpのOAuth同意画面を承認します。MailchimpのOAuthトークンには有効期限やリフレッシュの仕組みがないため、後で取り消された場合は再接続が必要です。
  </Step>

  <Step title="リクエストを再実行する">
    接続が完了すると、`mailchimp_*`ツールに対する`shanone_execute_tool`呼び出しが成功するようになります。
  </Step>
</Steps>

## 利用可能なツール

ShanoneはMailchimp向けに**279個のツール**を、以下のカテゴリに整理して提供しています。

<AccordionGroup>
  <Accordion title="オーディエンス & リスト">
    `mailchimp_get_lists`, `mailchimp_get_list`, `mailchimp_create_list`, `mailchimp_update_list`, `mailchimp_delete_list`, `mailchimp_get_list_activity`, `mailchimp_get_list_growth_history`, `mailchimp_get_growth_history_by_month`, `mailchimp_get_list_locations`, `mailchimp_get_list_clients`, `mailchimp_search_tag_members`, `mailchimp_batch_unsubscribe_members`, `mailchimp_get_audiences_beta`, `mailchimp_get_audience_beta`, `mailchimp_get_beta_contacts`, `mailchimp_get_beta_contact`, `mailchimp_create_beta_contact`, `mailchimp_update_beta_contact`, `mailchimp_archive_beta_contact`, `mailchimp_forget_beta_contact`, `mailchimp_get_abuse_reports`, `mailchimp_get_abuse_report`, `mailchimp_get_list_webhooks`, `mailchimp_get_list_webhook`, `mailchimp_create_list_webhook`, `mailchimp_update_list_webhook`, `mailchimp_delete_list_webhook`
  </Accordion>

  <Accordion title="メンバー">
    `mailchimp_get_list_members`, `mailchimp_get_list_member`, `mailchimp_add_list_member`, `mailchimp_update_list_member`, `mailchimp_add_or_update_list_member`, `mailchimp_archive_list_member`, `mailchimp_delete_list_member_permanent`, `mailchimp_get_member_events`, `mailchimp_add_member_event`, `mailchimp_get_member_notes`, `mailchimp_get_member_note`, `mailchimp_add_member_note`, `mailchimp_update_member_note`, `mailchimp_delete_member_note`, `mailchimp_get_member_tags`, `mailchimp_update_member_tags`, `mailchimp_get_list_segments_for_tags`, `mailchimp_get_member_goals`, `mailchimp_get_member_activity_feed`
  </Accordion>

  <Accordion title="セグメント、興味関心 & マージフィールド">
    `mailchimp_get_segments`, `mailchimp_get_segment`, `mailchimp_create_segment`, `mailchimp_update_segment`, `mailchimp_delete_segment`, `mailchimp_batch_add_remove_segment_members`, `mailchimp_get_segment_members`, `mailchimp_add_segment_member`, `mailchimp_remove_segment_member`, `mailchimp_get_interest_categories`, `mailchimp_get_interest_category`, `mailchimp_create_interest_category`, `mailchimp_update_interest_category`, `mailchimp_delete_interest_category`, `mailchimp_get_interests`, `mailchimp_get_interest`, `mailchimp_create_interest`, `mailchimp_update_interest`, `mailchimp_delete_interest`, `mailchimp_get_merge_fields`, `mailchimp_get_merge_field`, `mailchimp_create_merge_field`, `mailchimp_update_merge_field`, `mailchimp_delete_merge_field`, `mailchimp_get_signup_forms`, `mailchimp_customize_signup_form`
  </Accordion>

  <Accordion title="キャンペーン">
    `mailchimp_get_campaigns`, `mailchimp_get_campaign`, `mailchimp_create_campaign`, `mailchimp_update_campaign`, `mailchimp_delete_campaign`, `mailchimp_send_campaign`, `mailchimp_schedule_campaign`, `mailchimp_unschedule_campaign`, `mailchimp_pause_campaign`, `mailchimp_resume_campaign`, `mailchimp_cancel_campaign_send`, `mailchimp_replicate_campaign`, `mailchimp_send_test_email`, `mailchimp_resend_campaign`, `mailchimp_get_campaign_content`, `mailchimp_set_campaign_content`, `mailchimp_get_send_checklist`, `mailchimp_get_campaign_feedback_list`, `mailchimp_get_campaign_feedback`, `mailchimp_add_campaign_feedback`, `mailchimp_update_campaign_feedback`, `mailchimp_delete_campaign_feedback`, `mailchimp_get_campaign_folders`, `mailchimp_get_campaign_folder`, `mailchimp_create_campaign_folder`, `mailchimp_update_campaign_folder`, `mailchimp_delete_campaign_folder`, `mailchimp_search_campaigns`
  </Accordion>

  <Accordion title="SMSキャンペーン">
    `mailchimp_get_sms_campaigns`, `mailchimp_get_sms_campaign`, `mailchimp_create_sms_campaign`, `mailchimp_update_sms_campaign`, `mailchimp_delete_sms_campaign`, `mailchimp_get_sms_campaign_content`, `mailchimp_set_sms_campaign_content`, `mailchimp_send_sms_campaign`, `mailchimp_schedule_sms_campaign`, `mailchimp_cancel_sms_campaign`
  </Accordion>

  <Accordion title="オートメーション">
    `mailchimp_get_automations`, `mailchimp_get_automation`, `mailchimp_start_automation`, `mailchimp_pause_automation`, `mailchimp_archive_automation`, `mailchimp_get_automation_emails`, `mailchimp_get_automation_email`, `mailchimp_update_automation_email`, `mailchimp_delete_automation_email`, `mailchimp_pause_automation_email`, `mailchimp_start_automation_email`, `mailchimp_get_automation_email_queue`, `mailchimp_add_subscriber_to_email_queue`, `mailchimp_get_removed_subscribers`, `mailchimp_remove_subscriber_from_automation`, `mailchimp_get_queued_subscriber_detail`
  </Accordion>

  <Accordion title="テンプレート & ランディングページ">
    `mailchimp_get_templates`, `mailchimp_get_template`, `mailchimp_create_template`, `mailchimp_update_template`, `mailchimp_delete_template`, `mailchimp_get_template_default_content`, `mailchimp_get_template_folders`, `mailchimp_get_template_folder`, `mailchimp_create_template_folder`, `mailchimp_update_template_folder`, `mailchimp_delete_template_folder`, `mailchimp_get_landing_pages`, `mailchimp_get_landing_page`, `mailchimp_create_landing_page`, `mailchimp_update_landing_page`, `mailchimp_delete_landing_page`, `mailchimp_get_landing_page_content`, `mailchimp_publish_landing_page`, `mailchimp_unpublish_landing_page`
  </Accordion>

  <Accordion title="Eコマース: ストア & カタログ">
    `mailchimp_get_stores`, `mailchimp_get_store`, `mailchimp_create_store`, `mailchimp_update_store`, `mailchimp_delete_store`, `mailchimp_get_store_products`, `mailchimp_get_store_product`, `mailchimp_add_store_product`, `mailchimp_update_store_product`, `mailchimp_delete_store_product`, `mailchimp_get_product_variants`, `mailchimp_get_product_variant`, `mailchimp_add_product_variant`, `mailchimp_update_product_variant`, `mailchimp_add_or_update_product_variant`, `mailchimp_delete_product_variant`, `mailchimp_get_product_images`, `mailchimp_get_product_image`, `mailchimp_add_product_image`, `mailchimp_update_product_image`, `mailchimp_delete_product_image`
  </Accordion>

  <Accordion title="Eコマース: 顧客、カート、注文 & プロモーション">
    `mailchimp_get_store_customers`, `mailchimp_get_store_customer`, `mailchimp_add_store_customer`, `mailchimp_update_store_customer`, `mailchimp_add_or_update_store_customer`, `mailchimp_delete_store_customer`, `mailchimp_get_store_carts`, `mailchimp_get_store_cart`, `mailchimp_add_store_cart`, `mailchimp_update_store_cart`, `mailchimp_delete_store_cart`, `mailchimp_get_cart_lines`, `mailchimp_get_cart_line`, `mailchimp_add_cart_line`, `mailchimp_update_cart_line`, `mailchimp_delete_cart_line`, `mailchimp_get_store_orders`, `mailchimp_get_store_order`, `mailchimp_add_store_order`, `mailchimp_update_store_order`, `mailchimp_delete_store_order`, `mailchimp_get_order_lines`, `mailchimp_get_order_line`, `mailchimp_add_order_line`, `mailchimp_update_order_line`, `mailchimp_delete_order_line`, `mailchimp_get_account_orders`, `mailchimp_get_order_by_campaign`, `mailchimp_get_order_by_outreach`, `mailchimp_get_promo_rules`, `mailchimp_get_promo_rule`, `mailchimp_create_promo_rule`, `mailchimp_update_promo_rule`, `mailchimp_delete_promo_rule`, `mailchimp_get_promo_codes`, `mailchimp_get_promo_code`, `mailchimp_create_promo_code`, `mailchimp_update_promo_code`, `mailchimp_delete_promo_code`
  </Accordion>

  <Accordion title="レポート & 分析">
    `mailchimp_get_campaign_reports`, `mailchimp_get_campaign_report`, `mailchimp_get_campaign_open_details`, `mailchimp_get_campaign_open_detail_for_member`, `mailchimp_get_campaign_click_details`, `mailchimp_get_campaign_click_detail_for_link`, `mailchimp_get_click_detail_members`, `mailchimp_get_click_detail_member`, `mailchimp_get_sent_to_list`, `mailchimp_get_sent_to_member`, `mailchimp_get_unsubscribed_list`, `mailchimp_get_unsubscribed_member`, `mailchimp_get_abuse_complaints`, `mailchimp_get_abuse_complaint`, `mailchimp_get_advice`, `mailchimp_get_domain_performance`, `mailchimp_get_ecommerce_report`, `mailchimp_get_campaign_ecommerce_summary`, `mailchimp_get_eepurl_report`, `mailchimp_get_email_activity`, `mailchimp_get_email_activity_for_member`, `mailchimp_get_campaign_locations`, `mailchimp_get_landing_page_report`, `mailchimp_get_landing_page_reports`, `mailchimp_get_facebook_ads`, `mailchimp_get_facebook_ad`, `mailchimp_get_facebook_ad_report`, `mailchimp_get_facebook_ad_ecommerce_report`
  </Accordion>

  <Accordion title="アンケート">
    `mailchimp_get_surveys`, `mailchimp_get_survey`, `mailchimp_publish_survey`, `mailchimp_unpublish_survey`, `mailchimp_get_survey_report`, `mailchimp_get_survey_question_reports`, `mailchimp_get_survey_question_report`, `mailchimp_get_survey_responses`, `mailchimp_get_survey_response`
  </Accordion>

  <Accordion title="検索、ファイル、ドメイン & 連携サイト">
    `mailchimp_search_members`, `mailchimp_get_file_manager_files`, `mailchimp_get_file_manager_file`, `mailchimp_upload_file_manager_file`, `mailchimp_update_file_manager_file`, `mailchimp_delete_file_manager_file`, `mailchimp_get_file_manager_folders`, `mailchimp_get_file_manager_folder`, `mailchimp_create_file_manager_folder`, `mailchimp_update_file_manager_folder`, `mailchimp_delete_file_manager_folder`, `mailchimp_get_file_manager_folder_files`, `mailchimp_get_verified_domains`, `mailchimp_get_verified_domain`, `mailchimp_create_verified_domain`, `mailchimp_verify_domain`, `mailchimp_delete_verified_domain`, `mailchimp_get_connected_sites`, `mailchimp_get_connected_site`, `mailchimp_create_connected_site`, `mailchimp_delete_connected_site`, `mailchimp_verify_connected_site_script`
  </Accordion>

  <Accordion title="バッチ操作、Webhook & 管理">
    `mailchimp_get_batch_operations`, `mailchimp_get_batch_operation`, `mailchimp_start_batch_operation`, `mailchimp_delete_batch_operation`, `mailchimp_wait_for_batch_completion`, `mailchimp_get_batch_webhooks`, `mailchimp_get_batch_webhook`, `mailchimp_create_batch_webhook`, `mailchimp_update_batch_webhook`, `mailchimp_delete_batch_webhook`, `mailchimp_ping`, `mailchimp_get_api_root`, `mailchimp_get_authorized_apps`, `mailchimp_get_authorized_app`, `mailchimp_get_chimp_chatter`
  </Accordion>
</AccordionGroup>

## よくあるユースケース

<CardGroup cols={2}>
  <Card title="キャンペーン成果のレビュー" icon="bar-chart">
    直近のキャンペーンの開封/クリックレポートを取得し、うまくいった点を要約する
  </Card>

  <Card title="リストの健全性維持" icon="users">
    エンゲージメントの低いメンバーを検索し、一括で配信停止やタグ付けを行う
  </Card>

  <Card title="オートメーションの調整" icon="repeat">
    成果の出ていないオートメーションメールを一時停止し、内容を更新してから再開する
  </Card>

  <Card title="Eコマース連携" icon="shopping-cart">
    ストアの商品・注文・顧客情報を外部システムと同期させる
  </Card>
</CardGroup>

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

<AccordionGroup>
  <Accordion title="mailchimp_send_campaignがチェックリストエラーで失敗する">
    まず`mailchimp_get_send_checklist`を呼び出してください——Mailchimpは、送信元アドレス、件名、コンテンツなどの必須項目が送信前チェックリストを通過するまで送信をブロックします。
  </Accordion>

  <Accordion title="バッチ操作は即座に返るがデータがまだ変わっていない">
    バッチ操作はMailchimp側で非同期に実行されます——初回のレスポンスで完了したと決めつけず、`mailchimp_wait_for_batch_completion`を使うか、`mailchimp_get_batch_operation`をポーリングしてください。
  </Accordion>

  <Accordion title="それまで正常に動いていたツール呼び出しが突然401を返す">
    MailchimpのOAuthトークンにはリフレッシュの仕組みがありません——アプリの認可が取り消されたり期限切れになった場合、暗黙的なリフレッシュは期待できず、**連携**画面からMailchimpを完全に再接続する必要があります。
  </Accordion>
</AccordionGroup>