Otwórz zgłoszenie do wsparcia
Złóż zgłoszenie w biurku obsługi swojego planu z zewnętrznego kodu i sprawdzaj je, aż ktoś odpowie.
ticket_api_submit otwiera zgłoszenie w biurku obsługi, które należy do planu Twojego klucza API,
tym samym, którym zarządza ekran zgłoszeń w pulpicie. ticket_api_get odczytuje jedno z powrotem,
razem z publicznymi odpowiedziami, czyli wszystko, czego potrzebujesz, żeby zbudować formularz
„skontaktuj się z nami" oparty na prawdziwym biurku obsługi zamiast skrzynki pocztowej.
Metody
API: Submit Ticket
External service: opens a ticket on the desk owned by the API key. Requires a plan with full API access.
API: Get Ticket
External service: one ticket with its public interactions. Internal notes are never returned.
Krok po kroku
Wyślij zgłoszenie
name, email i details są wymagane. E-mail pełni też rolę wyszukiwania w książce kontaktów:
ponowne wysłanie z tego samego adresu łączy z tym samym kontaktem, tak jak robi to
dodanie kontaktu.
2. Sprawdzaj je, czekając na odpowiedź
Zapisz data.id z wywołania wysyłającego i odczytuj je z powrotem przez ticket_api_get, ilekroć
chcesz sprawdzić, czy coś się ruszyło; interactions niesie zawsze tylko publiczny wątek, wewnętrzne
notatki biurka są odfiltrowywane, zanim ta metoda odpowie.
Odpowiedź
Obie metody odpowiadają tym samym wąskim, bezpiecznym dla zewnętrznych widokiem zgłoszenia, bez identyfikatorów właścicieli i bez stanu wewnętrznego:
ticket_api_get dodaje jeszcze jeden klucz, interactions, tablicę { direction, from, channel, body, ts } w kolejności wątku, pustą, dopóki ktoś z biurka (lub zgłaszający, innym kanałem) nie odpowie.