Kostenlose CRM-API

Vor weniger als einem Jahr haben wir ein kostenloses CRM-System eingeführt, das in eine kostenlose Telefonanlage integriert ist. In dieser Zeit haben es 14 Unternehmen und 000 Mitarbeiter genutzt.
Jetzt bieten wir eine offene API-Schnittstelle an, in der die meisten Funktionen von ZCRM verfügbar sind. Die API ermöglicht Ihnen die Nutzung von CRM für beliebige Vertriebskanäle.
Im Folgenden beschreiben wir kurz die Arbeit mit der API und die verfügbare Funktionalität. Außerdem wird ein einfaches, aber nützliches und funktionierendes Beispiel gegeben: ein Skript zum Erstellen eines Leads aus einem Formular auf der Website.

Kurz über kostenloses CRM

Lassen Sie uns nicht erklären, was CRM ist. Kostenloses CRM Zadarma unterstützt alle Standardfunktionen zur Speicherung von Kundendaten. Die Informationen werden im Feed des Kunden gespeichert. Zusätzlich zu den Kundeninformationen steht ein komfortabler Aufgabenmanager mit einer Anzeige für jeden Geschmack (Kalender, Kanban, Liste) zur Verfügung. All dies ist für mehr als 50 Mitarbeiter verfügbar und vollständig in die Telefonie integriert (einschließlich Anrufen über einen Browser mithilfe der WebRTC-Technologie).

Was bedeutet kostenlos? Es gibt keine ZCRM-Tarife oder -Dienste, für die Sie bezahlen müssen. Das Einzige, was Sie bezahlen müssen, sind Telefongespräche und Nummern (nach Sondertarifen beträgt die monatliche Gebühr für eine Nummer in Moskau beispielsweise 95 Rubel oder in London 1 Euro). Und wenn es fast keine Anrufe gibt? Sie müssen fast nichts bezahlen.
Das kostenlose CRM ist aktiv, während die kostenlose PBX Zadarma aktiv ist. Nach der Registrierung ist die PBX 2 Wochen lang aktiv, in Zukunft ist es notwendig, das Konto alle 1 Monate um einen beliebigen Betrag aufzufüllen. Es ist schwer, sich ein Büro vorzustellen, das CRM und PBX benötigt, aber überhaupt keine Nummern oder Anrufe benötigt.

Warum Sie eine API für kostenloses CRM benötigen

Die Entwicklung von ZCRM hört keine Minute auf, viele große und kleine Funktionen sind erschienen. Wir verstehen jedoch, dass die Integration der Telefonie nicht ausreicht, um ein wirklich funktionierendes System und nicht nur ein intelligentes Notebook zu präsentieren.
Je mehr Kontakte mit dem Kunden, desto besser, und die Kontakte können sehr unterschiedlich sein. Dank der API können Sie problemlos automatisch Informationen über den Kunden/Lead und Aufgaben eingeben (oder im Gegenteil empfangen). Dadurch ist es möglich, beliebige Kommunikationskanäle mit Kunden und anderen Automatisierungssystemen zu verbinden.
Dank der API kann das kostenlose ZCRM ganz oder teilweise beliebig genutzt werden. Zum Beispiel als komfortable Schnittstelle für die Arbeit mit einem Firmenkundenstamm oder als einfacher komfortabler Terminplaner.
Unten sehen Sie ein Beispiel für einen solchen Kanal – die Verbindung zu CRM-Lead-Formularen auf der Website. Später auf der Website werden wir weitere Beispiele nennen, zum Beispiel das Erstellen einer Aufgabe zum Rückruf des Kunden (verzögerter Anruf).

Grundlegende ZCRM-API-Methoden

Da in der ZCRM-API 37 Methoden verfügbar sind, verzichten wir darauf, sie alle zu beschreiben, sondern beschreiben nur ihre Hauptgruppen anhand von Beispielen.
Eine vollständige Liste mit Beispielen finden Sie auf der Website unter Beschreibung der CRM-API.

Es ist möglich, mit folgenden Methodengruppen zu arbeiten:

• Kunden (allgemeine Liste, separate Auswahl, Bearbeiten, Löschen)
• Tags und zusätzliche Eigenschaften von Clients
• Kundenfeed (Einträge in Kundenfeeds anzeigen, bearbeiten, löschen)
• Mitarbeiter des Kunden (da es sich bei dem Kunden in der Regel um eine juristische Person handelt, kann dieser über eine ganze Reihe von Mitarbeitern verfügen)
• Aufgaben (alle Funktionen zum Arbeiten mit Aufgaben)
• Leads (ebenso alle Funktionen)
• CRM-Benutzer (Anzeige einer Liste der Benutzer, ihrer Rechte, Einstellungen, Kontakte und Arbeitszeiten)
• Anrufe (gibt eine Liste der Anrufe zurück)

Da die bestehende Zadarma-API-Struktur genutzt wird, stehen dafür bereits Bibliotheken in PHP, C#, Python auf Github zur Verfügung.

Beispiel für die API-Nutzung

Das einfachste und zugleich nützlichste Beispiel ist das Erstellen eines Leads aus einem Formular. Um den Code auf ein Minimum zu beschränken, enthält dieses Beispiel nur die grundlegenden Lead-Daten. Ein ähnliches Beispiel, jedoch mit Kommentaren des Kunden (normalerweise in jeder Form vorhanden), ist verfügbar auf dem blog auf der Seite. Skriptbeispiele sind eingeschrieben PHP ohne Gerüste und daher einfach einzubetten.
Ein Beispiel für ein HTML-Formular zum Erstellen eines Leads:

<form method="POST" action="/de/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>

Dieses Formular ist äußerst einfach gehalten, um den Artikel nicht zu überladen. Es hat kein Design, kein Captcha, kein Kommentarfeld. Eine Version mit Kommentarfeld ist in unserem Blog verfügbar (der Kommentar wird dem Feed des Kunden hinzugefügt, nachdem der Lead erstellt wurde).

Und tatsächlich ein PHP-Beispiel zum Erstellen eines Leads mit Daten aus dem Formular:

<?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
       )
   );
}

Wie Sie sehen, ist die Arbeit mit der API recht einfach, außerdem gibt es Beispiele für die Bearbeitung PHP, C#, Python. Somit können Sie problemlos ein einfaches kostenloses CRM in jeden Arbeitsablauf integrieren und die Automatisierung mit wenig Aufwand erhalten.
ZCRM entwickelt sich ständig weiter und fast alle neuen Funktionen werden über die API verfügbar sein.
Wir laden Sie auch ein, Ihre bestehenden Systemsysteme mit kostenlosem CRM und PBX Zadarma zu integrieren.

Source: habr.com