Przejdź do treści

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 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