Saltar a contenido

Integración con Bitrix24

Si su cuenta de Bitrix24 (leads + negocios) tiene permisos distintos de los de administrador, después de configurar la integración pueden producirse errores en la transmisión de información entre R7K12 y Bitrix24 (leads + negocios). Para comprobar los permisos en Bitrix24 (leads + negocios):

  1. En su cuenta personal de Bitrix24, abra la sección Empresa.
  2. Vaya a la pestaña Empleados.
  3. Pulse Editar junto al usuario de Bitrix24 (leads + negocios) que configurará la integración con R7K12:
  4. En la página de configuración del perfil del usuario, en el bloque Información del usuario, asegúrese de que está marcada la casilla Permitir al usuario editar el portal:

Cómo funciona la integración

Cuando se envía una solicitud en el sitio web, se crea automáticamente un nuevo negocio en el CRM, al que se transmite el identificador de la visita de la cookie del navegador r7k12_si en el campo adicional con el nombre r7k12id.

Configuración de la integración

Paso 1. Instale el contador en el sitio web

La descripción detallada de cómo instalar el contador en el sitio web se encuentra en la sección de ayuda Instalación de contadores.

Paso 2. Añada un campo adicional

Añada el campo personalizado r7k12id en las entidades «Lead» y «Negocio»:

  1. En Bitrix24, abra la pestaña CRM → Más → Configuración → Configuración de formularios e informes → Campos personalizados.

2. Para la entidad «Lead», pulsamos «Añadir campo»; en la ventana que se abre, en el campo «Nombre» introducimos «r7k12id» y en el campo «Tipo» seleccionamos «Cadena». 3. Del mismo modo, añadimos el campo r7k12id a la entidad «Negocio».

Paso 3. Conecte Bitrix24 en el catálogo de integraciones

En el sistema R7K12, vamos a la pestaña «Integraciones» y seleccionamos el bloque «Bitrix24». En la ventana que se abre, en el campo «Introduzca el portal», introducimos la dirección de su proyecto, que puede obtener de la URL de bitrix24. Por ejemplo, https://.bitrix24.ru; por lo tanto, tomamos .bitrix24.ru. En la esquina superior derecha, pulsamos «Crear». En su perfil de Bitrix24 se abrirá una página con información sobre la aplicación para la integración con R7K12. Marcamos las opciones «He leído y acepto el acuerdo de licencia» y «He leído y acepto la política de privacidad». Si la ventana con información sobre la aplicación para la integración con R7K12 no se abre y no la encuentra en el Marketplace, escríbanos y le ayudaremos. Marque las casillas He leído y acepto el acuerdo de licencia y He leído y acepto la política de privacidad y pulse Instalar. Para instalar la aplicación, su cuenta de Bitrix24 debe tener permisos de administrador. Si todo ha ido bien, se abrirá la siguiente ventana: Asignamos los estados de los negocios: Los estados de los negocios pueden tener los siguientes valores:

  1. «No contabilizado»: si al negocio se le asigna este estado, en la analítica aparece en la columna «Consultas».
  2. «En curso»: significa que el negocio aparece en la columna «Solicitudes».
  3. «Completado»: el negocio se ha cerrado con éxito y aparece en la columna «Ventas».
  4. «Cancelado»: significa que el negocio se ha cerrado sin realizarse y aparece en la columna «Solicitudes canceladas».

A continuación, seleccionamos los responsables del negocio: Seleccionamos el «Estado predeterminado»: Guardamos la configuración con el botón «Guardar», situado en la esquina superior derecha.

Paso 4. Configure el envío automático de negocios a Bitrix24

Session_id se almacena en:

  • las cookies del navegador (r7k12_si);
  • el almacenamiento local (localStorage) del navegador (r7k12_si);
  • la variable global de JS (r7k12_si).

Se recomienda obtener el ID de la visita mediante la función «R7K12_CallBack». Esta función se llamará automáticamente después de enviar el «pageview» y obtener el ID de la visita. La función debe declararse antes de la inicialización del script del contador. La información de los formularios puede enviarse al CRM tanto mediante PHP como mediante JavaScript. Los scripts son equivalentes y cumplen la misma función. 4.1. Script PHP:

<?php

$KEY = 'PROJECT KEY';//ключ проекта
$CRM = array(
    'r7k12id' => isset($_COOKIE['r7k12_si']) ? $_COOKIE['r7k12_si'] : null,
    'type' => 'Form',//Тип заявки (ОБЯЗЯТЕЛЬНО)
    'title' => 'Проверка макросов',//Заголовок заявки (НЕ ОБЯЗАТЕЛЬНО)
    'comment' => 'Коментарий к сделке',//Комментарий к сделке (НЕ ОБЯЗАТЕЛЬНО)
    'name' => 'Имя клиента',//Название контакта (НЕ ОБЯЗАТЕЛЬНО)
    'email' => '[email protected]',//E-mail адрес контакта (ОБЯЗАТЕЛЕН ЕСЛИ НЕ УКАЗАН ТЕЛЕФОН КОНТАКТА)
    'phone' => '380501234567',//Телефон контакта (ОБЯЗАТЕЛЕН ЕСЛИ НЕ УКАЗАН E-MAIL КОНТАКТА)
    'create_new_lead' => '1' //'0' - новая сделка создается только если нет сделки или предыдущая в статусе "успешно реализовано" или "возврат"; '1' - новая сделка создается в любом случае
);

$context = stream_context_create(array(
   'http' => array(
       'method' => 'POST',
       'content' => json_encode($CRM),
   ),
));
file_get_contents("https://r7k12.com/".$KEY."/crm/", false, $context);

Para el envío mediante PHP es más recomendable utilizar la biblioteca cURL en lugar de la función file_get_contents(). Ejemplo:

<?php
define('KEY','YOUR PROJECT KEY');
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://r7k12.com/'.KEY.'/crm/');
curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt(
    $curl,
    CURLOPT_POSTFIELDS,
    urlencode(
        json_encode(
            [
                'r7k12id' => !empty($_COOKIE['r7k12_si']) ? $_COOKIE['r7k12_si'] : null,
                'type' => 'Form',
                'comment' => 'Комментарий к сделке',
                'name' => 'Имя клиента',
                'email' => 'E-mail клиента',
                'phone' => 'Телефон клиента',
                'create_new_lead' => '0'
            ],
            JSON_UNESCAPED_UNICODE
        )
    )
);
$out = curl_exec($curl);
curl_close($curl);

4.2. JavaScript:

r7k12.push({
    hit: 'crm',
    data: {
        type: "Form",//тип заявки
        title: "Заявка с сайта",//Заголовок заявка
        comment: "Сделка созданная с фронта",//комментарий
        name: "Алексей Владимирович",//имя контакта
        phone: "8-912-345-67-89",//телефон
        fields: {//доп. поля
            lead: {
                cost: "{cost}",
                revenue: "{revenue}",
                price: 100,
                '127633': 'Текст'  // Заполнение доп. поля с ID ‘127633’
// Подробную информацию о наименовании полей и получить список доп. полей вы можете в документации Битрикс24: https://dev.1c-bitrix.ru/rest_help/crm/fields.php
            },
            contact: {
                '3124124': 'Текст' // Заполнение доп. поля с ID ‘3124124’
                // Подробную информацию о наименовании полей и получить список доп. полей вы можете в документации Битрикс24: https://dev.1c-bitrix.ru/rest_help/crm/fields.php
            }
        }
    }
});

Si el envío de formularios está configurado correctamente, en la pestaña «Registro de solicitudes» se mostrarán las solicitudes que llegan al sistema.

Conexión de los formularios CRM en Bitrix

Para hacer el seguimiento de las consultas de estos formularios, es necesario transmitir r7k12id a los negocios. Abra la configuración del formulario (en Bitrix: CRM -> Más -> Formularios CRM): Archivo abierto «Nota fotográfica» Seleccione el formulario deseado y pulse «Editar». En la parte inferior, pulse «Adicional». Archivo abierto «Nota fotográfica» Desplácese hasta la sección «Valores predeterminados de los campos». Seleccione el campo correspondiente del lead o del negocio (depende de si mediante el formulario se crea un lead o un negocio). Pulse «Añadir campo» r7k12id. Archivo abierto «Nota fotográfica» En el valor, escriba %r7k12id%: Archivo abierto «Nota fotográfica»