Como faço para usar a API StartOutboundVoiceContact do Amazon Connect para fazer chamadas de saída para clientes?

Resolução

Observação: se você receber mensagens de erro ao executar comandos da AWS Command Line Interface (AWS CLI), consulte Solução de problemas da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Preencha os pré-requisitos

Antes de criar um fluxo de contato de saída, realize as seguintes ações:

• Ative as chamadas de saída para a instância do Amazon Connect.
• Verifique se o número de destino está na lista de permissões de saída.
• Reivindique um número de telefone no Amazon Connect e certifique-se de que o número de telefone reivindicado ofereça suporte a chamadas de saída.

Observação: se você estiver usando uma nova conta da AWS, sua conta pode ter restrições de chamadas de saída. Para solicitar um aumento de cota, consulte Solicitar um aumento de cota.

Crie um fluxo de contato de saída

Para criar um fluxo de contato, faça login na sua instância do Amazon Connect como um usuário com permissões suficientes no perfil de segurança.

Conclua as etapas a seguir:

1. Use seu URL de acesso para fazer login na sua instância do Amazon Connect. Por exemplo, https://alias.my.connect.aws.
   Observação: substitua alias pelo alias da sua instância.
2. No painel de navegação, passe o mouse sobre Routing (Roteamento) e clique em Contact flows (Fluxos de contato).
3. Na página Contact flows (Fluxos de contato), selecione um modelo. Ou clique em Create contact flow (Criar fluxo de contato) para criar um fluxo de contato do zero.
4. No editor do fluxo de contato, em Enter a name (Inserir um nome), insira um nome para seu fluxo de contato. Por exemplo, "Chamada de saída".
5. Clique em Save (Salvar).

Para obter mais informações, consulte Use o designer de fluxo no Connect Customer para criar fluxos.

(Opcional) Adicione um bloco Set logging behavior (Definir comportamento de registro em log)

Para rastrear eventos à medida que os contatos interagem com os fluxos, use um bloco de fluxo Set logging behavior.

Conclua as etapas a seguir:

1. No editor do fluxo de contato, expanda Analyze (Analisar).
2. Arraste e solte um bloco Set logging behavior (Definir comportamento de registro em log) na tela.
3. Clique no título do bloco Set logging behavior (Definir comportamento de registro em log).
4. Em Logging behavior (Comportamento de registro em log), selecione Enable (Ativar).
5. Clique em Save (Salvar).

Para obter mais informações, consulte Ative os registros de fluxo do Connect Customer em um grupo de CloudWatch registros da Amazon.

(Opcional) Adicione um bloco Set voice (Definir voz)

Para definir o idioma de conversão de texto em fala (TTS) e a voz usados quando o Amazon Connect fala prompts aos contatos, use um bloco de fluxo Set voice.

Conclua as etapas a seguir:

1. No editor do fluxo de contato, expanda Set (Configurar).
2. Arraste e solte um bloco Set voice (Definir voz) na tela.
3. Clique no título do bloco Set voice (Definir voz).
4. Em Language (Idioma), selecione seu idioma de preferência.
5. Em Voice (Voz), selecione sua voz de preferência.
6. (Opcional) Para alterar o estilo da fala, clique em Override speaking style (Substituir estilo de fala) e, em seguida, selecione Standard (Padrão), Neutral (Neutro) ou Generative (Generativo).
   Observação: vozes generativas podem gerar cobranças adicionais.
7. Clique em Save (Salvar).

Para obter mais informações, consulte Adicionar conversão de texto em fala em prompts em blocos de fluxo no Amazon Polly.

Adicione um bloco Play prompt (Reproduzir prompt)

Para configurar o prompt de áudio que os clientes ouvem durante a chamada, use um bloco de fluxo Play prompt (Reproduzir prompt).

Conclua as etapas a seguir:

1. No editor do fluxo de contato, expanda Interact (Interagir).
2. Arraste e solte um bloco Play prompt (Reproduzir prompt) na tela.
3. Clique no título do bloco play prompt (Reproduzir prompt).
4. Em Prompt, selecione Text to speech (Ad hoc) (Texto para fala (ad hoc)).
5. Em Enter text (Inserir texto), digite uma mensagem. Por exemplo, digite "Olá. Esta é uma chamada de teste."
6. Confirme se Interpret as (Interpretar como) está definido como Text (Texto).
7. Clique em Save (Salvar).

Para obter mais informações, consulte Adicionar conversão de texto em fala em prompts em blocos de fluxo no Amazon Polly e Use os atributos de contato do Connect Customer.

Adicione um bloco de fluxo Disconnect / hang up (Desconectar/desligar)

Para encerrar automaticamente a chamada após a reprodução da mensagem de saída, use um bloco de fluxo Disconnect / hang up.

Conclua as etapas a seguir:

1. Selecione Terminate/Transfer (Encerrar/Transferir).
2. Arraste e solte um bloco Disconnect / hang up (Desconectar/desligar) na tela à direita do bloco Play prompt (Reproduzir prompt).

Conecte os blocos de contato

Conecte todos os conectores em seu fluxo de contato a um bloco na seguinte ordem: Entry point (Ponto de entrada), Set logging behavior (Definir comportamento de registro em log) (se configurado), Set voice (Definir voz) (se configurado), Play prompt (Reproduzir prompt) e Disconnect / hang up (Desconectar/desligar).

Você deve conectar todos os conectores a um bloco antes de publicar o fluxo de contato.

Salve e publique o fluxo de contato

Conclua as etapas a seguir:

1. Selecione Save (Salvar) para salvar um rascunho do fluxo.
2. Clique em Publish (Publicar) para ativar o fluxo imediatamente.

Obtenha seu ID da instância do Amazon Connect e seu ID de fluxo de contato

Conclua as etapas a seguir:

1. No editor do fluxo de contato, clique na guia Details (Detalhes).
2. Em ARN, copie o Nome do recurso da Amazon (ARN). O ARN do fluxo de contato inclui seu ID da instância do Amazon Connect e seu ID de fluxo de contato. Esses IDs são necessários para chamar a API StartOutboundVoiceContact.

Exemplo de ARN de fluxo de contato:

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

Confirme suas permissões do IAM para o Amazon Connect

Anexe uma política do AWS Identity and Access Management (AWS IAM) ao seu perfil do IAM para chamar a API connect:StartOutboundVoiceContact.

Exemplo de política JSON que fornece as permissões necessárias:

{
  "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/*"
    }
  ]
}

Observação: substitua o ARN pelo ARN da sua instância do Amazon Connect.

Chame a API StartOutboundVoiceContact

Execute o comando start-outbound-voice-contact da AWS CLI para chamar a 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

Observação: substitua awsRegion pela região da AWS da sua instância do Amazon Connect. Substitua phoneNumber pelo número de telefone de um destinatário no formato E.164. Substitua contactFlowId pelo seu ID de fluxo de contato e instanceId pelo seu ID da instância do Amazon Connect. Substitua instancePhoneNumber pelo número de telefone da sua central de atendimento no formato E.164.

Se a ação for bem-sucedida, a resposta do comando retorna um ContactId. Se a ação não for bem-sucedida, você receberá um código de erro.

Informações relacionadas

Crie solicitações no Connect Customer

Configurar o identificador de chamadas externas no Connect Customer

Automating outbound calling to customers using Amazon Connect (Automatizar chamadas de saída para clientes usando o Amazon Connect)