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.
.png)
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. Wpisz nazwę kolektora.
4. Wybierz mętodę dystrybucji Zaproszenia email / SMS.
5. Wcisnij przycisk Wiadomości.
6. Wybierz metodę dystrybucji email (zaproszenia email) lub embedded email (ankieta w mailu).
.png)
7. Zmiany zostaną zapisane automatycznie.
KROK 3. Pobierz URL kolektora API
1. Przejdź do kolektora ankiety.
2. Wciśnij przycisk API link.
.png)
3. Skopiuj link ankiety (URL) i zastąp informację w nawiasach [ ... ].
Przykład
https://www.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://www.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.com | yadfhjs |
| Email, na który system wyśle ankietę | email={{ticket.requester.email}} | |
| crk | Response Key (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
- Zaloguj się do Zendesk i przejdź do panelu administratora (Admin)
- Przejdź do Extensions
- Wciśnij przycisk add target
- Wybierz URL target »
- Ustaw [1] Title, [2] URL target (URL, który skopiowałeś z SurveyLab) i [3] Attribute name
- Wciśnij przycisk [4] Submit
- Jeśli kopiujesz adres URL lub jego część (np. API token) sprawdź czy nie zawiera on zbędnych spacji.
- Korzystaj z podpowiedzi Zendesk.
- Możesz dodać zmienne tylko raz.
- 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).
- 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
- Przejdź do Triggers
- Wciśnij przycisk Add trigger
- W Meet ALL of the following conditions wciśnij przycisk Add condition i następnie wybierz wybierz Status | Is | Solved
- W Actions wciśnij przycik Add action i następnie Notify target | SurveyLab survey
- Wpisz wiadomość (Message)
- Wciśnij przycisk Create
UWAGI. Pamiętaj, że wiadomość wyzwalacza (triggera) w Zendesk nie może być pusta.
Powiązane strony
Wszystkie prawa zastrzeżone © 2020 SurveyLab | Najlepsze narzędzie do ankiet
Version 25.2.6