Blog | Facebook | Kontakt      en  pl
Profesjonalne ankiety online
Działy pomocy
FAQ

API token dla Zendesk

Ta integracja pozwala na automatyczne przesłanie adresu email oraz innych wybranych informacji z Zendesk do mysurveylab i następnie na tej podstawie dostosowania i wysłanie ankiety.

MYSURVEYLAB

KROK 1. Wygeneruj TOKEN API MYSURVEYLAB

  1. przejdź do Konto
  2. wciśnij przycisk Integracje
  3. w części TOKEN API MYSURVEYLAB wciśnij przycisk Generate API token

KROK 2. Utwórz kolektor ankiety

  1. przejdź do listy ankiet i wciśnij przycisk Kolektory
  2. wciśnij przycisk + DODAJ KOLEKTOR
  3. wpisz nazwę kolektora
  4. wybierz metodę dystrybucji email (zaproszenia email) lub embedded email (ankieta w mailu)
  5. wciśnij przycisk ZAPISZ

KROK 3. Pobierz URL kolektora API

  1. przejdź do kolektora ankiety
  2. wciśnij przycisk Kontakty
  3. wciśnij przycisk API link
  4. skopiuj link ankiety (URL) i zastąp informację w nawiasach [ ... ]

Przykład

https://mysurveylab.com/api.php?apiToken=[API TOKEN]&cId=8379821739721&email=[DYNAMIC RESPONDENT EMAIL]&crk=[DYNAMIC CRK DATA]&referrer=[DYNAMIC RESPONDENT DATA]&language=[DYNAMIC LANGUAGE]

https://mysurveylab.com/api.php?apiToken=yadfhjs&cId=8379821739721&email={{ticket.requester.email}}&crk={{ticket.id}}&referrer={{ticket.url}}&language={{ticket.requester.language}}

  Opis Przykład
apiToken token API wygenerowany w mysurveylab.com yadfhjs
email Email, na który system wyśle ankietę email={{ticket.requester.email}}
crk Response ID (must be unique) crk={{ticket.id}}
refferer Dowolna informacja referrer={{ticket.url}}
language Język ankiety language={{ticket.requester.language}}
custom1 Dowolna informacja (pole custom 1) custom1={{ticket.id}}
custom2 Dowolna informacja (pole custom 2) custom2={{ticket.id}}
... ... ...
custom8 Dowolna informacja (pole custom 8) custom8={{ticket.id}}
 

NOTE. Para email i crk musi być unikalna dla danego Kolektora. Oznacza to, że dla opisanego powyżej przykładu możesz posiadać jedną ankietę dla jednego ticketu. Jeżeli potrzebujesz więcej odpowiedzi dla jednego ticketu wtedy crk musi być bardziej złożone i musisz dodać dodatkowe informację, które zapewnią unikalność crk.

ZENDESK

KROK 4. Ustaw Extensions w Zendesk

  1. zaloguj się do Zendesk i przejdź do panelu administratora (Admin)
  2. przejdź do Extensions
  3. wciśnij przycisk add target
  4. wybierz URL target »
  5. ustaw [1] Title, [2] URL target (URL, który skopiowałeś z mysurveylab.com) i [3] Attribute name
  6. wciśnij przycisk [4] Submit

extensions configuration

UWAGI. URL
  1. Jeśli kopiujesz adres URL lub jego część (np. API token) sprawdź czy nie zawiera on zbędnych spacji.
  2. Korzystaj z podpowiedzi Zendesk.
  3. Możesz dodać zmienne tylko raz.
 
UWAGI. Submit / testy
  1. Domyślna akcja przycisku Submit to wysłanie pingu do adresu API URL, jeśli wykonana poprawnie testowy email powinien być widoczny na liście kontaktów przypisanych do kolektora (np. customer@example.com).
  2. Jeśli pomyślnie przetestowałeś utworzone rozszerzenie (Extension), zmień akcję przycisku Submit na Create target i wciśnij przycisk Submit.

KROK 5. Ustaw wyzwalacze (Triggers) w Zendesk

  1. przejdź do Triggers
  2. wciśnij przycisk Add trigger
  3. w Meet ALL of the following conditions wciśnij przycisk Add condition i następnie wybierz wybierz Status | IsSolved
  4. w Actions wciśnij przycik Add action i następnie Notify target | mysurveylab survey
  5. wpisz wiadomość (Message)
  6. wciśnij przycisk Create
triggers configuration

UWAGI. Pamiętaj, że wiadomość wyzwalacza (triggera) w Zendesk nie może być pusta.