Abilitazione delle notifiche push per la chat mobile - Amazon Connect

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Abilitazione delle notifiche push per la chat mobile

Le notifiche push per la chat mobile sono configurate tramite AWS End User Messaging. Puoi abilitare le notifiche push per la chat mobile su dispositivi iOS o Android, in modo da avvisare i clienti di nuovi messaggi anche quando non utilizzano attivamente l’applicazione mobile. Puoi abilitare questa funzionalità nella tua app esistente integrata con il Amazon Connect dispositivo mobile SDKs, in una soluzione di visualizzazione web o in una soluzione nativa personalizzata.

I passaggi e le risorse seguenti ti aiuteranno a iniziare a integrare le notifiche Amazon Connect push nelle tue applicazioni mobili native:

Passaggio 1: ottieni le credenziali dalla console FCM di Apple APNs e Google

Per effettuare la configurazione in Amazon Connect modo da poter inviare notifiche push alle tue app, devi prima ottenere le credenziali dalla console FCM di Apple APNs e Google che consentiranno a AWS End User Messaging di inviare notifiche alle tue applicazioni mobili. Le credenziali fornite dipendono dal sistema di notifiche push che utilizzi:

Fase 2: Creare un'applicazione di servizio di messaggistica per l'utente AWS finale utilizzando la AWS console e abilitare il canale di notifica push per FCM o APNs

Prima di poter abilitare Amazon Connect per l’invio di notifiche push, è necessario creare un’applicazione AWS End User Messaging e abilitare il canale delle notifiche push nella Console AWS.

Segui queste istruzioni per creare un’applicazione e abilitare uno qualsiasi dei canali push. Per completare questa procedura è necessario solo inserire il nome di un’applicazione. Puoi abilitare o disabilitare qualsiasi canale push in un secondo momento:

  1. Aprire la console AWS End User Messaging Push all'indirizzo https://console.aws.amazon.com/push-notifications/

  2. Scegli Crea applicazione.

  3. Inserisci il nome dell’applicazione nel campo Nome applicazione.

  4. (Facoltativo) Segui questo passaggio facoltativo per abilitare il servizio Apple Push Notification (APNs).

    1. Per il servizio Apple Push Notification (APNs), seleziona Abilita.

    2. Per Tipo di autenticazione predefinita scegli:

      1. Se scegli Credenziali chiave, fornisci le seguenti informazioni dal tuo account sviluppatore Apple. AWS End User Messaging Push richiede queste informazioni per creare token di autenticazione.

        1. ID chiave: ID assegnato alla chiave di firma.

        2. Identificatore del bundle: ID assegnato all'app iOS.

        3. Identificatore del team: ID assegnato al team dell'account sviluppatore Apple.

        4. Chiave di autenticazione: file .p8 scaricato dall'account sviluppatore Apple quando crei una chiave di autenticazione.

      2. Se si sceglie Certificate credentials (Credenziali certificato), è necessario fornire le seguenti informazioni:

        1. SSL certificate (Certificato SSL): il file .p12 per il certificato TLS.

        2. Password certificato: se hai assegnato una password al certificato, immettila qui.

        3. Tipo di certificato: seleziona il tipo di certificato da utilizzare.

  5. (Facoltativo) Segui questo passaggio facoltativo per abilitare Firebase Cloud Messaging (FCM).

    1. Per Firebase Cloud Messaging (FCM) seleziona Abilita.

    2. Scegli Credenziali token per Tipo di autenticazione predefinita, quindi scegli il file JSON di servizio.

  6. Scegli Crea applicazione.

Fase 3: Associare l'applicazione AWS End User Messaging a un'istanza Amazon Connect

Per abilitare le notifiche push su un'Amazon Connect istanza, è necessario associare un'applicazione di messaggistica per l'utente AWS finale a un'Amazon Connect istanza chiamando l'CreateIntegrationAssociationAPI con PINPOINT_APP IntegrationType. Puoi chiamare questa API con l’interfaccia AWS CLI o l’SDK Amazon Connect per qualsiasi lingua supportata. Si tratta di una fase di onboarding una tantum necessaria per ogni integrazione tra un'applicazione di messaggistica con l'utente AWS finale e un'istanza. Amazon Connect

Passaggio 4: ottieni il token del dispositivo con FCM o APNs SDK e registralo con Amazon Connect

Dovrai recuperare il token del dispositivo e utilizzarlo per registrare un dispositivo mobile dell'utente finale con un contatto di Amazon Connect chat per inviare notifiche push per i nuovi messaggi nella chat. Leggi la seguente documentazione per FCM/APNs sviluppatori su come viene generato e ottenuto il token del dispositivo dall'applicazione mobile.

Per registrare il dispositivo con un contatto della chat, consigliamo di procedere come segue:

  1. Quando l'applicazione mobile chiama l'StartChatContactAPI, passa gli attributi deviceToken e deviceType come contatto. Per gli utenti del widget WebView e Hosted Communication, consulta Come trasferire gli attributi del contatto nel widget di comunicazione per maggiori dettagli.

  2. Incorpora una chiamata all'CreatePushNotificationRegistrationazione in una funzione Lambda in un flusso di contatti. Il blocco di flusso deve leggere deviceToken e deviceType dagli attributi di contatto definiti dall’utente, poi initialContactId dagli attributi di sistema, quindi trasferire questi valori alla funzione Lambda.

    1. A seconda del caso d’uso, includi la funzione Lambda immediatamente dopo l’avvio della chat (all’inizio del flusso) se desideri che l’utente finale riceva subito le notifiche push oppure subito prima di instradare il contatto a una coda in modo che riceva il contatto solo quando l’agente sta per unirsi. Una volta effettuata la chiamata API, il dispositivo inizierà a ricevere notifiche push quando arriva un nuovo messaggio dall’agente o dal sistema. Per impostazione predefinita, le notifiche push verranno inviate per tutti i messaggi del sistema e dell’agente.

      Invoca il blocco di flusso della funzione lambda nel designer di flusso del sito web di amministrazione di Amazon Connect .
  1. (opzionale) Incorpora una chiamata all'DeletePushNotificationRegistrationazione in una funzione Lambda in un flusso. Una volta effettuata la chiamata API, il dispositivo smetterà di ricevere notifiche push quando arriva un nuovo messaggio dall’agente o dal sistema.

Fase 5: ricevere notifiche push sulle applicazioni mobili

Dai un'occhiata al nostro progetto Amazon Connect Chat UI Examples e fai riferimento ai nostri esempi di visualizzazione web di chat per iOS e Android che mostrano come Amazon Connect APIs integrare e ricevere notifiche push.

Monitoraggio dell’utilizzo delle notifiche push

Per garantire l’affidabilità, la disponibilità e le prestazioni delle notifiche push, è fondamentale monitorarne l’utilizzo. Puoi tenere traccia di queste informazioni attraverso diversi canali:

  1. AWS fornisce strumenti di monitoraggio completi per le notifiche push. Per ulteriori informazioni, consulta Monitoraggio della messaggistica push per l'utente AWS finale.

  2. A seconda del servizio di notifica push che utilizzi, puoi accedere a dati di utilizzo aggiuntivi tramite le rispettive console.

    1. Firebase Cloud Messaging (FCM): consulta la documentazione FCM su Informazioni sulla consegna dei messaggi per informazioni dettagliate sull’utilizzo di FCM.

    2. Servizio Apple Push Notification (APNs): APNs consulta la sezione della documentazione sulla visualizzazione dello stato delle notifiche push tramite Metrics e APNs sul monitoraggio dello stato delle notifiche.