Integración de un sistema CRM a través de la API¶
Para integrar un sistema CRM con R7K12, es imprescindible utilizar dos métodos de la API:
Para qué sirve el método setStatuses¶
Por ejemplo, en su CRM tiene los siguientes estados:
- Nuevo
- Enviado a preparación
- Disponibilidad confirmada
- En preparación
- Acordado con el cliente
- En entrega
- Finalizado
Usted quiere analizar todo el embudo del negocio por estados. ¿Qué hay que hacer para ello?
Estados por grupos en R7K12¶
Para distinguir en la analítica de R7K12, entre todos sus negocios (pedidos), las solicitudes objetivo, las ventas y las solicitudes canceladas, en R7K12 existen cuatro grupos de estados: «No contabilizado», «En curso», «Completado», «Cancelado».
Los estados de su CRM deben distribuirse entre estos grupos. Así, en las columnas de la analítica verá:
- Columna «Solicitudes» - aquí se cuentan los negocios cuyos estados están distribuidos en los grupos «En curso», «Completado», «Cancelado».
- Columna «Ventas» - se cuentan los negocios cuyos estados están distribuidos en el grupo «Completado».
- Columna «Solicitudes canceladas» - negocios cuyos estados están distribuidos en el grupo «Cancelado».
- Columna «Negocios» - se contabilizan todos los negocios del sistema CRM (es decir, de todos los grupos de estados).
- Columna «Consultas» - se cuentan todas las consultas de todos los negocios (un negocio puede tener varias consultas del cliente). Una consulta es una llamada del cliente, una solicitud desde el sitio web, un mensaje al email, etc.
Para asignar a cada uno de sus estados de negocio del CRM un grupo de estados en R7K12, es necesario enviarnos una sola vez a través de la API la distribución de estados (como en la imagen de arriba) mediante el método setStatuses. Si en algún momento cambian los estados en su CRM, envíe después los datos actualizados. Encontrará un ejemplo de código en la descripción del método.
Para qué sirve el método addLeads¶
Una vez distribuidos los estados por grupos en R7K12, puede enviar negocios con un estado de grupo determinado. Así, en la analítica podrá ver el número de solicitudes objetivo (columna «Solicitudes»), de ventas, de solicitudes canceladas, el total de negocios y de consultas. Además, podrá ver qué fuente le aportó cada uno de esos negocios. El método tiene campos obligatorios y opcionales. Por lo tanto, el conjunto mínimo de campos para enviar datos contiene los campos obligatorios. Entre los campos opcionales está el campo r7k12id -identificador de la visita. Sí, puede enviar correctamente el método sin este campo (o con el campo vacío). Pero entonces todos los negocios irán a la fuente «Sin visita» y quedarán sin determinar. Es decir, no verá de qué fuente procedieron las solicitudes y las ventas. Por eso el campo r7k12id debe estar definido. Para ello es necesario instalar nuestro código de seguimiento según las instrucciones - Instalación del código de seguimiento. En caso de una visita al sitio web tras instalar el código de seguimiento de R7K12, el valor del identificador será numérico. Para las fuentes offline, en el valor de r7k12id se puede enviar el nombre de la fuente. Utilice los ejemplos detallados del método de la API - addLeads.