統合

ほとんどの小規模チームが実際に使う約 40 のサービスについて、Tablize はビルトインコネクタを出荷しています。Connect をクリックし、サービスの OAuth フローを通り、Agent が同期を開始します。API キーの管理もスキーママッピングも、世話を焼く必要のある cron ジョブもありません。

このページは、何がサポートされているか、コネクタはどう動くか、全てに共通する挙動を扱います。

カタログ

カテゴリ	コネクタ
決済	Stripe, PayPal, Adyen, Airwallex
EC	Shopify, BigCommerce, WooCommerce, Adobe Commerce, Amazon SP, eBay, Etsy, Walmart, Lazada, Bol, TikTok Shop, Google Merchant
広告	Google Ads, Meta Ads, TikTok Ads, Amazon Ads, Meta CAPI, TikTok Events API
アナリティクス	GA4, GA4 Measurement Protocol, Google Search Console, PostHog
CRM & サポート	HubSpot, Zendesk, Gorgias, Customer.io
配送 & 税	ShipStation, DHL, Easyship, Avalara
データウェアハウス	Snowflake, Supabase, Vertex AI
汎用	Web API（任意の REST エンドポイント）

コネクタがない場合は 2 つのオプション:

• Web API として構築。 エンドポイントのドキュメントをチャットに貼り、Agent に同期を頼んでください。API をスケジュールで叩く Script を書きます。
• リクエスト。 およそ 2 週間ごとに新コネクタを出荷します。ロードマップページに現在のキューがあります。

コネクタの仕組み

裏では、すべてのコネクタが同じ 3 つのことを行います:

1. OAuth または API キー — サービスがあなたを認証。Tablize はトークンを暗号化された認証情報ボルト（ワークスペースごと、サービスごと）に保存。
2. フル同期 + 増分カーソル — 初接続時、Tablize はすべての履歴データを取得（コネクタごとの上限まで）。その後、増分カーソル — 通常 updated_at またはイベント ID — が同期を最新に保ちます。
3. 安定名のテーブル — 他のテーブルと同じようにクエリ。integrations.stripe_charges、integrations.shopify_orders など。

Agent はこれらのテーブルを見ます。「先週 Stripe が処理した売上は？」と聞けば、Agent は同期されたテーブルに対して SQL を書きます — API 呼び出しもレート制限の心配もなし。

サービスを接続

ワークスペース → Integrations → サービスを選択 → Connect をクリック。

OAuth サービスの場合、サービス自身のログインページに飛び、Tablize の権限を承認し、戻ってきます。Tablize は接続を確認し、即座に履歴同期を開始します。データ量によって、初回同期は数分（小さな Stripe アカウント）から数時間（3 年分の Shopify 注文）かかります。

初回同期が終わるとチャットメッセージが届きます。Agent が見つけたものを自動で分析し、スターター Report を提案します — 「あなたの Stripe データはこんな感じです」 — 統合を開いて空のチャットを見つめなくて済みます。

同期スケジュール

すべてのコネクタにデフォルトの頻度があります。コネクタの設定ページで上書きできます。

データ種別	デフォルト頻度	理由
注文、決済、チケット	5 分	ライブダッシュボードに十分新鮮
キャンペーンパフォーマンス（広告）	1 時間	広告プラットフォームはこれ以上速く更新しない
カタログ / 商品メタデータ	24 時間	変更がまれ
履歴バックフィル	接続時に一回	自動で再実行しない

手動同期は常にオプション — コネクタページの Sync now が即座にフル増分フェッチを実行します。

同期ヘルスとエラー

各コネクタにダッシュボードがあり、表示します:

• 最終成功同期、エンティティごと。
• 前回実行以降に同期された行数。
• 失敗中のエンドポイント（通常: トークン期限切れ、権限取り消し、レート制限）。
• 各失敗のリトライスケジュール。

トークンエラーはダッシュボードとチャット通知の両方に現れます — 「HubSpot で再認証が必要」 — ワンクリック再接続付き。

スキーマ進化

コネクタは以下を自動処理:

• 新フィールド — 新カラムとしてテーブルに追加。破損なし。
• 削除されたフィールド — 以降 NULL のカラムとして保持。履歴データには値が残ります。
• リネームされたフィールド — コネクタレベルのルールでマップ（例: Shopify が email を contact_email にリネーム）。
• 型変更 — 新しい _v2 テーブル。Agent がチャットでフラグ。

権限とスコープ

Tablize はサービスがサポートする限り読み取り専用権限をリクエストします。コネクタページに各サービスの正確なスコープが表示されます。

読み書き OAuth しか提供しないサービス（HubSpot のデフォルトアプリスコープなど）でも、Tablize は書き込みません — 書き込み API を使わないだけです。接続後に書き込みスコープを取り消して検証できます。読み取り専用同期は動き続けます。

サービスごとの既知の癖

分析に関わる挙動を持つサービスがあります:

• GA4: 履歴バックフィルは 14 ヶ月で打ち切り（Google の制限）。それより古いデータはどの API でもアクセスできません。
• Google Ads、Meta Ads: コスト数値はインプレッションから 3 日まで遡って変化します。Tablize は実行ごとに直近 3 日を再同期して数値を正確に保ちます。
• Shopify: 返金は注文とは別エンティティで届きます。売上チャートはそれらを JOIN。マージンチャートは差し引きます。
• Stripe: 紛争（チャージバック）は別 webhook ストリームです。同じ OAuth フローで接続されますが integrations.stripe_disputes に同期されます。
• Amazon SP: レート制限が厳しい。大きなアカウントは初回バックフィルに丸 1 日かかります。これは Amazon の問題で、当社ではありません。

統合プレイブック（内部ドキュメント）にコネクタごとのさらに多くの既知の癖が追跡されています。予期しないものに遭遇したら、コネクタの Health タブに通常答えがあります。

切断

ワークスペース → Integrations → サービス → Disconnect。3 つ知っておくべきこと:

• 同期されたテーブルは残ります。 切断は同期を止めますが、データは削除しません。
• 認証情報がボルトから消去されます。再接続には OAuth が再要求されます。
• 実行中の Report と Watch は動き続けます — 同期データが古くなって再接続または削除するまで。

データを完全に削除するには、まず切断し、それから Data ページからテーブルを drop してください。

次のステップ

• Webhook と API — ビルトインコネクタのないサービス向け。
• Watches — 統合データにアラートを設置（返金率、広告費、チケット量）。
• Dashboards — 統合データの最も一般的な住処。