Zoho CRM

Zoho CRM はコネクタです。MeDo アプリを 1 つの Zoho CRM アカウントに接続し、アプリがアカウントのモジュールとフィールドを読み取り、リード、連絡先、取引先、商談、タスクなどのレコードを一覧表示・検索し、関連レコードを読み取り、レコードを作成・更新できるようにします。カスタムモジュールも標準モジュールと同じように扱えます。

#作れるもの

• 非公開のリードダッシュボード。 リードの会社、ステータス、ソース、担当者を一覧表示し、ステータスで絞り込み、必要に応じて続きを読み込みます。
• リード登録フォーム。 Zoho CRM にリードを作成する前に、氏名、会社、メール、ソースをプレビューします。
• 商談パイプラインボード。 商談をステージ別にまとめ、更新前にステージ変更を確認します。
• 取引先の検索ページ。 取引先を名前で検索し、各取引先の連絡先、進行中の商談、タスクを表示します。

顧客レコードをすでに Zoho CRM で管理していて、アプリには絞り込んだビューや構造化された入口を追加したい場合に向いています。完全な CRM クライアントではありません。制限を参照してください。

#ビルド例

次のいずれかをプロンプト欄にコピーしてください。最初の例は、データを読み取るだけの最小の出発点です。

Use @Zoho CRM to build a private lead dashboard that lists my Zoho CRM leads with company, status, source, and owner, filters them by status, and loads more when needed.

Use @Zoho CRM to build a lead intake form that previews the name, company, email, and lead source before creating the lead in Zoho CRM.

Use @Zoho CRM to build a private deal pipeline board that groups deals by stage and lets me review and confirm a stage change before updating the deal.

Use @Zoho CRM to build an account lookup page that searches accounts by name and shows each account's contacts, open deals, and tasks.

#準備と接続

アプリで使うレコードをすでに閲覧できる Zoho CRM アカウントが必要です。API トークンや Zoho アプリの登録は不要です。接続は Zoho の米国データセンター（zoho.com）のアカウントで検証済みで、他のデータセンターのアカウントは未検証です。

1. サイドバーの Skills & Connectors（スキルとコネクタ） を開き、Zoho CRM を検索します。
2. カードを開き、Connect（接続） をクリックします。
3. Zoho にサインインし、MeDo が求めるアクセスを許可します。
4. ボタンが Connected（接続済み） に変わります。

接続前にビルドを始めた場合、MeDo は返信の下に Zoho CRM の接続ボタンを表示します。そこから接続することもできます。

#アプリでの使い方

• アプリは接続したあなたのアカウントを使い、訪問者それぞれの Zoho ログインは使いません。 ページを開いた人は全員、同じ CRM データを見ます。CRM のビューはアプリ自身のサインインの内側に置き、対象の人だけに限定してください。
• アプリは最初に実際の構造を調べます。 Zoho CRM はモジュールとフィールドを API 名（例：Leads、Last_Name）で扱い、存在するモジュールは Zoho のエディションによって異なります。アプリは推測せず、アカウントから読み取ります。
• レコードはページ単位で返ります。 1 ページは最大 100 件です。続きを読み込む操作を用意してもらい、1 ページを CRM 全体として見せないでください。
• 検索には具体的な 1 つの条件が必要です。 1 回の検索で使えるのはキーワード、メールアドレス、電話番号、フィールド条件のいずれか 1 つで、一致は合計で最大 2,000 件までです。
• 関連レコードは別のステップです。 取引先の連絡先、商談、タスクは、その取引先の関連リストから読み取ります。
• 書き込みは先に確認します。 MeDo は保存前にレコード、または対象フィールドと新しい値をプレビューします。リードなどの作成と更新が対象です。
• 選択リストの値はリストから選びます。 商談ステージやリードのステータスなどのフィールドでは、そのフィールドにすでにある値だけを提示します。Zoho CRM はリストにない値もエラーなしで保存するため、アプリはリストの値だけを書き込みます。
• 社内メモはアプリのものです。 Zoho CRM に対応するフィールドがないメモやフォローアップの状態は、実際のレコードに紐付けてアプリのテーブルに保存します。

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

アプリに「接続が必要」と表示される。 アプリの所有者がコネクタ カードを開いて Connect をクリックし、再読み込みしてください。

モジュールやフィールドが見つからない。 Zoho CRM は API 名を使い、モジュールはエディションと権限によって異なります。先にアプリへモジュールとフィールドを一覧させ、返ってきた名前を使ってください。

保存が拒否される。 必須フィールドのないレコードなど、検証に失敗した書き込みは全体が拒否され、何も作成されません。フィールドを直して再送信してください。

レコードが作成・更新されていない。 書き込みは自動でリトライされません。Zoho CRM でレコードを開いて実際の状態を確認してから、変更をやり直してください。

検索結果が不完全に見える。 1 回の検索は一致を最大 2,000 件まで返します。より具体的な語句を使うか、条件を絞ってください。

#関連ページ

• コネクタカタログ — ほかのコネクタとその用途。
• スキルとコネクタ — スキルの呼び出し方、料金、制限。
• アクセスとロールの管理 — 接続データを読み取り・変更できる人を制限する。