API für 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 bereitstellt. Die API ermöglicht die Nutzung des CRM für alle Vertriebskanäle.
Im Folgenden geben wir einen kurzen Überblick über die Arbeit mit der API und die verfügbaren Funktionen. Außerdem finden Sie ein einfaches, aber nützliches Beispiel: ein Skript zur Erstellung eines Leads aus einem Formular auf der Website.

Kurzes über das kostenlose CRM

Wir verzichten darauf, zu erklären, was ein CRM ist. Kostenloses CRM Zadarma unterstützt alle Standardfunktionen zur Speicherung von Kundendaten. Informationen werden im Kundenfeed gespeichert. Darüber hinaus steht ein praktischer Aufgabenmanager zur Verfügung, der in verschiedenen Ansichten angezeigt werden kann (Kalender, Kanban, Liste). All das ist für über 50 Mitarbeiter verfügbar und vollständig in die Telefonie integriert (einschließlich Anrufe aus dem Browser mit WebRTC-Technologie).

Was bedeutet kostenlos? Es gibt keinen Tarif oder Dienst von ZCRM, für den man bezahlen muss. Die einzige Zahlung, die erforderlich ist, sind Telefonanrufe und Nummern (zum Beispiel beträgt die Grundgebühr für eine Moskauer Nummer 95 Rubel oder für eine Londoner Nummer 1 Euro). Und wenn es fast keine Anrufe gibt? Dann muss man auch fast nicht bezahlen.
Die kostenlose CRM ist aktiv, solange die kostenlose Telefonanlage von Zadarma aktiv ist. Nach der Registrierung ist die Telefonanlage 2 Wochen lang aktiv, danach muss man das Konto einmal alle 3 Monate mit einem beliebigen Betrag aufladen. Es ist schwer sich ein Büro vorzustellen, das eine CRM und eine Telefonanlage benötigt, aber überhaupt keine Nummer oder Anrufe.

Warum wird ein API für die kostenlose CRM benötigt?

Die Entwicklung von ZCRM stoppt keinen Moment; es sind viele große und kleine Funktionen hinzugekommen. Aber wir verstehen, dass es für eine wirklich funktionale Lösung, und nicht nur für ein intelligentes Notizbuch, mehr als nur eine Integration mit der Telefonie benötigt.
Je mehr Kontakt mit dem Kunden, desto besser – und die Kontakte können sehr unterschiedlich sein. Dank der API kann man problemlos automatisch Informationen über den Kunden/Leads und Aufgaben erfassen oder abrufen. Dadurch ergibt sich die Möglichkeit, verschiedene Kommunikationskanäle mit den Kunden und andere Automatisierungssysteme anzuschließen.
Dank der API kann ZCRM kostenlos auf jede erdenkliche Weise genutzt werden, sowohl vollständig als auch teilweise. Zum Beispiel als benutzerfreundliche Oberfläche für die Arbeit mit der Unternehmensdatenbank oder als einfacher, praktischer Planer.
Im Folgenden geben wir ein Beispiel für einen solchen Kanal: die Verbindung von CRM-Lead-Formularen auf der Website. Später werden wir auf der Website auch andere Beispiele präsentieren, wie zum Beispiel die Erstellung einer Aufgabe, um den Kunden zurückzurufen (einen geplanten Anruf).

Die Hauptmethoden der ZCRM-API

Da in der ZCRM-API 37 Methoden verfügbar sind, werden wir auf die Beschreibung aller verzichten und nur die wichtigsten Gruppen mit Beispielen vorstellen.
Eine vollständige Liste mit Beispielen ist auf der Website verfügbar unter Beschreibung der CRM-API.

Die Arbeit mit den folgenden Gruppen von Methoden ist möglich:

• Kunden (allgemeine Liste, einzelne Abfragen, Bearbeitung, Löschung)
• Tags und zusätzliche Eigenschaften von Kunden
• Kunden-Feed (Anzeige, Bearbeitung und Löschung von Einträgen im Kunden-Feed)
• Mitarbeiter des Kunden (da der Kunde in der Regel eine juristische Person ist, kann es nicht wenige Mitarbeiter geben)
• Aufgaben (vollständige Funktionen zur Aufgabenverwaltung)
• Leads (analog alle Funktionen)
• CRM-Benutzer (Anzeige der Benutzerliste, deren Rechte, Einstellungen, Kontakte und Arbeitszeiten)
• Anrufe (gibt eine Liste von Anrufen zurück)

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

Beispiel für die API-Nutzung

Das einfachste und gleichzeitig nützliche Beispiel ist die Erstellung eines Leads aus einem Formular. Um den Code zu minimieren, enthält dieses Beispiel nur die grundlegenden Informationen des Leads. Ein ähnliches Beispiel, jedoch mit Kommentaren vom Kunden (die normalerweise in jedem Formular vorhanden sind), ist verfügbar im Blog auf der Website. Die Skriptbeispiele sind geschrieben in PHP ohne Frameworks und lassen sich daher leicht 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="Absenden">
<input type="hidden" name="trp-form-language" value="de"/></form>

Dieses Formular ist extrem einfach gehalten, um den Artikel nicht zu überladen. Es hat kein Design, keine Captcha und kein Kommentarfeld. In unserem Blog ist eine Version mit Kommentarfeld verfügbar (Kommentare werden 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 persönlichen Zugangsdaten
   $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, zudem gibt es Beispiele auf PHP, C#, Python. So lässt sich problemlos eine einfache kostenlose CRM in jeden Arbeitsprozess integrieren und eine Automatisierung mit minimalem Aufwand erreichen.
ZCRM entwickelt sich kontinuierlich weiter, und praktisch alle neuen Funktionen werden auch über die API verfügbar sein.
Außerdem laden wir Sie ein, Ihre bestehenden Systeme mit den kostenlosen CRMs und der Zadarma-VoIP zu integrieren.

Quelle: habr.com