Przejdź do treści

Integracja z Bitrix24

Jeśli Twoje konto w Bitrix24 (leady + transakcje) ma uprawnienia inne niż uprawnienia administratora, po skonfigurowaniu integracji mogą wystąpić błędy w przekazywaniu informacji między R7K12 a Bitrix24 (leady + transakcje). Aby sprawdzić uprawnienia w Bitrix24 (leady + transakcje):

  1. W panelu użytkownika Bitrix24 otwórz sekcję Firma.
  2. Przejdź na kartę Pracownicy.
  3. Kliknij Edytuj obok użytkownika Bitrix24 (leady + transakcje), który będzie konfigurował integrację z R7K12:
  4. Na stronie ustawień profilu użytkownika w bloku Informacje o użytkowniku upewnij się, że zaznaczone jest pole wyboru Zezwól użytkownikowi na edycję portalu:

Jak działa integracja

Po złożeniu zgłoszenia w witrynie w CRM automatycznie tworzona jest nowa transakcja, do której identyfikator wizyty z pliku cookie przeglądarki r7k12_si jest przekazywany w polu dodatkowym o nazwie r7k12id.

Konfiguracja integracji

Krok 1. Zainstaluj licznik w witrynie

Szczegółowy opis instalacji licznika w witrynie znajduje się w sekcji pomocy Instalacja liczników.

Krok 2. Dodaj pole dodatkowe

Dodaj pole niestandardowe r7k12id w encjach „Lead” i „Transakcja”:

  1. W Bitrix24 otwórz kartę CRM → Więcej → Ustawienia → Ustawienia formularzy i raportów → Pola niestandardowe.

2. Dla encji „Lead” klikamy „Dodaj pole” w oknie, które się otworzy, w polu „Nazwa” wpisujemy „r7k12id”, w polu „Typ” wybieramy „Ciąg znaków”. 3. Analogicznie dodajemy pole r7k12id do encji „Transakcja”.

Krok 3. Podłącz Bitrix24 w katalogu integracji

W systemie R7K12 przechodzimy na kartę „Integracje” i wybieramy kafelek „Bitrix24”. W oknie, które się otworzy, w polu „Wpisz portal” wpisujemy adres swojego projektu, który można wziąć z adresu Url bitrix24. Na przykład https://.bitrix24.ru, a zatem bierzemy .bitrix24.ru. W prawym górnym rogu klikamy „Utwórz”. W Twoim profilu w Bitrix24 otworzy się strona z informacjami o aplikacji do integracji z R7K12. Zaznaczamy pozycje „Zapoznałem się z umową licencyjną i akceptuję ją” oraz „Zapoznałem się z polityką prywatności i akceptuję ją”. Jeśli okno z informacjami o aplikacji do integracji R7K12 się nie otwiera i nie możesz jej znaleźć w Marketplace, napisz do nas — pomożemy. Zaznacz pola wyboru Zapoznałem się z umową licencyjną i akceptuję ją oraz Zapoznałem się z polityką prywatności i akceptuję ją i kliknij Zainstaluj. Aby zainstalować aplikację, Twoje konto w Bitrix24 musi mieć uprawnienia administratora. Jeśli wszystko przebiegło pomyślnie, otworzy się następujące okno: Ustawiamy statusy transakcji: Statusy transakcji mogą mieć następujące wartości:

  1. „Nieuwzględniane” — jeśli transakcji przypisano ten status, w analityce znajduje się ona w kolumnie „Zapytania”..
  2. „W realizacji” — oznacza, że transakcja znajduje się w kolumnie „Zgłoszenia”.
  3. „Zrealizowano” — transakcja została pomyślnie zamknięta i znajduje się w kolumnie „Sprzedaż”.
  4. „Anulowano” — oznacza, że transakcja została zamknięta i nie została zrealizowana, znajduje się w kolumnie „Anulowane zgłoszenia”.

Następnie wybieramy menedżerów odpowiedzialnych za transakcję: Wybieramy „Status domyślny”: Zapisujemy konfigurację przyciskiem „Zapisz”, znajdującym się w prawym górnym rogu.

Krok 4. Skonfiguruj automatyczne wysyłanie transakcji do Bitrix24

Session_id jest przechowywany w:

  • plikach cookie przeglądarki (r7k12_si);
  • pamięci lokalnej (localStorage) przeglądarki (r7k12_si);
  • zmiennej globalnej JS (r7k12_si).

Pobieranie ID wizyty zaleca się zrealizować za pomocą funkcji „R7K12_CallBack”. Ta funkcja zostanie wywołana automatycznie po wysłaniu „pageview” i otrzymaniu ID wizyty. Funkcja musi zostać zadeklarowana przed inicjalizacją skryptu licznika. Informacje z formularzy mogą być wysyłane do CRM zarówno za pomocą PHP, jak i za pomocą JavaScript. Skrypty są równoważne i pełnią tę samą funkcję. 4.1. Skrypt 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);

Przy wysyłaniu przez PHP lepiej jest użyć biblioteki cURL zamiast funkcji file_get_contents(). Przykład:

<?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
            }
        }
    }
});

Jeśli wysyłanie formularzy zostało poprawnie skonfigurowane, na karcie „Log zgłoszeń” będą wyświetlane zgłoszenia napływające do systemu.

Podłączenie formularzy CRM w Bitrix

Aby śledzić zapytania z tych formularzy, należy przekazywać r7k12id do transakcji. Otwórz ustawienia formularza (w Bitrix CRM -> Więcej -> Formularze CRM): Otwarto plik „Fotonotatka” Wybierz odpowiedni formularz i kliknij „Edytuj”. Na dole kliknij „Dodatkowo”. Otwarto plik „Fotonotatka” Przewiń do sekcji „Domyślne wartości pól”. Wybierz odpowiednie pole leada lub transakcji (zależy to od tego, czy przez formularz tworzony jest lead, czy transakcja). Kliknij „Dodaj pole” r7k12id. Otwarto plik „Fotonotatka” W wartości wpisz %r7k12id%: Otwarto plik „Fotonotatka”