Przewodnik rozwiązywania problemów z RCS dla firm

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

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 RCS for Business

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

• 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: [e-mail]) 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ązanie problemu:

• Kiedy problem się pojawił? 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 RCS dla firm wysyłane w formacie JSON lub konwertowane na SMS-y

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

• 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

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

• Raport o błędzie z urządzenia, które nie otrzymuje wiadomości RCS od firm.
• 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

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

• Identyfikator agenta
• Szczegóły błędu JavaScriptu widocznego w konsoli programisty usług komunikacji biznesowej

Nie udało się otworzyć precyzyjnego linku do RCS dla firm

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

• 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 testami funkcji

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ązanie problemu:

• 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 dla Firm.

Jeśli napotkasz jakiekolwiek problemy z RCS Business Messaging na urządzeniu z iOS, zachęcamy do zgłaszania ich bezpośrednio do Apple za pomocą aplikacji Asystent opinii. Pomoże to Apple zidentyfikować i rozwiązać wszelkie problemy związane z ich implementacją.

Wskazówka: informacje o tym, jak korzystać z aplikacji Asystent opinii, znajdziesz na stronie https://developer.apple.com/bug-reporting/#feedback-assistant.

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 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, aby zapytać o stan wdrożenia RCS/RBM na iOS.

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

Problemy ze skutecznością i wyświetlaniem

Są to problemy z wydajnością i wyświetlaniem RCS dla firm.

Opóźnienia w wykonywaniu działań RCS for Business

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

Problemy z renderowaniem karuzeli i kart informacyjnych

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

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

• 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ązanie problemu:

• Identyfikator agenta
• Numer telefonu
• Nazwa operatora i kraj

Operator nie może zatwierdzić uruchomienia agenta

Zgłoś problem w konsoli administracyjnej RCS dla Firm (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 RCS dla firm nie mogą bezpośrednio modyfikować tych pól):

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

Uwaga:

W przypadku agentów uruchomionych wyłącznie u indyjskich operatorów zespół pomocy RBM może edytować informacje o agencie bez wycofywania go.

W przypadku agentów z Brazylii zespół pomocy RBM może wprowadzać zmiany we wszystkich informacjach o agencie z wyjątkiem nazwy wyświetlanej, danych kontaktowych marki i danych kontaktowych partnera obsługującego wiadomości.

Prośba o wprowadzenie zmian na koncie partnera RCS Business Messaging

Jeśli partner RCS dla firm 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:
   • Identyfikator partnera
   • szczegóły, które chcesz zmienić;

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 z RCS Business Messaging 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 RCS Business Messaging jest uwzględniony w tych e-mailach z prośbą o zatwierdzenie.
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