Do momentu uruchomienia agent może komunikować się tylko z wyznaczonymi urządzeniami testowymi. Umożliwia to testowanie agenta wewnętrznie, aby zapobiec przypadkowemu wczesnemu dostępowi użytkowników.
Aby komunikować się z agentem RBM, urządzenie testowe musi mieć włączoną obsługę RCS. Uwaga: na niektórych urządzeniach z Androidem czaty RCS nie są domyślnie włączone. Aby sprawdzić stan RCS na urządzeniu, przeczytaj artykuł Sprawdzanie stanu RCS na urządzeniu.
Przedstawiciele mogą wysyłać maksymalnie 20 zaproszeń dla testerów dziennie, a łączny limit wynosi 200 zaproszeń.
Sprawdzanie stanu RCS na urządzeniu
- W aplikacji Wiadomości otwórz ustawienia Wiadomości.
- Kliknij Czaty RCS. Jeśli nie możesz znaleźć opcji „Czaty RCS”, kliknij Funkcje czatu.
- Znajdź wartość Stan.
Jeśli Twoje urządzenie nie obsługuje RCS, włącz RCS, konfigurując urządzenie za pomocą wersji przedpremierowych aplikacji Wiadomości i Usługi operatora.
Jeśli Twoje urządzenie obsługuje RCS, możesz wysłać zaproszenie do testowania. Gdy urządzenie zaakceptuje zaproszenie, będzie mogło wysyłać wiadomości do Twojego nieopublikowanego agenta.
Włączanie czatów RCS na urządzeniu
Aby włączyć RCS na urządzeniu z Androidem, włącz czaty RCS w aplikacji Wiadomości.
Gdy RCS jest aktywny na urządzeniu, możesz wysłać zaproszenie do testów.
Wysyłanie zaproszenia do testera
Aby zaprosić urządzenie z włączoną funkcją RCS do testowania, wyślij zaproszenie do testowania. Gdy urządzenie zaakceptuje zaproszenie, agent może wysyłać do niego wiadomości, zdarzenia i żądania.
Jeśli urządzenie nie obsługuje RCS, nie odpowie na zaproszenie testera lub odrzuci zaproszenie, agent otrzyma błąd 403 PERMISSION_DENIED, gdy spróbuje się z nim skomunikować.
Konsola
Aby wysłać zaproszenie do testera za pomocą Konsoli programisty Business Communications:
- Otwórz Business Communications Developer Console, zaloguj się na konto Google RBM i kliknij agenta.
- W menu po lewej stronie kliknij Urządzenia.
- Dodaj urządzenie testowe do listy urządzeń testowych, wpisując jego numer telefonu wraz z kodem kraju i numerem kierunkowym. Aby dodać kilka numerów telefonów, rozdziel je przecinkami.
Gdy urządzenie zostanie dodane do listy, zostanie wysłane zaproszenie. Użytkownik zobaczy na urządzeniu wiadomość z zaproszeniem i będzie mógł ją zaakceptować lub odrzucić.
Lista urządzeń testowych zawiera szczegółowe informacje o stanie zaproszenia testera na każdym urządzeniu, które zaprosisz do testowania agenta.
Interfejs API
Aby wysłać zaproszenie do testera za pomocą interfejsu RBM Management API:
Użyj tego kodu. Opcje formatowania i wartości znajdziesz w sekcji
testers.
cURL
curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \
-d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'Node.js
// Reference to RBM API helper const rbmApiHelper = require('@google/rcsbusinessmessaging'); // Send the tester invite to the device rbmApiHelper.sendTesterInvite('+12223334444', function(response) { console.log(response); });
Java
import com.google.rbm.RbmApiHelper; … try { // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(); // Register the device as a tester rbmApiHelper.registerTester("+12223334444"); } catch(Exception e) { e.printStackTrace(); }
Python
# Reference to RBM Python client helper from rcs_business_messaging import rbm_service # Send the tester invite to a device rbm_service.invite_tester('+12223334444')
C#
using RCSBusinessMessaging; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation, projectId); // Register the device as a tester rbmApiHelper.RegisterTester("+12223334444");
Jeśli wyślesz więcej niż 200 zaproszeń, platforma RBM zwróci kod błędu 429 RESOURCE_EXHAUSTED.
Ponowne wysyłanie zaproszenia dla testera
W razie potrzeby możesz ponownie wysłać zaproszenie do testera. Wynik zależy od bieżącego stanu zaproszenia urządzenia.
| Stan urządzenia | Wynik |
PENDING
|
Zaproszenie do testów jest wysyłane na urządzenie. |
ACCEPTED
|
Zaproszenie do testów nie jest wysyłane na urządzenie, które zachowuje status ACCEPTED.
|
DECLINED
|
Zaproszenie do testów zostało odrzucone. Zanim ponownie wyślesz zaproszenie, musisz najpierw usunąć urządzenie testowe. W przeciwnym razie żądanie się nie powiedzie. |
Gdy urządzenie zaakceptuje zaproszenie do testowania, stanie się wyznaczonym urządzeniem testowym dla Twojego agenta. Możesz wysyłać na urządzenie wiadomości, wydarzenia i sprawdzać możliwości, aby przetestować funkcje i procesy agenta.
Sprawdzanie stanu zaproszenia urządzenia testowego
Gdy zaprosisz testera, może on zaakceptować lub odrzucić zaproszenie na swoim urządzeniu. Możesz wysłać do interfejsu API zapytanie o stan zaproszenia urządzenia.
Konsola
Aby sprawdzić stan zaproszenia urządzenia testowego w Konsoli Business Communications Developer:
- Otwórz Business Communications Developer Console, zaloguj się na konto Google RBM i kliknij agenta.
- W menu po lewej stronie kliknij Urządzenia.
- Dodaj urządzenie testowe do listy urządzeń testowych, wpisując jego numer telefonu wraz z kodem kraju i numerem kierunkowym. Aby dodać kilka numerów telefonów, rozdziel je przecinkami.
Gdy urządzenie testowe zostanie dodane do listy, możesz sprawdzić jego stan w kolumnie Stan.
Interfejs API
Aby sprawdzić stan zaproszenia urządzenia testowego za pomocą interfejsu RBM Management API:
Użyj tego kodu. Opcje formatowania i wartości znajdziesz w sekcji
testers.
cURL
curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
Sprawdzanie stanu wszystkich urządzeń testowych
Możesz sprawdzić stan zaproszenia wszystkich urządzeń, które zostały zaproszone do roli testerów.
Konsola
Aby sprawdzić stan zaproszenia wszystkich urządzeń testowych w Konsoli dewelopera Business Communications:
- Otwórz Business Communications Developer Console, zaloguj się na konto Google RBM i kliknij agenta.
- W menu po lewej stronie kliknij Urządzenia.
- Dodaj urządzenie testowe do listy urządzeń testowych, wpisując jego numer telefonu wraz z kodem kraju i numerem kierunkowym. Aby dodać kilka numerów telefonów, rozdziel je przecinkami.
Gdy urządzenie testowe zostanie dodane do listy, jego stan możesz sprawdzić w kolumnie Stan.
Interfejs API
Aby sprawdzić stan zaproszenia wszystkich urządzeń testowych za pomocą interfejsu RBM Management API:
Użyj tego kodu. Opcje formatowania i wartości znajdziesz w sekcji
testers.
cURL
curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
Usuwanie urządzenia testowego
Gdy usuniesz urządzenie testowe, nie będzie ono już otrzymywać wiadomości od nieopublikowanego agenta. Platforma RBM nie usuwa wiadomości wysłanych przez agenta, które są w trakcie przesyłania na urządzenie testowe lub są na nim przechowywane.
Konsola
Aby usunąć urządzenie testowe za pomocą Konsoli dewelopera Business Communications:
- Otwórz Business Communications Developer Console, zaloguj się na konto Google RBM i kliknij agenta.
- W menu po lewej stronie kliknij Urządzenia.
- Wybierz urządzenie na liście urządzeń testowych i kliknij menu .
- Kliknij Usuń urządzenie.
Interfejs API
Aby usunąć urządzenie testowe za pomocą interfejsu RBM Management API:
Użyj tego kodu. Opcje formatowania i wartości znajdziesz w sekcji
testers.
cURL
curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"