Come posso utilizzare l'API StartOutboundVoiceContact di Amazon Connect per effettuare chiamate in uscita ai clienti?

Risoluzione

Nota: se ricevi errori quando esegui i comandi dell'Interfaccia della linea di comando AWS (AWS CLI), consulta Risoluzione degli errori per AWS CLI. Inoltre, assicurati di utilizzare la versione più recente di AWS CLI.

Crea un flusso di contatti in uscita

Importante: per creare un flusso di contatti, accedi all'istanza Amazon Connect come utente con autorizzazioni sufficienti nel profilo di sicurezza.

Completa i seguenti passaggi:

1. Utilizza ll'URL di accesso per accedere all'istanza Amazon Connect. Utilizza https://alias.awsapps.com/connect/login o https://alias.awsapps.com/connect/login.
   Nota: sostituisci alias con l'alias della tua istanza.
2. Nel pannello di navigazione, passa il mouse su Routing, quindi scegli Flussi di contatti.
3. Nella pagina Flussi di contatti, scegli un modello. Oppure scegli Crea flusso di contatti per progettare un nuovo flusso di contatti.
4. Nel designer del flusso di contatti, in Inserisci un nome, inserisci un nome per il flusso di contatti. Ad esempio, "Outbound calling."
5. Scegli Salva.

Per ulteriori informazioni, consulta Usa lo strumento di progettazione dei flussi in Amazon Connect per creare flussi.

Aggiungi un blocco Riproduci prompt

Per configurare il messaggio audio che i clienti sentiranno durante la chiamata, utilizza un Blocco di flusso in Amazon Connect: Riproduci prompt.

Completa i seguenti passaggi:

1. Nel designer del flusso di contatti, espandi Interagisci.
2. Trascina e rilascia un blocco Riproduci prompt sull'area di disegno.
3. Scegli il titolo del blocco Riproduci prompt.
4. Per Prompt, scegli Sintesi vocale (Ad hoc).
5. In Inserisci testo, inserisci un messaggio. Ad esempio, inserisci "Hello. This is a test call."
6. Verifica che Interpreta come sia impostato su Testo.
7. Scegli Salva.

Per ulteriori informazioni, consulta Aggiungi text-to-speech ai prompt nei blocchi di flusso in Amazon Polly e Uso degli attributi di contatto di Amazon Connect.

Aggiungi un blocco di flusso Disconnetti/riaggancia

Per terminare automaticamente la chiamata dopo la riproduzione del messaggio in uscita, utilizza un blocco di flusso Disconnetti/riaggancia.

Completa i seguenti passaggi:

1. Scegli Termina/Trasferisci.
2. Trascina e rilascia un blocco Disconnetti/riaggancia sull'area di disegno a destra del blocco Riproduci prompt.

Collega i blocchi di contatti

Collega tutti i connettori del flusso di contatti a un blocco nel seguente ordine: Punto di ingresso, Riproduci prompt e Disconnetti/Riaggancia.

Devi collegare tutti i connettori a un blocco prima di pubblicare il flusso di contatti.

Salva e pubblica il flusso di contatti

Completa i seguenti passaggi:

1. Scegli Salva per salvare una bozza del flusso.
2. Scegli Pubblica per attivare immediatamente il flusso.

Ottieni l'ID dell'istanza Amazon Connect e l'ID del flusso di contatti

Completa i seguenti passaggi:

1. Nel designer del flusso di contatti, espandi Mostra ulteriori informazioni sul flusso.
2. In ARN, copia il nome della risorsa Amazon (ARN). L'ARN del flusso di contatti include l'ID dell'istanza Amazon Connect e l'ID del flusso di contatti. Questi ID sono necessari per chiamare l'API StartOutboundVoiceContact.

Esempio di ARN di un flusso di contatti:

arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact-flow/123a45b6-c7d8-9012-34e5-6fab789c012d

Verifica le autorizzazioni IAM per Amazon Connect

Collega una policy AWS Identity and Access Management (AWS IAM) al ruolo IAM per chiamare l'API connect:StartOutboundVoiceContact.

Esempio di policy JSON che fornisce le autorizzazioni richieste:

{  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "VisualEditor0",
      "Effect": "Allow",
      "Action": "connect:StartOutboundVoiceContact",
      "Resource": "arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact/*"
    }
  ]
}

Nota: sostituisci l'ARN con l'ARN della tua istanza Amazon Connect.

Chiama l'API StartOutboundVoiceContact

Esegui il comando AWS CLI start-outbound-voice-contact per chiamare l'API StartOutboundVoiceContact:

aws connect start-outbound-voice-contact --region awsRegion --destination-phone-number phoneNumber --contact-flow-id contactFlowId --instance-id instanceId --source-phone-number instancePhoneNumber

Nota: sostituisci awsRegion con la Regione AWS dell'istanza Amazon Connect. Sostituisci phoneNumber con il numero di telefono di un destinatario in formato E.164. Sostituisci contactFlowId con l'ID del tuo flusso di contatti e instanceId con l'ID della tua istanza Amazon Connect. Sostituisci instancePhoneNumber con il numero di telefono del tuo contact center in formato E.164.

La risposta al comando restituisce un ContactId quando l'azione ha esito positivo. Se invece l'operazione non ha esito positivo ricevi un codice di errore.

Informazioni correlate

Crea prompt in Amazon Connect

Configura l'ID chiamante in uscita in Amazon Connect

Automating outbound calling to customers using Amazon Connect (Automatizzazione delle chiamate in uscita verso i clienti utilizzando Amazon Connect)