Przejdź do treści

Integracja systemu CRM przez API

Aby zintegrować system CRM z R7K12, należy obowiązkowo użyć dwóch metod API:

  1. setStatuses
  2. addLeads

Do czego służy metoda setStatuses

Załóżmy, że w Twoim CRM są następujące statusy:

  • Nowy
  • Przekazano do kompletacji
  • Dostępność potwierdzona
  • W trakcie kompletacji
  • Uzgodniono z klientem
  • W doręczeniu
  • Zrealizowany

Chcesz przeanalizować cały lejek transakcji według statusów. Co trzeba w tym celu zrobić?

Statusy według grup w R7K12

Aby w analityce R7K12 wyodrębnić spośród wszystkich Twoich transakcji (zamówień) docelowe zgłoszenia, sprzedaże i anulowane zgłoszenia, w R7K12 istnieją cztery grupy statusów: „Nieuwzględniane”, „W realizacji”, „Zrealizowano”, „Anulowano”. Statusy z Twojego CRM należy przypisać do tych grup. Wtedy w kolumnach analityki zobaczysz:

  1. Kolumna „Zgłoszenia” — liczone są tu transakcje, których statusy przypisano do grup „W realizacji”, „Zrealizowano”, „Anulowano”.
  2. Kolumna „Sprzedaż” — liczone są transakcje, których statusy przypisano do grupy „Zrealizowano”.
  3. Kolumna „Anulowane zgłoszenia” — transakcje, których statusy przypisano do grupy „Anulowano”.
  4. Kolumna „Transakcje” — uwzględniane są wszystkie transakcje z systemu CRM (innymi słowy ze wszystkich grup statusów).
  5. Kolumna „Zapytania” — liczone są wszystkie zapytania ze wszystkich transakcji (jedna transakcja może zawierać kilka zapytań od klienta). Zapytanie to połączenie od klienta, zgłoszenie ze strony internetowej, wiadomość e-mail itp.

Aby każdemu Twojemu statusowi transakcji z CRM przypisać grupę statusu w R7K12, należy jednorazowo przesłać nam przez API przypisanie statusów (jak na obrazku powyżej) za pomocą metody setStatuses. Jeśli statusy w Twoim CRM się zmienią, prześlij następnie zaktualizowane dane. Przykład kodu znajduje się w opisie metody.

Do czego służy metoda addLeads

Po przypisaniu statusów do grup w R7K12 można przesyłać transakcje z określoną grupą statusu. Wtedy w analityce zobaczysz liczbę docelowych zgłoszeń (kolumna „Zgłoszenia”), sprzedaży, anulowanych zgłoszeń, wszystkich transakcji i zapytań. Możesz też sprawdzić, które źródło przyniosło Ci każdą z tych transakcji. Metoda ma pola obowiązkowe i nieobowiązkowe. W związku z tym minimalny zestaw pól do przesłania danych zawiera pola obowiązkowe. Wśród pól nieobowiązkowych jest pole r7k12id -identyfikator wizyty. Tak, metodę można poprawnie wywołać bez tego pola (lub z pustym polem). Jednak wtedy wszystkie transakcje trafią do źródła „Bez wizyty” i pozostaną nieokreślone. Oznacza to, że nie zobaczysz, z jakiego źródła pochodziły zgłoszenia i sprzedaże. Dlatego pole r7k12id musi być określone. W tym celu zainstaluj nasz kod śledzenia zgodnie z instrukcją — Instalacja kodu śledzenia. W przypadku wizyty na stronie po zainstalowaniu kodu śledzenia R7K12 wartość identyfikatora będzie liczbowa. Dla źródeł offline w wartości r7k12id można przekazywać nazwę źródła. Skorzystaj ze szczegółowych przykładów w opisie metody API — addLeads.