Guida alla risoluzione dei problemi relativi a RBM

Segui questa guida per fornire le informazioni necessarie per risolvere i problemi relativi a RBM.

Problemi relativi alla consegna e al formato dei messaggi

Si tratta di problemi relativi alla trasmissione e alla ricezione effettive dei messaggi, inclusi i problemi di formattazione dei messaggi.

Impossibile inviare messaggi RBM

Condividi il maggior numero possibile di dettagli tra quelli elencati di seguito per consentire una risoluzione dei problemi più rapida:

• ID messaggio di esempio con timestamp
• ID partner (vedi screenshot)
• Numero di agenti interessati
• ID agente (separati da virgole)
• Numero stimato di messaggi interessati o potenzialmente interessati
• Metodi API con cui riscontri problemi (ad esempio: caricamento di file, creazione di messaggi da agente a utente, creazione di eventi da agente a utente, eliminazione di messaggi da agente a utente, recupero di funzionalità, recupero batch)
• Payload JSON di esempio delle richieste non riuscite
• Per problemi relativi al client: report sui bug del client

• Log degli errori (errori visualizzati nel terminale durante la chiamata delle API RBM), inclusi il codice e il messaggio di errore. Ad esempio:

  "error": {
  "code": 403,
  "message": "There was an error looking up the RBM agent (ID: [email protected]) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.",
  "status": "PERMISSION_DENIED",
  }
  

  Mancata ricezione di eventi o messaggi al webhook

Per una corretta consegna dei messaggi, verifica che tutti i webhook dell'agente dell'account partner funzionino correttamente e possano elaborare i messaggi di Google. Tutti gli agenti in un account partner condividono un unico canale per messaggi ed eventi in entrata, quindi un webhook malfunzionante può interrompere le consegne per tutti gli agenti.

Se il problema persiste, condividi i seguenti dettagli per consentire una risoluzione più rapida:

• Quando ha iniziato a verificarsi il problema? Ricevevi messaggi ed eventi senza problemi prima di allora?
• ID partner
• ID agente
• URL webhook
• ID messaggio con timestamp

Messaggi RBM inviati come JSON o convertiti in SMS

Condividi il maggior numero possibile di dettagli tra quelli elencati di seguito per consentire una risoluzione dei problemi più rapida:

• ID messaggio con timestamp
• Payload JSON
• Passaggi per riprodurre il problema sul dispositivo, se noti
• Segnalazione di bug dal dispositivo che riceve i messaggi
• Dettagli sulla versione del dispositivo e dell'app di messaggistica utilizzata
• Screenshot o registrazione video del problema

Impossibile ricevere messaggi su un dispositivo compatibile con RCS

Condividi il maggior numero possibile di dettagli tra quelli elencati di seguito per consentire una risoluzione dei problemi più rapida:

• Segnalazione di bug dal dispositivo che non riceve i messaggi RBM
• Numero di telefono
• Dettagli sul dispositivo e sul sistema operativo
• Versione dell'app di messaggistica utilizzata
• Passaggi per riprodurre il problema, se noti
• Screenshot che mostra lo stato di RCS
• Screenshot o registrazione video del problema
• Nome e paese dell'operatore

Problemi di configurazione/connettività di client e dispositivi

Questi problemi includono configurazione lato client, connessione e problemi specifici della piattaforma.

Impossibilità di generare l'URL P2A o il codice QR

Condividi il maggior numero possibile di dettagli tra quelli elencati di seguito per consentire una risoluzione dei problemi più rapida:

• ID agente
• Dettagli dell'errore JavaScript visualizzato nella Developer Console di Business Communications

Impossibile aprire un link diretto RBM

Condividi il maggior numero possibile di dettagli tra quelli elencati di seguito per consentire una risoluzione dei problemi più rapida:

• ID agente
• Numero di telefono
• Passaggi per riprodurre il problema, se noti
• Segnalazione di bug dal dispositivo in cui è stato aperto il link
• Screenshot o registrazione video del problema

Problemi con i controlli delle funzionalità

Condividi i seguenti dettagli per consentire una risoluzione dei problemi più rapida:

• Elenco di numeri di telefono con codici paese racchiusi in un file CSV
• ID agente
• Log degli errori
• Stato RCS del dispositivo
• Data e ora del test eseguito

Il dispositivo di test non riceve l'invito per i tester o i messaggi

Segui i passaggi descritti in Configurare un dispositivo di test.

Se il problema persiste, condividi i seguenti dettagli per consentire una risoluzione più rapida:

• ID agente
• Numero di telefono
• ID messaggio con timestamp
• Segnalazione di bug entro 5 minuti dall'invio dell'invito al test

Problemi relativi a RCS/RBM sui dispositivi iOS

Sebbene Apple abbia adottato lo standard Rich Communication Services (RCS) per la messaggistica, ha scelto di sviluppare una propria implementazione unica. Sono comprese funzionalità come RCS Business Messaging (RBM).

Se riscontri problemi con RBM sul tuo dispositivo iOS, ti invitiamo a segnalarli direttamente ad Apple tramite l'app Assistente feedback. In questo modo Apple potrà identificare e risolvere eventuali problemi specifici della sua implementazione.

1. Apri l'app Assistente feedback su un dispositivo iOS.
2. Seleziona un argomento iniziale appropriato, correlato a problemi con un'app di messaggistica.
3. Scrivi e invia il tuo feedback.
4. Per tenere aggiornato il team di assistenza RBM, condividi con noi i risultati. Apprezziamo il tuo aiuto per migliorare l'esperienza RCS per tutti.

Disponibilità di RCS/RBM sugli operatori sui dispositivi iOS

Apple ha una propria scelta di operatori per i lanci di RCS/RBM su iOS. Per informazioni sulla disponibilità globale o sui piani futuri di Apple, contatta direttamente Apple. Puoi anche contattare l'operatore di tuo interesse per chiedere informazioni sullo stato di lancio di RCS/RBM su iOS.

Per trovare informazioni sul supporto e sulle funzionalità degli operatori di telefonia mobile per iPhone in base al paese, visita la pagina del supporto Apple.

Problemi di rendimento e visualizzazione

Si tratta di problemi relativi alle prestazioni e alla visualizzazione di RBM.

Latenza nell'esecuzione delle azioni RBM

Ricorda di controllare prima quanto segue:

Domanda	Suggerimento
La latenza è <5s?	In questo caso, rientra nell'intervallo accettabile.
Si è verificata una regressione della latenza?	Se sì, quando ha iniziato a verificarsi? Qual era la latenza tipica prima rispetto a ora?
Stai utilizzando l'API di caricamento dei file?	Prova a utilizzare gli ID file anziché inviare URL diretti. L'elaborazione dei nuovi URL dei contenuti multimediali prevede download, elaborazione, miniature, protezione da abusi e protezione da virus, con quest'ultima che richiede circa il 50% del tempo.
Hai caricato in anticipo i contenuti multimediali del messaggio?	Per velocizzare l'elaborazione, ti consigliamo di utilizzare la seguente chiamata API: https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create
Hai eseguito i controlli delle funzionalità?	Per ridurre la latenza nell'invio di messaggi agli utenti non raggiungibili tramite RCS, esegui prima i controlli delle funzionalità.

Se il problema persiste, fornisci il maggior numero possibile di dettagli aggiuntivi per una risoluzione più rapida:

• Numero di messaggi interessati
• Origine della latenza (ad esempio: caricamento di file, creazione di messaggi da agente a utente, creazione di eventi da agente a utente, eliminazione di messaggi da agente a utente, recupero di funzionalità, recupero batch)
• Endpoint di servizio
• Distribuzione della latenza (p50, p95, p99)
• Modifica della latenza e intervallo di tempo
• ID partner
• ID agenti interessati
• ID messaggio con timestamp
• Payload JSON

Problemi di rendering di caroselli e schede interattive

Alcuni esempi di questo problema includono il mancato caricamento, la visualizzazione di una schermata nera, il ritaglio e la mancata visualizzazione delle azioni suggerite.

Condividi il maggior numero possibile di dettagli tra quelli elencati di seguito per consentire una risoluzione dei problemi più rapida:

• ID messaggio con timestamp
• Payload JSON
• Passaggi per riprodurre il problema sul dispositivo, se noti
• Segnalazione di bug dal dispositivo che riceve i messaggi
• Dettagli sulla versione del dispositivo e dell'app di messaggistica utilizzata
• Screenshot o registrazione video del problema

Problemi relativi alla gestione di account, agenti e corrieri

Si tratta di problemi relativi alla gestione e ai report dell'account, incluse le domande sulla fatturazione.

Impossibile aggiungere un tester

Segui i passaggi descritti in Configurare un dispositivo di test.

Se il problema persiste, condividi i seguenti dettagli per consentire una risoluzione più rapida:

• ID agente
• Numero di telefono
• Nome e paese dell'operatore

L'operatore non è in grado di approvare gli avvii degli agenti

Segnala il problema dalla console di amministrazione di RBM (vedi screenshot).

Per i lanci urgenti, fornisci:

• Nome e paese dell'operatore
• ID agente da avviare
• Autorizzazione dell'operatore per il lancio

Richiesta di aggiornamento dei dettagli dell'agente

Condividi i seguenti dettagli per attivare aggiornamenti più rapidi:

• ID agente
• I dettagli che vuoi modificare
• La tua conferma per annullare il lancio dell'agente

Per i seguenti campi, il team di assistenza RBM annullerà il lancio dell'agente. Puoi quindi apportare modifiche all'agente e inviarlo di nuovo per il lancio.

• Nome visualizzato
• Descrizione
• Colore
• Immagini del logo e del banner
• Dati di contatto dell'agente, come numero di telefono, sito web e indirizzo email
• Privacy e Termini di servizio

Per i seguenti campi, il team di assistenza RBM annullerà anche il lancio dell'agente e modificherà i campi (i partner RBM non possono modificare direttamente questi campi):

• Categoria di fatturazione
• Caso d'uso
• Nome brand
• Nome del contatto del brand
• ID email del contatto del brand
• URL del sito web del brand
• Nome di contatto del partner di messaggistica
• Email di contatto del partner di messaggistica

Se vuoi modificare le informazioni dell'agente senza annullare il lancio degli agenti, ottieni l'approvazione via email dai contatti delle reti gestite dall'operatore in cui l'agente è attualmente lanciato. Dopo aver raccolto tutte le email di approvazione, condividile con il team di assistenza RBM, insieme ai dettagli delle modifiche richieste.

Il team di assistenza RBM verificherà le approvazioni e, se tutto è in ordine, implementerà le modifiche e le confermerà con te e con i rispettivi operatori. Tieni presente che questa procedura può variare a seconda delle procedure dei singoli operatori in paesi diversi.

Richiedere modifiche a un account partner RBM

Se il partner RBM ha agenti lanciati su reti gestite dall'operatore, segui questi passaggi:

1. Ricevi le approvazioni via email dai contatti delle reti gestite dagli operatori in cui vengono lanciati i tuoi agenti.
2. Condividi i seguenti dettagli con l'assistenza RBM:
   • ID partner RBM
   • I dettagli che vuoi modificare

Dopo aver verificato le approvazioni e i dettagli, il team di assistenza RBM comunicherà agli operatori le modifiche in attesa. Queste modifiche verranno implementate e confermate entro 24 ore dalla notifica del corriere.

Richiesta di migrazione di un agente dal partner RBM A al partner B

Se l'agente è già stato lanciato su reti gestite dall'operatore, segui questi passaggi:

1. Ricevi le approvazioni via email dal contatto del brand e dai contatti delle reti gestite dall'operatore.
   • Assicurati che il nuovo partner RBM sia messo in copia nelle email di approvazione.
2. Condividi i seguenti dettagli con l'assistenza RBM:
   • ID agente
   • Approvazioni via email da parte del contatto del brand e degli operatori
   • Nuovo ID partner

Dopo aver verificato le approvazioni e i dettagli, il team di assistenza RBM comunicherà agli operatori le modifiche in attesa. Queste modifiche verranno implementate e confermate entro 24 ore dalla notifica del corriere.

Richiesta di migrazione degli agenti a un altro account partner

Condividi i seguenti dettagli per attivare aggiornamenti più rapidi:

• Elenco degli ID agente
• Vecchio ID partner
• Nuovo ID partner

Informazioni mancanti nei report sugli eventi di fatturazione

Condividi i seguenti dettagli per consentire una risoluzione dei problemi più rapida:

• Date per le quali mancano i file
• ID agente