Come creare un link diretto alle app dal tuo agente RBM

Nelle app mobile, i link diretti consentono agli utenti di accedere direttamente ai contenuti all'interno di un'app. Senza i link diretti, se condividi con il tuo amico una maglietta trovata in un'app di un negozio di vendita al dettaglio, il link inviato li reindirizza al browser dell'utente o al Play Store, dove deve installare o aprire l'app e quindi cercare i contenuti. Nessuna delle due situazioni offre un'esperienza utente ottimale. Con i link diretti, il link indirizza il tuo amico alla camicia esatta che hai trovato all'interno dell'app di vendita al dettaglio.

In questo documento imparerai a utilizzare i link diretti per creare esperienze complete e coinvolgenti per i tuoi utenti RBM.

Indirizzare un utente RBM a un'app

Un link diretto è solo un link a un'app. L'agente RBM può aprire un'app installata sullo smartphone di un utente utilizzando un'azione OpenUrl in cui l'URL è un link diretto configurato per l'app che vuoi richiamare. Scopri di più nella sezione Creare link diretti ai contenuti dell'app.

Vedi l'esempio che segue. Per aprire Google Cloud Podcast nell'app Google Podcast, è possibile creare un OpenUrlAction con l'URI:

https://www.google.com/podcasts?feed=aHR0cDovL2ZlZWRzLmZlZWRidXJuZXIuY29tL0dvb2dsZUNsb3VkUGxhdGZvcm1Qb2RjYXN0

Molti prodotti Google sono configurati per supportare i link diretti che funzionano anche come URL web, tra cui YouTube e Google Maps.

Per attivare una di queste app da un agente, dobbiamo specificare questo valore come URL in un'azione OpenUrl. Nel seguente JSON di esempio, viene specificata una scheda rich RBM con tre azioni di apertura dell'URL, ciascuna con un link diretto a un'app diversa.

{
    "contentMessage":{
        "richCard":{
            "standaloneCard":{
                "cardOrientation":"VERTICAL",
                "cardContent":{
                    "title":"Did you know that you can open apps from an RBM agent?",
                    "description":"",
                    "suggestions":[
                        {
                            "action":{
                                "text":"Google Cloud Podcast",
                                "postbackData":"podcast_tap",
                                "openUrlAction":{
                                    "url":"https://www.google.com/podcasts?feed=aHR0cDovL2ZlZWRzLmZlZWRidXJuZXIuY29tL1JvYkNlc3Rlcm5pbm8&nord=0"
                                }
                            }
                        },
                        {
                            "action":{
                                "text":"YouTube Video",
                                "postbackData":"youtube_tap",
                                "openUrlAction":{
                                    "url":"https://www.youtube.com/embed/xSE9Qk9wkig"
                                }
                            }
                        },
                        {
                            "action":{
                                "text":"Google Maps",
                                "postbackData":"maps_tap",
                                "openUrlAction":{
                                    "url":"https://goo.gl/maps/ToMSdr4PYX62"
                                }
                            }
                        }
                    ]
                }
            }
        }
    }
}

Quando questo payload JSON viene visualizzato nel client RCS di un utente, l'icona dell'azione suggerita corrisponde all'app con link diretto. Se tocchi una delle azioni suggerite, l'app corrispondente viene avviata direttamente ai contenuti codificati nell'URL.

URL suggeriti con icone di app

Perché vuoi riceverlo?

Esistono diversi motivi per cui potresti voler inserire un link diretto in un'app.

Autenticazione

Se il tuo agente gestisce informazioni potenzialmente sensibili, un modo per contribuire a proteggerlo è inserire un link diretto alla tua app per autenticare l'utente tramite impronta, accesso o altri mezzi. Una volta che l'utente si è autenticato correttamente, puoi monitorare l'autenticazione lato server e riportarlo all'agente attivando un nuovo messaggio RBM. Se invii messaggi di follow-up potenzialmente sensibili, puoi verificare lato server per assicurarti che l'utente sia autenticato. In caso contrario, puoi rimandarlo all'app per rinnovare il token di autenticazione.

Supporto di casi d'uso complessi

Gli agenti RBM sono ideali per le interazioni di conversazione, ma le app possono gestire meglio alcuni casi d'uso. Ad esempio, se hai un'azienda di mobili e hai creato un'esperienza di realtà aumentata per consentire agli utenti di provare i mobili nelle loro case (vedi l'immagine seguente), il tuo caso d'uso può essere supportato solo da un'app.

In questi casi, è consigliabile indirizzare gli utenti RBM alla tua app per eseguire alcune funzionalità. La tua app può sempre riportare l'utente alla conversazione RBM attivando un nuovo messaggio dell'agente.

Link diretto nell'app App con link diretto

Facilita il pagamento

Puoi supportare i pagamenti con un'app di terze parti con link diretti.

Ad esempio, supponiamo che tu voglia supportare i trasferimenti di denaro tramite la società di pagamento fittizia AcmePay. Da un'indagine online è emerso che AcmePay supporta i link diretti utilizzando una propria struttura URI univoca che ti consente di passare i valori per i destinatari, l'importo e una nota utilizzando i parametri di stringa di query.

Grazie a queste informazioni, l'agente deve creare un OpenUrlAction con l'URI AcmePay con parametri specificato per la parte dell'URL dell'azione suggerita.

acmepay://paycharge?recipients=Jane+Smith&amount=10&note=Money+For+You!

Una volta che il destinatario del messaggio RBM tocca l'azione suggerita, l'app AcmePay si avvia direttamente nella schermata della transazione con i valori passati già compilati.

Che cosa succede se l'app non è installata?

Se un'app non è installata sul dispositivo di un utente, il comportamento dei link diretti dipende dalla struttura dell'URI passato a OpenUrlAction. Se l'URI può essere riconosciuto da almeno un'app sul dispositivo (ad esempio Chrome riconosce gli URL che iniziano con "http://"), l'azione suggerita viene visualizzata normalmente in quell'app. Quando l'utente tocca l'azione, l'URI si apre nell'app che riconosce la struttura dell'URI.

Se sei lo sviluppatore dell'app, è vantaggioso utilizzare link diretti con URI che iniziano con "http://" e che rimandano a un dominio di tua proprietà, perché Chrome può indirizzare l'utente a una pagina web come azione di riserva. Nella pagina web, puoi invitare l'utente a scaricare l'app o indirizzarlo come ritieni opportuno in base al tuo caso d'uso.

Se l'URI utilizza una struttura personalizzata non riconosciuta da alcuna app sul dispositivo, l'azione suggerita non verrà visualizzata nel messaggio RBM.

Per assicurarti che le azioni suggerite vengano sempre visualizzate, puoi utilizzare un URL di tua proprietà e fare in modo che la pagina web tenti di reindirizzare il browser a un URI personalizzato che avvii l'app. Se l'app è presente sul dispositivo, si avvia come previsto. In caso contrario, l'utente rimane nella pagina web, dove puoi indirizzarlo in base alle tue esigenze.

Di seguito è riportato un esempio di come eseguire questa operazione con JavaScript. Lo script tenta di reindirizzare l'utente all'app AcmePay, ma se l'app non è installata, lo script reindirizza l'utente al Google Play Store per scaricare l'app.

<!doctype html>
<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <meta name="viewport" content="width=device-width,minimum-scale=1.0, maximum-scale=1.0" />
    <title>Acme Pay</title>

    <script type="text/javascript">
    window.onload = function() {
       // Launch Acme Pay app for existing users
       window.location = 'acmepay://paycharge?recipients=Jane+Smith&amount=10&note=Money+For+You!';

       // Redirect to Acme Pay app download for new users
       setTimeout("window.location = 'https://play.google.com/store/apps/details?id=com.acmepay.android';", 1000);
    }
    </script>
</head>
<body>
    <h1>Redirecting…</h1>
</body>
</html>

Riepilogo e conclusione

Puoi utilizzare l'azione suggerita OpenUrlAction per creare un link diretto alle app di tua proprietà o a quelle che vuoi attivare per coinvolgere i tuoi utenti. Con i link diretti, puoi offrire un'esperienza arricchita e coinvolgente per i tuoi utenti o una maggiore sicurezza per la condivisione di contenuti sensibili.

Buona fortuna e buona programmazione.