Minder dan een jaar geleden hebben we een gratis CRM-systeem geĆÆntroduceerd dat geĆÆntegreerd is met een gratis telefooncentrale. In deze tijd hebben 14.000 bedrijven en 64.000 medewerkers er gebruik van gemaakt.
Momenteel bieden we een open API-interface aan, waarin de meeste functies van ZCRM beschikbaar zijn. De API stelt je in staat om CRM voor alle verkoopkanalen te gebruiken.
Hieronder beschrijven we kort het gebruik van de API en de beschikbare functionaliteit. Ook geven we een eenvoudig maar nuttig en werkend voorbeeld: een script voor het aanmaken van een lead vanuit een formulier op de website.
Kort over de gratis CRM
Laten we uitleggen wat CRM is. Zadarma ondersteunt alle standaard functies voor het opslaan van klantgegevens. Informatie wordt opgeslagen in de klantstream. Naast het klantinformatiebeheer is er ook een handige taakplanner met weergave naar keuze (kalender, kanban, lijst). Dit alles is beschikbaar voor 50+ medewerkers en volledig geĆÆntegreerd met telefonie (inclusief browsergebonden oproepen via WebRTC).
Wat betekent gratis? Er is geen enkel tarief of dienst voor ZCRM waarvoor je moet betalen. Het enige waarvoor je moet betalen, zijn telefoongesprekken en nummers (tegen speciale tarieven, bijvoorbeeld het abonnement voor een Moskou-nummer is 95 roebel of 1 euro voor Londen). En als er bijna geen gesprekken zijn? Dan hoef je ook bijna niet te betalen.
De gratis CRM is actief zolang de gratis telefooncentrale van Zadarma actief is. Na registratie is de telefooncentrale 2 weken actief, daarna moet je elke 3 maanden je saldo met een willekeurig bedrag aanvullen. Het is moeilijk voor te stellen dat een kantoor een CRM en telefooncentrale nodig heeft, maar geen nummer of telefoongesprekken.
Waarom heb je een API nodig voor gratis CRM?
De ontwikkeling van ZCRM stopt geen moment; er zijn tal van grote en kleine functies toegevoegd. Maar we begrijpen dat om een werkelijk functioneel systeem te presenteren, en niet alleen een slimme notitieboek, de integratie met telefonie alleen niet voldoende is.
Hoe meer contacten je met een klant hebt, hoe beter, en die contacten kunnen heel divers zijn. Dankzij de API kun je moeiteloos automatisch informatie over een klant/lead en taken invoeren (of omgekeerd ophalen). Hierdoor ontstaat de mogelijkheid om alle communicatiekanalen met klanten te koppelen en andere automatiseringssystemen.
Met de API kan de gratis ZCRM op elke manier worden gebruikt, zowel volledig als gedeeltelijk. Bijvoorbeeld als een handige interface voor het werken met de bedrijfsdatabase van klanten, of als een eenvoudige, gebruiksvriendelijke planner.
Hieronder geven we een voorbeeld van een dergelijk kanaal - de verbinding met de CRM leadformulieren op de website. Later op de site zullen we ook andere voorbeelden geven, zoals het creƫren van een taak om de klant terug te bellen (uitgestelde oproep).
Belangrijkste API-methoden van ZCRM
Aangezien er 37 methoden beschikbaar zijn in de ZCRM API, beperken we ons tot het beschrijven van de belangrijkste groepen met voorbeelden.
Een volledige lijst met voorbeelden is beschikbaar op de website in .
Er kan worden gewerkt met de volgende groepen methoden:
- Klanten (algemene lijst, aparte selecties, bewerking, verwijdering)
- Tags en extra eigenschappen van klanten
- Klantenfeed (weergeven, bewerken, verwijderen van records in klantenfeeds)
- Werknemers van de klant (aangezien de klant meestal een juridische entiteit is, kan deze veel werknemers hebben)
- Taken (alle functionaliteit voor het werken met taken)
- Leads (eveneens alle functies)
- CRM-gebruikers (weergeven van de gebruikerslijst, hun rechten, instellingen, contactgegevens en werkuren)
- Oproepen (geeft een lijst van oproepen terug)
Aangezien de bestaande structuur van de API Zadarma wordt gebruikt, zijn er al bibliotheken beschikbaar op Github in PHP, C#, Python.
Voorbeeld van het gebruik van de API
Het eenvoudigste en toch nuttige voorbeeld is het creƫren van een lead vanuit een formulier. Om de code te minimaliseren bevat dit voorbeeld alleen de basisgegevens van de lead. Een soortgelijk voorbeeld, maar met opmerkingen van de klant (die meestal in elk formulier aanwezig zijn) is beschikbaar op de website. Voorbeeldscripts zijn geschreven in PHP zonder frameworks en kunnen daarom gemakkelijk worden ingepast.
Voorbeeld van een HTML-formulier voor het creƫren van een lead:
<form method="POST" action="/nl/zcrm_leads/" data-trp-original-action="/zcrm_leads">
<label for="name">Naam:</label>
<br>
<input type="text" id="name" name="name" value="">
<br>
<label for="phone">Telefoon:</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="Verzenden">
<input type="hidden" name="trp-form-language" value="nl"/></form>
Dit formulier is uiterst eenvoudig om de artikelen niet te overladen. Het heeft geen ontwerp, geen captcha en geen opmerkingenveld. In onze blog is er een versie beschikbaar met een opmerkingenveld (de opmerking wordt aan de klantenfeed toegevoegd na het creƫren van de lead).
En hier is een PHP-voorbeeld van het creƫren van een lead met gegevens uit het formulier:
$postData];
$params['lead']['lead_source'] = 'form';
$leadData = makePostRequest('/v1/zcrm/leads', $params);
var_dump($leadData);
}
exit();
function makePostRequest($method, $params)
{
// vervang userKey en secret door uw eigen gegevens uit uw account
$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
)
);
}
Zoals u kunt zien, is het werken met de API vrij eenvoudig, plus er zijn voorbeelden van gebruik op , , . Hierdoor kan een eenvoudige gratis CRM zonder al te veel moeite in elk werkproces worden geĆÆntegreerd, wat zorgt voor automatisering met minimale inspanning.
ZCRM ontwikkelt zich voortdurend en bijna alle nieuwe functies zullen ook via de API beschikbaar zijn.
Daarnaast nodigen we u uit om uw bestaande systemen te integreren met de gratis CRM en de telefoniesystemen van Zadarma.
Bron: habr.com
