Operatorzy
Zarządzaj operatorami czatów w swoich organizacjach ChatHub. Operatorzy to agenci obsługujący rozmowy z klientami.
Przegląd
Operatorzy w ChatHubie:
- Obsługuj rozmowy na czacie z klientami
- Należą do określonych organizacji
- Mają status aktywny, nieaktywny lub usunięty
- Może mieć indywidualne tokeny uwierzytelniające
- Odbieraj i odpowiadaj na wiadomości
Lista operatorów
Pobierz wszystkich operatorów dla określonej organizacji.
Punkt końcowy
KOD_BLOKU_0
Żądanie
KOD_BLOKU_1
Parametry
| Parametr | Wpisz | Lokalizacja | Wymagane | Opis |
|---|---|---|---|---|
Identyfikator organizacji | liczba całkowita | Zapytanie | Tak | Identyfikator organizacji |
Nagłówki
| Nagłówek | Wartość | Wymagane |
|---|---|---|
| „Autoryzacja” | Nośnik {token} | Tak |
Akceptuj | tekst/zwykły | Tak |
Odpowiedź
KOD_BLOKU_2
Pola odpowiedzi
| Pole | Wpisz | Opis |
|---|---|---|
id | liczba całkowita | Unikalny identyfikator operatora |
imię | ciąg | Nazwa wyświetlana operatora |
stan | liczba całkowita | Status operatora (0=Aktywny, 1=Nieaktywny, 2=Usunięty) |
| „organizacja” | obiekt | Dane organizacji nadrzędnej |
id organizacji | liczba całkowita | Identyfikator organizacji |
nazwa.organizacji | ciąg | Nazwa organizacji |
Stan operatora
| Stan | Wartość | Opis |
|---|---|---|
| Aktywny | 0 | Operator obecnie pracuje i może odbierać czaty |
| Nieaktywne | 1 | Operator jest tymczasowo wyłączony |
| Usunięto | 2 | Operator został usunięty z systemu |
Dodaj operatorów
Dodaj nowych operatorów do organizacji za pomocą punktu końcowego synchronizacji.
Punkt końcowy
KOD_BLOKU_3
Żądanie
KOD_BLOKU_4
Treść żądania
Tablica obiektów operatorowych:
KOD_BLOKU_5
Pola żądania
| Pole | Wpisz | Wymagane | Opis |
|---|---|---|---|
Identyfikator organizacji | liczba całkowita | Tak | Identyfikator organizacji docelowej |
imię | ciąg | Tak | Nazwa wyświetlana operatora |
Odpowiedź
KOD_BLOKU_6
Zmień status operatora
Aktualizuj status operatora (Aktywny/Nieaktywny/Usunięty).
Punkt końcowy
KOD_BLOKU_7
Żądanie
KOD_BLOKU_8
Treść żądania
KOD_BLOKU_9
Pola żądania
| Pole | Wpisz | Wymagane | Opis |
|---|---|---|---|
id | liczba całkowita | Tak | Identyfikator operatora |
stan | liczba całkowita | Tak | Nowy status (0=Aktywny, 1=Nieaktywny, 2=Usunięty) |
Odpowiedź
KOD_BLOKU_10
Sukces zwraca HTTP 200 bez treści odpowiedzi.
Wartości stanu
| Stan | Wartość | Opis |
|---|---|---|
| Aktywny | 0 | Operator może obsługiwać czaty |
| Nieaktywne | 1 | Operator tymczasowo wyłączony |
| Usunięto | 2 | Operator usunięty z systemu |
Przykład: dezaktywuj operatora
KOD_BLOKU_11
Przykład: Reaktywuj operatora
KOD_BLOKU_12
Przykład: Usuń operatora
KOD_BLOKU_13
Przykłady implementacji
Pythona
KOD_BLOKU_14
JavaScript (Node.js)
KOD_BLOKU_15
PHP
KOD_BLOKU_16
Typowe przypadki użycia
Wdrażaj nowych członków zespołu
KOD_BLOKU_17
Monitoruj status operatora
KOD_BLOKU_18
Równoważenie obciążenia
KOD_BLOKU_19
Import zbiorczy
KOD_BLOKU_20
Najlepsze praktyki
Obsługa błędów
KOD_BLOKU_21
Buforowanie
KOD_BLOKU_22
Walidacja
KOD_BLOKU_23
Ograniczanie szybkości
KOD_BLOKU_24
Rozwiązywanie problemów
Nie zwrócono żadnych operatorów
- Sprawdź, czy identyfikator organizacji jest poprawny
- Sprawdź, czy organizacja istnieje i ma operatorów
- Upewnij się, że token firmy ma dostęp do organizacji
Nie udało się dodać operatorów
- Sprawdź, czy identyfikator organizacji istnieje
- Sprawdź format nazwy operatora
- Upewnij się, że token firmy jest ważny
- Sprawdź, czy format JSON jest poprawny
401 Nieautoryzowane
- Sprawdź, czy token firmy jest ważny
- Sprawdź, czy token nie wygasł
- W razie potrzeby poproś o nowy token
Zduplikowane operatory
Punkt końcowy synchronizacji może zezwalać na zduplikowane nazwy. Wdrażaj deduplikację:
KOD_BLOKU_25
Następne kroki
- Uwierzytelnianie - Uzyskaj tokeny operatora
- Organizacje - Zarządzaj organizacjami
- Integracja widgetu - Zintegruj widget czatu