API für die kostenlose CRM

Vor weniger als einem Jahr haben wir ein kostenloses CRM-System vorgestellt, das mit einer kostenlosen Telefonanlage integriert ist. In dieser Zeit haben 14.000 Unternehmen und 64.000 Mitarbeiter es genutzt.
Jetzt bieten wir eine offene API-Schnittstelle an, die die meisten Funktionen von ZCRM zur Verfügung stellt. Die API ermöglicht die Nutzung des CRM für alle Vertriebskanäle.
Im Folgenden beschreiben wir kurz die Arbeit mit der API und die verfügbaren Funktionen. Außerdem wird ein einfaches, aber nützliches und funktionierendes Beispiel angegeben: ein Skript zur Erstellung eines Leads aus einem Formular auf der Website.

Kurz über das kostenlose CRM

Wir verzichten darauf, zu erklären, was ein CRM ist. Kostenloses CRM Zadarma unterstützt alle Standardfunktionen zur Datenspeicherung über Kunden. Informationen werden im Kunden-Feed gespeichert. Darüber hinaus steht neben den Informationen zu Kunden ein praktischer Aufgabenmanager zur Verfügung, der nach Belieben angezeigt werden kann (Kalender, Kanban, Liste). All dies ist für über 50 Mitarbeiter verfügbar und vollständig in die Telefonie integriert (einschließlich Anrufen aus dem Browser über die WebRTC-Technologie).

Was bedeutet kostenlos? Es gibt keinen Tarif oder Dienst von ZCRM, für den man bezahlen müsste. Einzige Kosten fallen für Telefonanrufe und Nummern an (zum Beispiel beträgt die monatliche Gebühr für eine Moskauer Nummer 95 Rubel oder für London 1 Euro). Und wenn es fast keine Anrufe gibt? Dann müssen Sie auch fast nichts bezahlen.
Das kostenlose CRM ist aktiv, solange die kostenlose Telefonanlage von Zadarma aktiv ist. Nach der Registrierung ist die Telefonanlage zwei Wochen lang aktiv, danach muss das Guthaben alle drei Monate mit einem beliebigen Betrag aufgefüllt werden. Es ist schwer, sich ein Büro vorzustellen, das ein CRM und eine Telefonanlage benötigt, aber überhaupt keine Nummer oder Anrufe braucht.

Warum wird eine API für das kostenlose CRM benötigt?

Die Entwicklung von ZCRM ruht keinen Moment. Es sind viele große und kleine Funktionen hinzugekommen. Aber wir verstehen, dass es nicht ausreicht, nur eine Integration mit der Telefonie zu haben, um ein wirklich funktionales System anzubieten, und nicht nur ein kluges Notizbuch.
Je mehr Kontakte mit dem Kunden, desto besser, und die Kontakte können sehr unterschiedlich sein. Dank der API können Sie ohne Probleme automatisch Informationen über den Kunden/Lead und Aufgaben einfügen (oder umgekehrt abrufen). Dadurch entsteht die Möglichkeit, alle Kommunikationskanäle mit Kunden und andere Automatisierungssysteme anzubinden.
Dank der kostenlosen ZCRM-API kann diese auf beliebige Weise genutzt werden, sowohl vollständig als auch teilweise. Zum Beispiel als benutzerfreundliche Schnittstelle für die Arbeit mit der Unternehmensdatenbank der Kunden oder als einfacher praktischer Planer.
Im Folgenden geben wir ein Beispiel für einen solchen Kanal — die Anbindung eines CRM-Leads-Formulars auf der Website. Später werden auf der Website auch weitere Beispiele präsentiert, wie die Erstellung einer Aufgabe für eine Rückrufaktion (verschobener Anruf).

Die wichtigsten Methoden der ZCRM-API

Da in der ZCRM-API 37 Methoden zur Verfügung stehen, verzichten wir auf die Beschreibung aller. Wir beschreiben nur die wichtigsten Gruppen mit Beispielen.
Eine vollständige Liste mit Beispielen ist auf der Website im API CRM-Beschreibung.

Die folgenden Gruppen von Methoden können bearbeitet werden:

• Kunden (allgemeine Liste, spezielle Abfragen, Bearbeitung, Löschung)
• Tags und zusätzliche Eigenschaften von Kunden
• Kunden-Feed (Ansicht, Bearbeitung, Löschung von Einträgen im Kunden-Feed)
• Mitarbeiter des Kunden (da der Kunde in der Regel eine juristische Person ist, kann er viele Mitarbeiter haben)
• Aufgaben (die gesamte Funktionalität zur Bearbeitung von Aufgaben)
• Leads (entsprechend alle Funktionen)
• CRM-Nutzer (Anzeige der Benutzerliste, ihre Berechtigungen, Einstellungen, Kontakte und Arbeitszeiten)
• Anrufe (gibt die Liste der Anrufe zurück)

Da die bestehende Struktur der API von Zadarma verwendet wird, sind bereits Bibliotheken auf Github in PHP, C#, Python verfügbar.

Beispiel für die Verwendung der API

Das einfachste und gleichzeitig nützlichste Beispiel ist die Erstellung eines Leads aus einem Formular. Um den Code zu minimieren, enthält dieses Beispiel nur die grundlegenden Daten des Leads. Ein ähnliches Beispiel, jedoch mit Kommentaren vom Kunden (normalerweise in jedem Formular vorhanden), ist verfügbar im Blog auf der Website. Die Skriptbeispiele sind in PHP ohne Frameworks und daher leicht zu integrieren.
Beispiel für ein HTML-Formular zur Erstellung eines Leads:

<form method="POST" action="/de/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Name:</label>
   <br>
   <input type="text" id="name" name="name" value="">
   <br>
   <label for="phone">Telefon:</label><br>
   <input type="text" id="phone" name="phones[0][phone]" value="">
   <br>
   <label for="phone">E-Mail:</label><br>
   <input type="text" id="email" name="contacts[0][value]" value="">
   <br>
   <br>
   <input type="submit" value="Übermitteln">
<input type="hidden" name="trp-form-language" value="de"/></form>

Dieses Formular ist äußerst einfach, um den Artikel nicht zu überladen. Es hat weder ein Design noch ein Captcha oder ein Kommentarfeld. In unserem Blog ist eine Version mit einem Kommentarfeld verfügbar (Kommentar wird nach der Erstellung des Leads im Kunden-Feed hinzugefügt).

Und hier ist ein PHP-Beispiel zur Erstellung eines Leads mit den Daten aus dem Formular:

$postData];
   $params['lead']['lead_source'] = 'form';

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

function makePostRequest($method, $params)
{
   \/\/ Ersetzen Sie userKey und secret durch Ihre aus dem persönlichen Bereich
   $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 können, ist die Arbeit mit der API ziemlich einfach, und es gibt Beispiele für die Nutzung auf PHP, C#, Python. So lässt sich eine einfache, kostenlose CRM ohne größere Probleme in jeden Arbeitsprozess integrieren und bietet eine Automatisierung "mit wenig Aufwand".
ZCRM entwickelt sich kontinuierlich weiter, und fast alle neuen Funktionen werden auch über die API verfügbar sein.
Wir laden Sie auch ein, Ihre bestehenden Systeme mit der kostenlosen CRM- und PBX-Lösung von Zadarma zu integrieren.

Quelle: habr.com