Przewodnik dotyczący rozwiązywania problemów z RBM

Z tego przewodnika dowiesz się, jak przekazać niezbędne informacje, aby rozwiązać problemy z RBM.

Problemy z dostarczaniem i formatowaniem wiadomości

Są to problemy z rzeczywistym przesyłaniem i odbieraniem wiadomości, w tym problemy z formatowaniem wiadomości.

Nie można wysyłać wiadomości RBM

Podaj jak najwięcej z tych informacji, aby przyspieszyć rozwiązywanie problemów:

  • przykładowe identyfikatory wiadomości z sygnaturami czasowymi;
  • Identyfikator partnera (patrz zrzut ekranu)
  • Liczba agentów, których to dotyczy
  • Identyfikatory agentów (rozdzielone przecinkami)
  • Szacunkowa liczba wiadomości, których dotyczy problem lub których może dotyczyć problem.
  • Metody interfejsu API, z którymi masz problemy (np. przesyłanie plików, tworzenie wiadomości od agenta do użytkownika, tworzenie zdarzenia od agenta do użytkownika, usuwanie wiadomości od agenta do użytkownika, pobieranie funkcji, pobieranie zbiorcze)
  • Przykładowy ładunek JSON nieudanych żądań
  • W przypadku problemów z klientem: raport o błędach klienta

  • Dzienniki błędów (błędy widoczne w terminalu podczas wywoływania interfejsów RBM API), w tym kod i komunikat o błędzie. Na przykład:

    "error": {
"code": 403,
"message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
"status": "PERMISSION_DENIED",
}

    Nie otrzymuję zdarzeń ani wiadomości w webhooku

Aby zapewnić płynne dostarczanie wiadomości, sprawdź, czy wszystkie webhooki agenta na koncie partnera działają prawidłowo i mogą przetwarzać wiadomości od Google. Wszyscy agenci na koncie partnera korzystają z jednego kanału do odbierania wiadomości i wydarzeń, więc nieprawidłowo działający webhook może zakłócić dostarczanie wiadomości do wszystkich agentów.

Jeśli problem nadal występuje, podaj te informacje, aby przyspieszyć rozwiązywanie problemów:

  • Kiedy pojawił się problem? Czy wcześniej otrzymywałeś(-aś) wiadomości i wydarzenia?
  • Identyfikator partnera
  • Identyfikatory agentów
  • Adres URL webhooka
  • Identyfikatory wiadomości z sygnaturami czasowymi

Wiadomości RBM wysyłane jako JSON lub konwertowane na SMS-y

Podaj jak najwięcej z tych informacji, aby przyspieszyć rozwiązywanie problemów:

  • Identyfikatory wiadomości z sygnaturami czasowymi
  • Ładunek JSON
  • Kroki umożliwiające odtworzenie problemu na urządzeniu (jeśli są znane).
  • Raport o błędzie z urządzenia odbierającego wiadomości
  • szczegóły dotyczące urządzenia i wersji aplikacji do obsługi wiadomości,
  • zrzut ekranu lub nagranie wideo przedstawiające problem;

Nie można odbierać wiadomości na urządzeniu z obsługą RCS

Podaj jak najwięcej z tych informacji, aby przyspieszyć rozwiązywanie problemów:

  • Raport o błędzie z urządzenia, które nie otrzymuje wiadomości RBM.
  • Numer telefonu
  • Szczegółowe informacje o urządzeniu i systemie operacyjnym
  • Wersja aplikacji do obsługi wiadomości
  • Kroki umożliwiające odtworzenie problemu (jeśli są znane).
  • Zrzut ekranu przedstawiający stan RCS
  • zrzut ekranu lub nagranie wideo przedstawiające problem;
  • Nazwa operatora i kraj

Problemy z konfiguracją i łącznością klientów oraz urządzeń

Mogą one obejmować problemy z konfiguracją po stronie klienta, połączeniem i problemy specyficzne dla platformy.

Nie udało się wygenerować adresu URL P2A ani kodu QR

Podaj jak najwięcej z tych informacji, aby przyspieszyć rozwiązywanie problemów:

Podaj jak najwięcej z tych informacji, aby przyspieszyć rozwiązywanie problemów:

  • Identyfikator agenta
  • Numer telefonu
  • Kroki umożliwiające odtworzenie problemu (jeśli są znane).
  • Raport o błędzie z urządzenia, na którym otwarto link
  • zrzut ekranu lub nagranie wideo przedstawiające problem;

Problemy z weryfikacją możliwości

Aby przyspieszyć rozwiązywanie problemów, podaj te informacje:

  • Lista numerów telefonów z kodami krajów w pliku CSV
  • Identyfikatory agentów
  • Logi błędów
  • Stan RCS urządzenia
  • datę i godzinę przeprowadzenia testu;

Urządzenie testowe nie otrzymuje zaproszenia dla testera ani wiadomości

Postępuj zgodnie z instrukcjami z artykułu Konfigurowanie urządzenia testowego.

Jeśli problem nadal występuje, podaj te informacje, aby przyspieszyć rozwiązywanie problemów:

  • Identyfikator agenta
  • Numer telefonu
  • Identyfikator wiadomości z sygnaturą czasową
  • Raport o błędzie w ciągu 5 minut od wysłania zaproszenia do testów

Problemy z RCS/RBM na urządzeniach z iOS

Firma Apple przyjęła standard Rich Communication Services (RCS) do przesyłania wiadomości, ale zdecydowała się na opracowanie własnego, unikalnego wdrożenia. Obejmuje to funkcje takie jak RCS Business Messaging (RBM).

Jeśli napotkasz jakiekolwiek problemy z RBM na urządzeniu z iOS, zgłoś je bezpośrednio do Apple za pomocą aplikacji Asystent opinii. Pomoże to firmie Apple zidentyfikować i rozwiązać problemy związane z jej implementacją.

  1. Otwórz aplikację Asystent opinii na urządzeniu z iOS.
  2. Wybierz odpowiedni temat początkowy związany z problemami z aplikacją do przesyłania wiadomości.
  3. Napisz i prześlij opinię.
  4. Aby zespół pomocy RBM był na bieżąco, podziel się z nami swoimi spostrzeżeniami. Dziękujemy za pomoc w ulepszaniu RCS dla wszystkich użytkowników.

Dostępność RCS/RBM u operatorów na urządzeniach z iOS

Apple ma własny wybór operatorów do uruchamiania RCS/RBM na iOS. Jeśli chcesz dowiedzieć się więcej o dostępności na całym świecie lub przyszłych planach Apple, skontaktuj się bezpośrednio z Apple. Możesz też skontaktować się z operatorem, który Cię interesuje, i zapytać o stan wdrożenia RCS/RBM na iOS.

Informacje o obsłudze operatorów sieci komórkowych i funkcjach iPhone’a w poszczególnych krajach znajdziesz na stronie pomocy Apple.

Problemy z wydajnością i wyświetlaniem

Są to problemy z wydajnością i wyświetlaniem RBM.

Opóźnienie w wykonywaniu działań RBM

Najpierw sprawdź te kwestie:

Pytanie Rekomendacja
Czy opóźnienie wynosi <5s? Jeśli tak, mieści się to w dopuszczalnym zakresie.
Czy nastąpiła regresja w zakresie czasu oczekiwania? Jeśli tak, to kiedy się zaczęło? Jaki był typowy czas oczekiwania wcześniej w porównaniu z obecnym?
Czy korzystasz z interfejsu API do przesyłania plików? Zamiast wysyłać bezpośrednie adresy URL, używaj identyfikatorów plików. Przetwarzanie nowych adresów URL multimediów obejmuje pobieranie, przetwarzanie, tworzenie miniatur, ochronę przed nadużyciami i ochronę przed wirusami. Ta ostatnia czynność zajmuje około 50% czasu.
Czy multimedia do wiadomości zostały przesłane z wyprzedzeniem? Aby przyspieszyć przetwarzanie, zalecamy użycie tego wywołania interfejsu API: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
Czy przeprowadzono testy możliwości? Aby zmniejszyć opóźnienia w wysyłaniu wiadomości do użytkowników, którzy nie są dostępni przez RCS, najpierw przeprowadź sprawdzanie możliwości.

Jeśli problem nie ustąpi, podaj jak najwięcej dodatkowych szczegółów, abyśmy mogli szybciej go rozwiązać:

  • Liczba wiadomości, których dotyczy problem
  • Źródło opóźnienia (np. przesyłanie plików, tworzenie wiadomości od agenta do użytkownika, tworzenie zdarzenia od agenta do użytkownika, usuwanie wiadomości od agenta do użytkownika, pobieranie funkcji, pobieranie zbiorcze)
  • Punkt końcowy usługi
  • Rozkład czasu oczekiwania (p50, p95, p99)
  • Zmiana czasu oczekiwania i przedział czasu
  • Identyfikator partnera
  • Identyfikatory agentów, których dotyczy problem
  • Identyfikatory wiadomości z sygnaturami czasowymi
  • Ładunek JSON

Przykłady tego problemu to niepowodzenie wczytywania, wyświetlanie czarnego ekranu, przycinanie i niewyświetlanie sugerowanych działań.

Podaj jak najwięcej z tych informacji, aby przyspieszyć rozwiązywanie problemów:

  • Identyfikatory wiadomości z sygnaturami czasowymi
  • Ładunek JSON
  • Kroki umożliwiające odtworzenie problemu na urządzeniu (jeśli są znane).
  • Raport o błędzie z urządzenia odbierającego wiadomości
  • szczegóły dotyczące urządzenia i wersji aplikacji do obsługi wiadomości,
  • zrzut ekranu lub nagranie wideo przedstawiające problem;

Problemy z zarządzaniem kontem, agentem i przewoźnikiem

Są to problemy z zarządzaniem kontem i raportowaniem, w tym zapytania dotyczące płatności.

Nie można dodać testera

Postępuj zgodnie z instrukcjami z artykułu Konfigurowanie urządzenia testowego.

Jeśli problem nadal występuje, podaj te informacje, aby przyspieszyć rozwiązywanie problemów:

  • Identyfikator agenta
  • Numer telefonu
  • Nazwa operatora i kraj

Operator nie może zatwierdzić uruchomienia agenta

Zgłoś problem w konsoli administracyjnej RBM (patrz zrzut ekranu).

W przypadku pilnych premier podaj:

  • Nazwa operatora i kraj
  • Identyfikator agenta, który ma zostać uruchomiony
  • Zezwolenie operatora na uruchomienie

Prośba o zaktualizowanie danych pracownika

Aby szybciej otrzymywać aktualizacje, udostępnij te informacje:

  • Identyfikatory agentów
  • szczegóły, które chcesz zmienić;
  • Potwierdzenie wycofania agenta

W przypadku tych pól zespół pomocy RBM wycofa agenta. Możesz wtedy wprowadzić zmiany w agencie i ponownie przesłać go do uruchomienia.

  • Wyświetlana nazwa
  • Opis
  • Kolor
  • Obrazy logo i banera
  • dane kontaktowe agenta, takie jak numer telefonu, adres strony internetowej i adres e-mail;
  • Prywatność i Warunki korzystania z usługi

W przypadku tych pól zespół pomocy RBM wycofa agenta z wdrożenia i zmodyfikuje pola (partnerzy RBM nie mogą modyfikować tych pól bezpośrednio):

  • Kategoria fakturowania
  • Przypadek użycia
  • Nazwa marki
  • Imię i nazwisko osoby kontaktowej ds. marki
  • Identyfikator kontaktowego adresu e-mail marki
  • Adres URL witryny marki
  • Imię i nazwisko osoby kontaktowej partnera obsługującego wymianę wiadomości
  • Kontaktowy adres e-mail partnera obsługującego wymianę wiadomości

Jeśli chcesz zmodyfikować informacje o agencie bez wycofywania agentów, uzyskaj zgodę e-mail od kontaktów w sieciach zarządzanych przez operatora, w których agent jest obecnie dostępny. Po zebraniu wszystkich e-maili z zatwierdzeniem udostępnij je zespołowi pomocy RBM wraz ze szczegółami wymaganych zmian.

Zespół pomocy RBM zweryfikuje zatwierdzenia i jeśli wszystko będzie w porządku, wprowadzi zmiany oraz potwierdzi je z Tobą i odpowiednimi operatorami. Pamiętaj, że ten proces może się różnić w zależności od procedur poszczególnych operatorów w różnych krajach.

Prośba o wprowadzenie zmian na koncie partnera RBM

Jeśli partner RBM ma agentów uruchomionych w sieciach zarządzanych przez operatora, wykonaj te czynności:

  1. Otrzymuj e-maile z prośbą o zatwierdzenie od kontaktów w sieciach zarządzanych przez operatorów, w których działają Twoi agenci.
  2. Podaj zespołowi pomocy RBM te informacje:

Po sprawdzeniu zatwierdzeń i szczegółów zespół pomocy RBM powiadomi operatorów o oczekujących zmianach. Zmiany zostaną wprowadzone i potwierdzone w ciągu 24 godzin od otrzymania powiadomienia od przewoźnika.

Prośba o przeniesienie agenta od partnera A do partnera B

Jeśli agent jest już uruchomiony w sieciach zarządzanych przez operatora, wykonaj te czynności:

  1. Uzyskaj zgodę e-mailową od osoby kontaktowej marki i osób kontaktowych w sieciach zarządzanych przez operatora.
    • Upewnij się, że nowy partner RBM jest uwzględniony w tych e-mailach z zatwierdzeniem.
  2. Podaj zespołowi pomocy RBM te informacje:
    • Identyfikatory agentów
    • Zgody e-mailowe od osoby kontaktowej ds. marki i przewoźników
    • Nowy identyfikator partnera

Po sprawdzeniu zatwierdzeń i szczegółów zespół pomocy RBM powiadomi operatorów o oczekujących zmianach. Zmiany zostaną wprowadzone i potwierdzone w ciągu 24 godzin od otrzymania powiadomienia od przewoźnika.

Prośba o przeniesienie agentów na inne konto partnera

Aby szybciej otrzymywać aktualizacje, udostępnij te informacje:

  • Lista identyfikatorów agentów
  • Stary identyfikator partnera
  • Nowy identyfikator partnera

Brak informacji w raportach o zdarzeniach rozliczeniowych

Aby przyspieszyć rozwiązywanie problemów, podaj te informacje:

  • Daty, dla których brakuje plików
  • Identyfikatory agentów