API för gratis CRM

För mindre än ett år sedan introducerade vi ett gratis CRM-system integrerat med en gratis PBX. Under denna tid har 14 000 företag och 64 000 anställda använt det.
Nu erbjuder vi ett öppet API-gränssnitt där de flesta funktionerna i ZCRM är tillgängliga. API:t tillåter användning av CRM för alla försäljningskanaler.
Nedan beskriver vi kort hur man arbetar med API:t och dess tillgängliga funktioner. Vi har även inkluderat ett enkelt men användbart exempel: ett skript för att skapa en lead från ett formulär på webbplatsen.

Kort om gratis CRM

Vi avstår från att förklara vad CRM är. Gratis CRM Zadarma stöder alla standardfunktioner för lagring av kunddata. Information sparas i kundens flöde. Utöver information om kunder finns också en praktisk uppgiftshanterare med visning enligt olika preferenser (kalender, kanban, lista). Allt detta är tillgängligt för över 50 anställda och är helt integrerat med telefoni (inklusive samtal från webbläsaren via WebRTC-teknik).

Vad betyder gratis? Det finns inga avgifter eller tjänster i ZCRM som kostar. Det enda du behöver betala för är telefon samtal och nummer (till specialpriser, till exempel månadsavgiften för ett nummer i Moskva är 95 rubel eller i London 1 euro). Och om det nästan inte finns några samtal? Då behöver du knappt betala.
Gratis CRM är aktivt så länge den gratis PBX Zadarma är aktiv. Efter registreringen är PBX:n aktiv i 2 veckor, därefter måste kontot fyllas på med valfritt belopp en gång var tredje månad. Det är svårt att föreställa sig ett kontor som behöver en CRM och PBX, men utan behov av varken nummer eller samtal.

Varför behövs API för gratis CRM

Utvecklingen av ZCRM stannar aldrig, många både stora och små funktioner har tillkommit. Men vi förstår att för att erbjuda ett riktigt funktionellt system, och inte bara en smart anteckningsbok, är det inte tillräckligt med bara integrationen med telefoni.
Ju fler kontakter med kunden desto bättre, och dessa kontakter kan vara av olika slag. Tack vare API:t kan man automatiskt föra in (eller få tillbaka) information om kunden/lead och uppgifter utan problem. Därigenom öppnas möjligheten att ansluta alla kommunikationskanaler med kunder och andra automatiseringssystem.
Tack vare API:et kan gratis ZCRM användas på alla sätt, antingen helt eller delvis. Till exempel som ett bekvämt gränssnitt för att arbeta med företagskundbasen, eller som en enkel och praktisk planeringsverktyg.
Nedan ger vi ett exempel på en sådan kanal - anslutning till CRM lead-formulär på webbplatsen. Senare på webbplatsen kommer vi också att ge andra exempel, till exempel att skapa en uppgift för att ringa tillbaka till kunden (vidarebefordrad samtal).

Huvudmetoder för API:et ZCRM

Eftersom det finns 37 metoder tillgängliga i API:et ZCRM avstår vi från att beskriva alla, vi beskriver bara de viktigaste grupperna med exempel.
En komplett lista med exempel finns på webbplatsen i beskrivningen av API:et CRM.

Det är möjligt att arbeta med följande metodgrupper:

• Kunder (allmän lista, specifika urval, redigering, borttagning)
• Taggar och ytterligare egenskaper för kunder
• Kundens flöde (visa, redigera, ta bort poster i kundernas flöden)
• Kundens anställda (eftersom kunden vanligtvis är en juridisk person kan de ha många anställda)
• Uppgifter (all funktionalitet för att arbeta med uppgifter)
• Leads (likaså alla funktioner)
• CRM-användare (visning av användarlistan, deras rättigheter, inställningar, kontakter och arbetstider)
• Samtal (returnerar en lista över samtal)

Eftersom den befintliga API-strukturen för Zadarma används, finns det redan bibliotek tillgängliga på Github för den i PHP, C#, Python.

Exempel på användning av API:et

Det enklaste och samtidigt mest användbara exemplet är att skapa ett lead från formuläret. För att minimera koden innehåller detta exempel endast grundläggande lead-information. Ett liknande exempel, men med kommentarer från kunden (som vanligtvis ingår i varje formulär) finns tillgängligt i bloggen på webbplatsen. Exempelspelen är skrivna i PHP utan ramverk och kan därför enkelt integreras.
Exempel på HTML-formulär för att skapa ett lead:

<form method="POST" action="/sv/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Namn:</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-post:</label><br>
   <input type="text" id="email" name="contacts[0][value]" value="">
   <br>
   <br>
   <input type="submit" value="Skicka">
<input type="hidden" name="trp-form-language" value="sv"/></form>

Detta formulär är extremt enkelt för att inte overbelasta artikeln. Det har varken design, captcha eller kommentarsfält. En version med kommentarsfält finns tillgänglig i vår blogg (kommentaren läggs till i kundens flöde efter att leadet skapats).

Och här är ett PHP-exempel för att skapa ett lead med data från formuläret:

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

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

function makePostRequest($method, $params)
{
   \/\/ ersätt userKey och secret med dina från ditt konto
   $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
*\n* @return string
*\/ 
function makeSign($paramsStr, $method, $secret)
{
   return base64_encode(
       hash_hmac(
           'sha1',
           $method . $paramsStr . md5($paramsStr),
           $secret
       )
   );
}

Som ni ser är det ganska enkelt att arbeta med API:er, plus att det finns exempel på hur man arbetar med PHP, C#, Python. På så sätt kan man utan större problem integrera en enkel gratis CRM i vilket arbetsflöde som helst, med minimal ansträngning för att uppnå automatisering.
ZCRM utvecklas kontinuerligt och nästan alla nya funktioner kommer även att bli tillgängliga via API.
Vi bjuder också in er att integrera era befintliga system med de gratis CRM och ATC-tjänster som Zadarma erbjuder.

Källa: habr.com