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

Migrazione dell'audio PSTN dell'SDK Amazon Chime su Amazon Connect

I seguenti argomenti spiegano come migrare i carichi di lavoro Amazon Chime SDK PSTN Audio su Amazon Connect.

Panoramica di

Questa guida fornisce istruzioni dettagliate per la migrazione dei carichi di lavoro dal servizio PSTN Audio Amazon Chime SDK ad Amazon Connect. Mostra come mappare la logica Lambda dell'applicazione multimediale SIP esistente ai flussi di contatti di Amazon Connect. Identifica inoltre la funzionalità Amazon Connect equivalente per ogni funzionalità PSTN Audio.

Pianifica circa 20 ore di migrazione per applicazione. Lo sforzo effettivo varia in base alla complessità.

Prerequisiti

Prima di iniziare la migrazione, assicurati di disporre di quanto segue:

Confronto tra architetture

La tabella seguente confronta i concetti di PSTN Audio con gli equivalenti di Amazon Connect.

Fase 1: configura la tua istanza Amazon Connect

Segui la documentazione di Amazon Connect per creare e configurare la tua istanza. Per istruzioni, consulta Configurare l'istanza.

Quando configuri l'istanza, imposta le seguenti opzioni:

Dopo aver creato l'istanza, accedi all'interfaccia di amministrazione di Amazon Connect.

Fase 2: Trasferisci o richiedi i numeri di telefono

Hai due opzioni per inserire i numeri di telefono in Amazon Connect.

Opzione A: trasferisci i numeri esistenti

Opzione B: richiedi nuovi numeri

Fase 3: Convertire la logica Lambda in un flusso di contatti

Questo passaggio è il fulcro della migrazione. I seguenti argomenti associano ogni azione PSTN Audio all'equivalente di Amazon Connect e spiegano come inserire ricerche di dati esterne nel flusso di contatti.

Action-to-block mappatura

Le seguenti sezioni mostrano il blocco Amazon Connect che sostituisce ogni azione PSTN Audio.

PlayAudio a Play prompt

In PSTN Audio, si riproduce un file audio con l'azione. PlayAudio

{
    "Type": "PlayAudio",
    "Parameters": {
        "CallId": "call-id-1",
        "AudioSource": {
            "Type": "S3",
            "BucketName": "my-bucket",
            "Key": "welcome.wav"
        }
    }
}

In Amazon Connect, esegui le seguenti operazioni:

PlayAudioAndGetDigits per ottenere l'input dei clienti

In PSTN Audio, riproduci un prompt e raccogli cifre con l'azione. PlayAudioAndGetDigits

{
    "Type": "PlayAudioAndGetDigits",
    "Parameters": {
        "CallId": "call-id-1",
        "AudioSource": {
            "Type": "S3",
            "BucketName": "my-bucket",
            "Key": "enter-pin.wav"
        },
        "FailureAudioSource": {
            "Type": "S3",
            "BucketName": "my-bucket",
            "Key": "invalid-entry.wav"
        },
        "MinNumberOfDigits": 4,
        "MaxNumberOfDigits": 4,
        "TerminatorDigits": ["#"],
        "InBetweenDigitsDurationInMilliseconds": 5000,
        "Repeat": 3,
        "RepeatDurationInMilliseconds": 10000
    }
}

In Amazon Connect, esegui le seguenti operazioni:

Notate le seguenti differenze chiave:

Speak and SpeakAndGetDigits to Play prompt con sintesi vocale

In PSTN Audio, converti il testo in voce con le azioni e. Speak SpeakAndGetDigits

{
    "Type": "Speak",
    "Parameters": {
        "CallId": "call-id-1",
        "Text": "Your account balance is 500 dollars",
        "Engine": "neural",
        "LanguageCode": "en-US",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}

In Amazon Connect, esegui le seguenti operazioni:

Per inserire valori dinamici, usa $.Attributes.VariableName o. $.External.VariableName

CallAndBridge per trasferire al numero di telefono

In PSTN Audio, si trasferisce una chiamata a un endpoint PSTN con l'azione. CallAndBridge

{
    "Type": "CallAndBridge",
    "Parameters": {
        "CallTimeoutSeconds": 30,
        "CallerIdNumber": "+15551234567",
        "Endpoints": [{
            "BridgeEndpointType": "PSTN",
            "Uri": "+15559876543"
        }]
    }
}

In Amazon Connect, esegui le seguenti operazioni:

Notate le seguenti differenze chiave:

RecordAudio per Impostare il comportamento di registrazione e analisi

In PSTN Audio, si registra una chiamata con l'azioneRecordAudio.

{
    "Type": "RecordAudio",
    "Parameters": {
        "CallId": "call-id-1",
        "DurationInSeconds": "10",
        "SilenceDurationInSeconds": 3,
        "RecordingTerminators": ["#"],
        "RecordingDestination": {
            "Type": "S3",
            "BucketName": "my-recordings",
            "Prefix": "calls/"
        }
    }
}

In Amazon Connect, esegui le seguenti operazioni:

Amazon Connect archivia le registrazioni nel bucket Amazon S3 che hai configurato per la tua istanza. Nota le seguenti differenze chiave:

ReceiveDigits per memorizzare gli input dei clienti

In PSTN Audio, raccogli le cifre con l'azione. ReceiveDigits

{
    "Type": "ReceiveDigits",
    "Parameters": {
        "CallId": "call-id-1",
        "InputDigitsRegex": "^\\d{4}$",
        "InBetweenDigitsDurationInMilliseconds": 5000,
        "FlushDigitsDurationInMilliseconds": 10000
    }
}

In Amazon Connect, esegui le seguenti operazioni:

Amazon Connect memorizza le cifre inserite in$.StoredCustomerInput.

SendDigits a un equivalente limitato

In PSTN Audio, si inviano cifre DTMF con l'azione. SendDigits

{
    "Type": "SendDigits",
    "Parameters": {
        "CallId": "call-id-1",
        "Digits": "1,,,,2"
    }
}

In Amazon Connect, il blocco Trasferimento a numero di telefono include l'opzione Invia cifre. Questa opzione invia il DTMF alle estensioni di chiamata dopo la connessione. Per scenari DTMF più complessi, potrebbero essere necessarie modifiche all'architettura.

Hangup to Disconnect /Hang Up

In PSTN Audio, si termina una chiamata con l'azione. Hangup

{
    "Type": "Hangup",
    "Parameters": {
        "CallId": "call-id-1",
        "SipResponseCode": "0"
    }
}

In Amazon Connect, aggiungi un blocco Disconnect/hang up. Questo blocco interrompe il contatto.

Pausa per aspettare

In PSTN Audio, metti in pausa una chiamata con l'azione. Pause

{
    "Type": "Pause",
    "Parameters": {
        "CallId": "call-id-1",
        "DurationInMilliseconds": "3000"
    }
}

In Amazon Connect, aggiungi un blocco Wait, quindi configura la durata del timeout.

JoinChimeMeeting non ha un equivalente diretto

In PSTN Audio, puoi partecipare a una riunione Amazon Chime SDK da una chiamata con l'azione. JoinChimeMeeting

{
    "Type": "JoinChimeMeeting",
    "Parameters": {
        "CallId": "call-id-1",
        "JoinToken": "meeting-join-token",
        "MeetingId": "meeting-id"
    }
}

Amazon Connect non offre un equivalente diretto per partecipare a una riunione Amazon Chime SDK tramite una telefonata. Tenere presente quanto segue:

TransactionAttributes per impostare gli attributi dei contatti

In PSTN Audio, si memorizza il contesto della chiamata con l'azioneTransactionAttributes.

{
    "Type": "TransactionAttributes",
    "Parameters": {
        "key1": "value1",
        "key2": "value2"
    }
}

In Amazon Connect, esegui le seguenti operazioni:

Fate riferimento all'attributo in un secondo momento come$.Attributes.key1.

StartBotConversation per ottenere l'input dei clienti con un bot Lex

In PSTN Audio, si avvia una conversazione con il bot con l'StartBotConversationazione.

{
    "Type": "StartBotConversation",
    "Parameters": {
        "CallId": "call-id-1",
        "BotAliasArn": "arn:aws:lex:us-east-1:123456789:bot-alias/BOTID/ALIASID",
        "LocaleId": "en_US"
    }
}

In Amazon Connect, esegui le seguenti operazioni:

Ricerche esterne di dati

Se la tua funzione PSTN Audio Lambda richiama API o database esterni, puoi portare la stessa logica in Amazon Connect.

Tieni presente i seguenti limiti:

Fase 4: Migrazione delle istruzioni audio

Per spostare le istruzioni audio in Amazon Connect, procedi come segue.

Passaggio 5: configura le chiamate in uscita

Se lo utilizzi CreateSipMediaApplicationCall per le chiamate in uscita, scegli uno dei seguenti approcci.

Per il controllo programmatico delle chiamate (primario)

Per notifiche in uscita ad alto volume o IVR (secondario)

Passaggio 6: verifica la migrazione

Per convalidare la migrazione, procedi come segue.

Fase 7: Riduci il traffico di produzione

Per spostare il traffico di produzione su Amazon Connect, procedi come segue.

Fase 8: disattivazione delle risorse audio PSTN

Dopo aver verificato che la migrazione è stabile, procedi come segue.

Modelli di migrazione comuni

I modelli seguenti mostrano come i progetti audio PSTN più comuni vengono mappati su Amazon Connect.

Schema 1: inoltro di chiamata semplice

La seguente funzione PSTN Audio Lambda inoltra una chiamata.

exports.handler = async (event) => {
    return {
        SchemaVersion: "1.0",
        Actions: [{
            Type: "CallAndBridge",
            Parameters: {
                CallTimeoutSeconds: 30,
                CallerIdNumber: event.CallDetails.Participants[0].From,
                Endpoints: [{ BridgeEndpointType: "PSTN", Uri: "+15559876543" }]
            }
        }]
    };
};

L'equivalente di Amazon Connect è un flusso a due blocchi:

Schema 2: menu IVR

In PSTN Audio, la funzione Lambda esegue un prompt, raccoglie cifre, rami sull'ingresso, quindi trasferisce o riproduce altri prompt.

L'equivalente di Amazon Connect è il seguente flusso:

Schema 3: notifica in uscita con risposta

In PSTN Audio, si chiama, si pronuncia un messaggioCreateSipMediaApplicationCall, si raccolgono le cifre e si elabora PlayAudioAndGetDigits la risposta.

L'equivalente di Amazon Connect utilizza l'StartOutboundVoiceContactAPI con un flusso di contatti che esegue le seguenti operazioni:

Limitazioni e lacune note

La tabella seguente elenca le funzionalità che differiscono tra PSTN Audio e Amazon Connect.

Utilizzo della guida

Utilizzate le seguenti risorse per aiutarvi con la migrazione: