COQL(CRM Object Query Language)で発生する一般的なエラーとその原因

COQL(CRM Object Query Language)で発生する一般的なエラーとその原因

COQLの動作を検証/テストするためのスクリプトのサンプル(最小限必要な内容):

queryMap = Map();
query = 'select Last_Name from Contacts where Last_Name is not null'; queryMap.put('select_query', query);
response = invokeUrl [
      url: coqlurl
      type: POST
      parameters:queryMap.toString()
      connection: 'zcrm' ];
info response;

エラーメッセージの例:{'code':'INVALID_REQUEST','details':{},'message':'unable to process your request. please verify whether you have entered proper method name, parameter and parameter values.','status':'error'}

エラー発生時の確認事項:
1.APIのバージョンが適切かどうかをご確認ください。また、バージョン2(v2)とバージョン3(v3)の両方での動作をご確認ください。
2.外部連携の機能を利用してZoho OAuthの認証を行っている場合、認証の対象範囲(スコープ)においてCOQLが有効になっているかどうかをご確認ください。
3.COQLのすべてのリクエストでは、WHERE句が必須です。WHERE句を明示的に使用する必要がない場合でも必ず何らかの形で指定してください。なお、その場合は、取得結果に影響がないような条件を付加することで対応できます。例:where Last_Name is not null
4.APIではすべてのタブがサポートされていますが、COQLではすべてのタブはサポートされていません。COQLでサポートされているタブは以下のとおりです(2022年7月時点)。

見込み客、連絡先、取引先、商談、タスク、予定、通話、見積書、受注書、発注書、請求書、商品、価格表、仕入先、問い合わせ、ソリューション、キャンペーン、カスタムタブ

    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho Campaigns Resources

                Zoho WorkDrive Resources




                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day


                  • Ask the Experts









                                  • Related Articles

                                  • HubSpotからZoho CRMへのデータ移行

                                    APIとインスタンスURLを使用するだけで、HubSpotからZoho CRMにデータを移行できます。APIキーを入力することで、移行の処理を実行できます。なお、移行の処理の実行中も他の操作は可能です(移行の処理はバックグラウンドで実行されます)。移行が完了すると、Zoho CRMから通知メールが送信されます。移行の取り消しや再実行は、3回まで可能です。 APIトークンを生成するには HubSpotアカウントにログインします。 [Settings](設定)→[Account ...
                                  • Zoho CRMの概要

                                    Zoho CRMは、すばらしい顧客体験を提供するために必要な機能を集約したCRMシステムです。導入にあたって、多額の費用や長期にわたる開発、大量の人員などは必要ありません。導入直後からすぐに、顧客関係の強化、チーム間協力の促進、定型作業の自動化、情報の分析、AIの活用などを実現できます。 この記事では、CRMを取り巻く最近の状況にも触れつつ、Zoho CRMの概要を説明します。後半には、各種資料へのリンクも記載しています。Zoho CRMの理解と導入にお役立てください。 CRM(Customer ...
                                  • Converse for Zoho CRM

                                    Zoho CRMでConverse拡張機能を利用すると、Zoho CRM内から投稿を作成し、コメントや返信を通じて他のユーザーと会話することができます。この拡張機能では、見込み客と連絡先に関する情報を、関連するチームメンバーと個別に共有することが可能です。 メモ:Zoho ...
                                  • Zoho CRMの仕様

                                    この記事では、Zoho CRMのプラン、対応言語、利用環境、ストレージ容量、モバイルアプリの概要を説明します。 Zoho CRMのプラン Zoho CRMは、無料、スタンダード、プロフェッショナル、エンタープライズ、アルティメットという5つのプランで利用できます。プランごとに、利用できる機能や、設けられている制限が異なるため、それに応じて料金も異なります。以下に、各プランの制限の一部を示します。 無料 スタンダード プロフェッショナル エンタープライズ アルティメット カスタムタブの数 – ...
                                  • CRM for Everyoneとは

                                    CRM for Everyoneは、Zoho CRMを営業チームだけでなく、組織内の複数のチームと連携しながら利用するための機能です。複数のチームでスムーズに連携して、迅速な顧客対応を行うことで、顧客体験価値を高めることが可能です。 ...

                                  Resources

                                  Videos

                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                  eBooks

                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                  Webinars

                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                  CRM Tips

                                  Make the most of Zoho CRM with these useful tips.