API para CRM gratuita

API para CRM gratuita

Hace menos de un año, presentamos un sistema CRM gratuito integrado con una centralita gratuita. Desde entonces, 14,000 empresas y 64,000 empleados lo han utilizado.
Ahora ofrecemos una interfaz API abierta que permite acceder a la mayoría de las funciones de ZCRM. La API permite usar CRM para cualquier canal de ventas.
A continuación, describiremos brevemente cómo trabajar con la API y las funciones disponibles. También incluimos un ejemplo simple pero útil: un script para crear un lead desde un formulario en el sitio web.

Breve introducción a la CRM gratuita

Nos abstendremos de explicar qué es una CRM. CRM gratuita Zadarma admite todas las funciones estándar para el almacenamiento de datos de clientes. La información se guarda en el historial del cliente. Además, está disponible un gestor de tareas fácil de usar con visualización a tu gusto (calendario, kanban, lista). Todo esto está disponible para más de 50 empleados y completamente integrado con la telefonía (incluyendo llamadas desde el navegador utilizando tecnología WebRTC).
API para CRM gratuita
¿Qué significa gratuito? No hay ninguna tarifa o servicio de ZCRM por el que debas pagar. Lo único que se debe pagar es por las llamadas telefónicas y números (a tarifas especiales, por ejemplo, el costo mensual por un número en Moscú es de 95 rublos o en Londres 1 euro). ¿Y si casi no hay llamadas? Entonces prácticamente no se tiene que pagar.
La CRM gratuita está activa mientras la centralita gratuita de Zadarma esté activa. Después de registrarte, la centralita está activa durante 2 semanas, y luego se debe recargar la cuenta con cualquier monto una vez cada 3 meses. Es difícil imaginar una oficina que necesite CRM y una centralita, pero que realmente no requiera un número o llamadas.

¿Para qué se necesita una API para una CRM gratuita?

El desarrollo de ZCRM no se detiene ni un minuto, han surgido muchas funciones grandes y pequeñas. Pero entendemos que para presentar un sistema realmente funcional, y no solo una libreta inteligente, no es suficiente con integrar solo la telefonía.
Cuantos más contactos tengas con un cliente, mejor, y los contactos pueden ser de diferentes tipos. Gracias a la API, es posible ingresar automáticamente (o viceversa, obtener) información sobre el cliente/lead y tareas sin problemas. Esto permite conectar cualquier canal de comunicación con clientes y cualquier otro sistema de automatización.
Gracias a la API, se puede utilizar ZCRM de forma gratuita de cualquier manera, ya sea en su totalidad o en parte. Por ejemplo, como una interfaz conveniente para trabajar con la base de datos corporativa de clientes, o como un simple y práctico planificador.
A continuación, se presentará un ejemplo de dicho canal: la conexión a un formulario de generación de leads en el sitio web. Más adelante, presentaremos otros ejemplos, como la creación de una tarea para volver a llamar al cliente (llamada pospuesta).

Métodos principales de la API ZCRM

Dado que en la API ZCRM hay disponibles 37 métodos, evitaremos describir todos ellos y nos centraremos solo en los grupos principales con ejemplos.
La lista completa con ejemplos está disponible en el sitio web en la descripción de la API CRM.

Es posible trabajar con los siguientes grupos de métodos:

  • Clientes (lista general, selecciones específicas, edición, eliminación)
  • Etiquetas y propiedades adicionales de los clientes
  • Seguimiento del cliente (visualización, edición, eliminación de registros en los seguimientos de clientes)
  • Empleados del cliente (dado que el cliente es generalmente una entidad jurídica, puede tener varios empleados)
  • Tareas (toda la funcionalidad relacionada con las tareas)
  • Leads (de manera similar, todas las funciones)
  • Usuarios de CRM (visualización de la lista de usuarios, sus permisos, configuraciones, contactos y horarios de trabajo)
  • Llamadas (devuelve la lista de llamadas)

Dado que se utiliza la estructura existente de la API Zadarma, ya están disponibles bibliotecas en PHP, C#, Python en Github.

Ejemplo de uso de la API

El ejemplo más simple y útil es la creación de un lead a partir de un formulario. Para minimizar el código, este ejemplo contiene solo los datos básicos del lead. Un ejemplo similar, pero con comentarios del cliente (que generalmente están presentes en cada formulario) está disponible en el blog del sitio web. Los ejemplos de scripts están escritos en PHP sin frameworks, por lo que son fáciles de integrar.
Ejemplo de formulario HTML para crear un lead:

<form method="POST" action="/es/zcrm_leads/" data-trp-original-action="/zcrm_leads">
   <label for="name">Nombre:</label>
   <br>
   <input type="text" id="name" name="name" value="">
   <br>
   <label for="phone">Teléfono:</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="Enviar">
<input type="hidden" name="trp-form-language" value="es"/></form>

Este formulario es extremadamente simple para no sobrecargar el artículo. No tiene diseño, captcha ni campo de comentarios. En nuestro blog hay disponible una versión con un campo de comentarios (el comentario se añade al seguimiento del cliente después de crear el lead).

Y aquí está el ejemplo en PHP para crear un lead con los datos del formulario:

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

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

function makePostRequest($method, $params)
{
   \/\/ Reemplace userKey y secret con los de su panel personal
   $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
       )
   );
}

Como puede ver, trabajar con la API es bastante sencillo, además hay ejemplos de uso en PHP, C#, Python. Así, se puede integrar una CRM gratuita simple en cualquier flujo de trabajo sin problemas, logrando automatización con un bajo esfuerzo.
ZCRM está en constante evolución y prácticamente todas las nuevas funciones estarán disponibles también a través de la API.
También invitamos a integrar sus sistemas existentes con las CRM y ATS gratuitas de Zadarma.

Fuente: habr.com

Compra un hosting fiable para sitios web con protección contra DDoS, servidores VPS VDS 🔥 Compra un hosting fiable para sitios web con protección contra DDoS, servidores VPS VDS | ProHoster