Instrukcje dotyczące konfigurowania integracji Planfix

Połączenie w interfejsie Planfix (https://planfix.com/ru/help/API_для_телефонии)

Aby połączyć się i skonfigurować integrację, przejdź do Integracje — Wirtualne АТС.

W otwartej sekcji wybierz Api PlanFix dla telefonii (na końcu listy).

Otwarte zostanie okno ustawień integracji.

1. wartości w tych polach będą wymagane do skonfigurowania połączenia po stronie Unitalk.

2. W polu Adres ATC, do którego będą wysyłane zapytania z Planfixa zgodnie z szablonem (na powyższym zrzucie ekranu subdomena konta Planfix jest ustawiona na testic):

https://planfix.unitalk.cloud/planfix/telephone?name=<konto w subdomenie Planfix>

W polu Klucz autoryzacji ATC — Api z konta Unitalk. W ramach Integracji – API trzeba go stworzyć.

3. W zakładce Pracownicze numery skrócone określane jest powiązanie pracownik – numer SIP, tj. każdy numer SIP linii wewnętrznej w Unitalk musi odpowiadać pracownikowi w Planfix. Bez nich będzie tylko informacja o nieodebranych połączeniach przychodzących. Obowiązkowo należy podać.

4. Istnieje możliwość ustawienia sposobu przechowywania połączenia.

5. Jeśli połączenie ma być przekazane do odpowiedzialnego menedżera, użyj tej opcji. Jeśli w skryptach Unitalk Inbound występuje Call to Account Manager with API request, a przekierowanie połączeń jest wyłączone, do Planfixa zostanie zwrócona tylko nazwa kontaktu, jeśli taki istnieje. Opcjonalnie.

6. Jeśli w analizatorze wymagana jest informacja o linii zewnętrznej, połączenie zostało odebrane. Numer telefonu linii (może być czymś więcej niż tylko numerem) odpowiada wartości linii zewnętrznej Unitalk. Opcjonalnie.

Możliwe jest również zapisanie do analityki dodatkowych informacji o zrealizowanym połączeniu poprzez utworzenie w samej analityce pola z nazwą interesującej nas etykiety analityki Unitalk, dostępne są następujące wartości:

• utmSource
• utmMedium
• utmCampaign
• utmTerm
• utmContent
• googleId
• facebookClientId
• referer

Aby dodać pola analityczne, przejdź do Zarządzanie kontami – Analityka – Telefonia.

Dla podmiotów Call i Missed Call dodajemy pola o określonych nazwach i typie danych „String”.

Aby pomyślnie zapisać encje Call i Missed Call, domyślna wartość pola „Duration (sec)” musi wynosić 0.

Jeśli dane te nie będą zbierane, podczas wypełniania należy w odpowiednim polu wpisać „0”.

Połączenie w interfejsie Unitalk

(https://docs.google.com/document/d/17hqVTVDxvdPKH-71RDg399laQJ9Q9NVI75apjYiNUz0)

1. W sekcji Przetwarzanie zdarzeń wybierz DODAJ DZIAŁANIE.

2. Z menu rozwijanego Akcja wybierz opcję Wyślij webhook.

3. Określ nazwę event handler (jako przykład planfix calls) nieco później Outbound webhooks są odpowiednio skonfigurowane. URL robi różnicę: https://planfix.unitalk.cloud/unitalk/call. HTTP sposób zostawiamy POST/

4. Dodawanie parametrów do adresu URL. Klucz nazwa przyjmuje wartość subdomeny konta Planfix. Jeśli wymagane są znaczniki analityczne, dodaj klucz with_utm z dowolną wartością bez specjalnych znaki (&=;%№»! и т.д.), może pozostać pusta, to właśnie obecność samego klucza jest ważna dla obsługi znaczników. Przykład skonfigurowanych pól z etykietami analitycznymi:

5. Dodanie kluczy do HTTP Header. Używane są następujące klucze i wartości:

• planfix-url – wartość z pierwszego punktu po stronie konfiguracji Planfix, Adres do przyjmowania zgłoszeń;
• planfix-token – wartość z pierwszej pozycji ustawienia z boku Planfix, Klucz autoryzacji (token) Planfix;
• token – wartość określa klucz Api, który został utworzony w ramach Integration – API i wprowadzona w drugiej pozycji ustawienia na boku Planfix, Klucz autoryzacji АТС.

Przykład skonfigurowanego HTTP Header:

6. Nie zapominaj o oszczędzaniu.

7. Przejdź do Integracji– API, w formularzu Call Event Handling (Outgoing webhooks) dla każdego z 4 podanych zdarzeń dodaj stworzony wcześniej handler. Rezultat:

8. Opcjonalnie. Jeśli wymagane jest przekierowanie połączeń do odpowiedzialnego menedżera, w sekcji IP Telefonia — Scenariusze przychodzące w istniejącym scenariuszu lub w nowo utworzonym scenariuszu dodaj Wezwanie do kierownika odpowiedzialnego.

Z listy rozwijanej Search for Responsible wybierz opcję Request to Your API. W polu Specify URL wprowadź link używając poniższego szablonu:

https://planfix.unitalk.cloud/unitalk/call_route?planfix–url=<Adres, na który należy kierować wnioski z punktu 5>&planfix–token=<Klucz autoryzacji (token) Planfix z punktu 5>&name=<subdomena z punktu 5>

Przykład gotowego linku:

https://planfix.unitalk.cloud/unitalk/call_route?planfix-url=https://testic.planfix.ua/tel/api&planfix-token=f418f1be8e69310ccc80290ec2c7a74e&name=testic