Clever Geek Handbook

無料CRMのAPI





1年足らず前に、無料のPBXと統合された無料のCRMシステムを導入しました。この間、14,000社の企業と64,000人の従業員が使用しました。

現在、ほとんどのZCRM機能を利用できるオープンAPIを提供しています。APIを使用すると、任意の販売チャネルでCRMを使用できます。

以下では、APIの操作と使用可能な機能について簡単に説明します。シンプルですが便利で実用的な例もあります。Webサイトのフォームからリードを作成するためのスクリプトです。



無料のCRMについて簡単に



CRMとは何かを説明することは控えましょう。無料のCRMZadarmaは、顧客データを保存するすべての標準機能をサポートしています。情報は顧客のフィードに保存されます。また、クライアントに関する情報に加えて、あらゆる好み（カレンダー、かんばん、リスト）を表示する便利なタスクマネージャーを利用できます。これはすべて50人以上の従業員が利用でき、電話と完全に統合されています（WebRTCテクノロジーを使用したブラウザーからの呼び出しを含む）。



無料とはどういう意味ですか？支払うべき関税やZCRMサービスはありません。支払う必要があるのは電話と番号だけです（たとえば、特別料金の場合、モスクワの番号の月額料金は95ルーブル、ロンドンの場合は1ユーロです）。そして、ほとんど電話がない場合はどうなりますか？あなたはほとんど支払う必要はありません。

無料のPBXZadarmaがアクティブな間、無料のCRMがアクティブになります。登録後、PBXは2週間有効ですが、今後は3か月に1回、任意の金額をアカウントに補充する必要があります。CRMとPBXを必要とするが、番号や電話をまったく必要としないオフィスを想像するのは難しいです。



無料のCRM用のAPIが必要な理由



ZCRMの開発は一瞬止まらず、大小さまざまな機能が登場しています。しかし、スマートアドレスブックだけでなく、真に機能的なシステムを提示するには、電話と統合するだけでは不十分であることを理解しています。

クライアントとの連絡が多ければ多いほど良くなり、連絡先は大きく異なる可能性があります。 APIのおかげで、クライアント/リードおよびタスクに関する情報を問題なく自動的に入力（または逆に受信）できます。これにより、あらゆる通信チャネルを顧客やその他の自動化システムに接続することが可能になります。

APIのおかげで、無料のZCRMは、全体的または部分的に、あらゆる方法で使用できます。たとえば、企業の顧客ベースを操作するための便利なインターフェイスとして、または単純な便利なプランナーとして。

以下は、そのようなチャネルの例です-サイトのリードフォームのCRMに接続します。Webサイトの後半で、他の例を示します。たとえば、クライアントにコールバックするタスク（遅延呼び出し）を作成します。



基本的なZCRMAPIメソッド



ZCRM APIでは37のメソッドを使用できるため、それらすべてを説明することは控え、例を使用してそれらの主要なグループのみを説明します。

例を含む完全なリストは、CRMAPIの説明のWebサイトで入手できます。



次のグループのメソッドを使用できます。

  • クライアント（一般リスト、個別の選択、編集、削除）
  • クライアントタグと追加のプロパティ
  • カスタマーフィード（カスタマーフィードのレコードの表示、編集、削除）
  • クライアントの従業員（クライアントは通常、法人であるため、多くの従業員がいる場合があります）
  • タスク（タスクを操作するためのすべての機能）
  • リード（すべての機能と同様）
  • RMユーザー（ユーザー、ユーザーの権利、設定、連絡先、および勤務時間のリストを表示する）
  • 呼び出し（呼び出しリストを返します）




既存のZadarmaAPI構造が使用されているため、そのライブラリはGithubのPHP、C＃、Pythonですでに利用可能です。



APIの使用例



最も単純でありながら最も有用な例は、フォームからリードを作成することです。コードを最小限に抑えるために、この例には基本的なリードデータのみが含まれています。同様の例ですが、すでにクライアントからのコメント（通常はすべてのフォームに存在します）がサイトのブログで入手できます。スクリプトの例はフレームワークなしでPHPで記述されているため、簡単に埋め込むことができます。

リードを作成するためのhtmlフォームの例： 



<form method="POST" action="/zcrm_leads">
   <label for="name">Name:</label>
   <br>
   <input type="text" id="name" name="name" value="">
   <br>
   <label for="phone">Phone:</label><br>
   <input type="text" id="phone" name="phones[0][phone]" value="">
   <br>
   <label for="phone">Email:</label><br>
   <input type="text" id="email" name="contacts[0][value]" value="">
   <br>
   <br>
   <input type="submit" value="Submit">
</form>




このフォームは、記事が過負荷にならないように非常にシンプルです。デザイン、キャプチャ、コメントフィールドはありません。コメントフィールドのあるバージョンは、ブログで入手できます（リードを作成した後、コメントが顧客のフィードに追加されます）。



そして、フォームからのデータを使用してリードを作成するための実際のPHPの例： 



<?php
$postData = $_POST;
if ($postData) {
   if (isset($postData['phones'], $postData['phones'][0], $postData['phones'][0]['phone'])) {
       $postData['phones'][0]['type'] = 'work';
   }
   if (isset($postData['contacts'], $postData['contacts'][0], $postData['contacts'][0]['value'])) {
       $postData['contacts'][0]['type'] = 'email_work';
   }
   $params = ['lead' => $postData];
   $params['lead']['lead_source'] = 'form';

   $leadData = makePostRequest('/v1/zcrm/leads', $params);
   var_dump($leadData);
}
exit();

function makePostRequest($method, $params)
{
   //  userKey  secret     
   $userKey = '';
   $secret = '';
   $apiUrl = 'https://api.zadarma.com';

   ksort($params);

   $paramsStr = makeParamsStr($params);
   $sign = makeSign($paramsStr, $method, $secret);

   $curl = curl_init();
   curl_setopt($curl, CURLOPT_URL, $apiUrl . $method);
   curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'POST');
   curl_setopt($curl, CURLOPT_POST, true);
   curl_setopt($curl, CURLOPT_CONNECTTIMEOUT, 10);
   curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
   curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
   curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
   curl_setopt($curl, CURLOPT_POSTFIELDS, $paramsStr);
   curl_setopt($curl, CURLOPT_HTTPHEADER, [
       'Authorization: ' . $userKey . ':' . $sign
   ]);

   $response = curl_exec($curl);
   $error = curl_error($curl);

   curl_close($curl);

   if ($error) {
       return null;
   } else {
       return json_decode($response, true);
   }
}

/**
* @param array $params
* @return string
*/
function makeParamsStr($params)
{
   return http_build_query($params, null, '&', PHP_QUERY_RFC1738);
}

/**
* @param string $paramsStr
* @param string $method
* @param string $secret
*
* @return string
*/
function makeSign($paramsStr, $method, $secret)
{
   return base64_encode(
       hash_hmac(
           'sha1',
           $method . $paramsStr . md5($paramsStr),
           $secret
       )
   );
}




ご覧のとおり、APIの操作は非常に簡単です。さらに、PHP、C＃、Pythonでの操作の例があります。したがって、問題なく、「わずかな血で」自動化されたシンプルな無料のCRMを任意のワークフローに適合させることができます。

ZCRMは絶えず進化しており、APIを含め、ほぼすべての新機能が利用可能になります。

また、既存のシステムシステムを無料のCRMおよびZadarmaPBXと統合することをお勧めします。


More articles:


All Articles