API token dla Zendesk

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

SURVEYLAB

KROK 1. Wygeneruj TOKEN API SURVEYLAB.

1. Przejdź do  Ustawienia konta.
2. Wciśnij przycisk Integracje.
3. W części TOKEN API SURVEYLAB wciśnij przycisk RESET API TOKEN.

KROK 2. Utwórz kolektor ankiety

1. Przejdź do listy ankiet i wciśnij przycisk  ZBIERZ ODPOWIEDZI.
   
2. Wciśnij przycisk + DODAJ KOLEKTOR.
   
3. Wybierz metodę dystrybucji Zaproszenia email / SMS.
4. Wpisz nazwę kolektora.
5. Wciśnij przycisk Zaproszenia.
6. Wybierz typ zaproszenia Email lub Ankieta w emailu (pojedyncze pytanie).
7. Zmiany zostaną zapisane automatycznie.

KROK 3. Pobierz API Link

1. Wciśnij przycisk API link.
   
2. Skopiuj link ankiety (URL) i zastąp informację w nawiasach [ … ] danymi z systemu który będzie sterował wysyłką ankiet.

Przykład

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

https://app.surveylab.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 SurveyLab.	yadfhjs
email	Email, na który system wyśle ankietę.	email={{ticket.requester.email}}
crk	Response Key (musi być unikalny).	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}}
custom3	Dowolna informacja (pole custom 3).	custom3={{ticket.id}}
custom4	Dowolna informacja (pole custom 4).	custom4={{ticket.id}}
custom5	Dowolna informacja (pole custom 5).	custom5={{ticket.id}}
custom6	Dowolna informacja (pole custom 6).	custom6={{ticket.id}}
custom7	Dowolna informacja (pole custom 7).	custom7={{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 SurveyLab) i [3] Attribute name.
6. Wciśnij przycisk [4] Submit.
   

   

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. [email protected]).
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 Status | Is | Solved.
4. W Actions wciśnij przycik Add action i następnie Notify target | SurveyLab survey.
5. Wpisz wiadomość (Message).
6. Wciśnij przycisk Create.
   

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

Funkcjonalność dostępna jest dla kont Professional i Enterprise.