APIとSDK
アクセストークンの発行時に[NO_CRM_ACCOUNT](Zoho CRMアカウントが見つからないことを示すエラーコード)が発生する
使用したOAuth認証コードが、サンドボックスの再作成前に発行されたものか確認します。サンドボックスを再作成すると、以前の認証コードは無効になります。新しい認証コードを取得し、アクセストークンを発行してください。解決しない場合は、サポート窓口にお問い合わせください。

アクセストークンの発行時に[invalid_code](認証コードが無効であることを示すエラーコード)が発生する
トークンの発行時に指定したデータセンター(DC)が正しくない可能性があります。利用中のデータセンターに対応するドメイン(例:accounts.zoho.com、zoho.eu、zoho.in)を使用しているかを確認します。異なるデータセンターを指定すると、認証コードが無効というエラーが発生します。
以前に使用した認証コードを再利用した場合も、このエラーが発生することがあります。開発者コンソールで発行する認証コード(認可トークン)は1回しか使用できず、有効期間は最大10分間です。使用済みまたは期限切れの認証コードでトークンを要求すると、[invalid_code](認証コードが無効であることを示すエラーコード)が返されます。
再発行した新しいAPIキーに関連するユーザーが分からない
関数名、現在のAPIキーの画面の画像、最後に正常に動作したおおよその時刻、または変更に気付いた時刻を添えてサポート窓口にお問い合わせください。
APIを使用すると、独自の必須項目を入力しなくてもデータを作成できてしまう
APIリクエストの本文で、正しいレイアウトIDが指定されているか確認します。また、必要な必須項目について、正しい項目のAPI名と値が含まれているか確認します。問題が解決しない場合は、サポート窓口にお問い合わせください。詳細は
こちらのAPIドキュメントをご参照ください。
データ取得APIや検索APIを実行すると、HTTP 204(応答内容なし)が返され、データを取得できない
データの作成直後に取得しようとすると、情報が反映されるまでの数秒間は取得できないことがあります。対象のデータが変換済みではないかも確認します。変換済みデータも検索するには、「converted」パラメーターの値に「Both」を指定します。
「APIの上限に達しました」という通知が表示された後、APIクレジットのページを開けない
サポート窓口のオンラインセッションを利用するか、support@zohocrm.comまでメールでお問い合わせください。
一括処理APIの実行時に、「非対応のファイルです」というエラーが発生する
ZIPファイルに含まれるCSVファイルが1件以内であることを確認します。隠しファイル、大きすぎるファイル、特殊文字を含むファイルがないこと、およびファイルIDを重複して使用していないことも確認します。上記を確認しても問題が解決しない場合は、サポート窓口にお問い合わせください。

APIリクエストの実行時に[OAUTH_MISMATCH_ERROR](OAuthの認証情報が一致しないことを示すエラーコード)が発生する
アクセストークンの発行に使用した認証URLに「scope」パラメーターが含まれているかを確認します。また、認可トークンの発行時にも同じスコープを指定し、対象のAPIに必要なスコープがすべて含まれているかを確認します。問題が解決しない場合は、サポート窓口にお問い合わせください。

APIでデータを更新しようとすると、[RECORD_IN_BLUEPRINT](データがブループリントの処理中であることを示すエラーコード)が発生する
このエラーは、対象のデータがブループリントの処理中である場合に発生します。データを更新する必要がある場合は、ブループリントの遷移APIを使用して、設定済みのブループリントに従って次の状態へ進めます。これにより、ブループリントの条件を守りながらデータを更新できます。不明な点がある場合は、
サポート窓口にお問い合わせください。
APIの実行時に[TOO_MANY_REQUESTS](リクエスト数が上限を超えたことを示すエラーコード)が発生する
このエラーは、リクエストがZoho CRMのAPIの上限を超えた場合に発生します。よくある原因は、同時実行数の上限を超えたことです。1日のAPIクレジット数、リクエスト数、短時間に実行できる回数の上限を超えた場合にも発生します。これらの上限は、システムの処理速度と安定性を確保するために設けられています。APIの利用状況を確認し、同時に送信するリクエスト数を減らします。可能な場合はデータをまとめて処理し、再試行時には待機時間を段階的に延ばす仕組みを導入します。詳細は、
Zoho CRM APIの利用上限をご参照ください。サポートが必要な場合は、
サポート窓口にお問い合わせください。
アクセストークンの発行時にリフレッシュトークン(更新用トークン)を取得できない
OAuthの認証方法が「online」の場合、リフレッシュトークンは発行されません。取得するには、認証URLに「access_type=offline」と「prompt=consent」を指定します。初回の同意時にリフレッシュトークンが返されます。リダイレクトURIが開発者コンソールの登録内容と一致しているか確認し、トークンを安全に保管してください。問題がある場合は
サポート窓口にお問い合わせください。
Zoho CRMの検索APIで「equals」演算子を使用すると、部分一致のデータも返される
検索APIの「equals」演算子では、複数の条件を組み合わせた場合や、1行テキスト項目に特殊文字が含まれている場合などに、完全一致しないデータが返されることがあります。確実に完全一致で検索するには、COQL APIで「=」演算子を使用します。
一括処理APIを並列実行できない
一括処理APIによるジョブは並列には実行できません。タブとユーザーごとに、一度に処理できるジョブは1件です。新しいインポート、エクスポート、更新のジョブを開始するには、前のジョブの完了または却下を待ってください。
ウィジェット
顧客ポータル用の独自のウィジェットを作成できない
顧客ポータルではウィジェットを利用できません。
Webタブとして設定したウィジェットを開くと、「ページが見つかりません」というエラーが表示される
クライアントスクリプト
クライアントスクリプトでZDK.Appsを使用できない
新しく作成したタブでは、クライアントスクリプトの実行環境でZDK.Appsを利用できない場合があります。その結果、ZDK.Apps.CRM.<ModuleName>などの指定を認識できず、タブへのアクセスや関連するメソッドが正常に動作しないことがあります。サーバー側でZDKキーを有効にすると、問題を解決できます。詳細は、サポート窓口にお問い合わせください。
データセンターの移行後にクライアントスクリプトを編集しようとすると、「対象のクライアントスクリプトを利用できません」というエラーが表示される
コードの担当者がオンラインセッションで調査できるように、サポート窓口にお問い合わせください。
クライアントスクリプトにNode.jsやCrypto-JSなどの外部ライブラリーを追加できない
現在、Zoho CRMのクライアントスクリプトでは、外部ライブラリーを読み込んだり、Node.jsのパッケージを使用したりすることはできません。
[自分の連絡先]以外の一覧を非表示にするクライアントスクリプトを作成したが、かんばん表示ではすべての一覧が表示される
これは現在確認されている仕様です。現時点では、かんばん表示にこの制限が適用されません。今後の更新での対応を検討しています。
新しいチームタブ用のクライアントスクリプトを作成できない
現時点では、Zoho CRMの[チーム]タブはクライアントスクリプトに対応していません。対応に向けて作業を進めています。検討が完了したら、更新情報をお知らせします。
[ステージ]項目に設定したOnBeforeUpdateのクライアントスクリプトが、想定どおりに動作しない
[ステージ]項目の「OnBeforeUpdate」にクライアントスクリプトを設定すると、警告を表示してfalseを返し、ステージが[失注]に変更されるのを防ぐ動作が想定されます。本来は、ユーザーが青色のチェックマークをクリックして保存を確定しようとした時点で実行されることを想定しています。しかし現状では、保存を確定する前に[失注]を選択した時点でスクリプトが実行されます。
[ステージ]項目の処理はほかの項目と異なるため、一部のクライアントスクリプトのイベントにまだ対応していません。回避策として、「受注」または「失注」のステージに対して「OnMandatoryFormLoad」イベントでクライアントスクリプトを設定することをお勧めします。
今後のバージョンで改善する予定です。