Partilhar via

Comunicação: Criando um recurso dos Serviços de Comunicação do Azure

Uma comunicação eficaz é essencial para o sucesso de aplicativos de negócios personalizados. Usando os Serviços de Comunicação do Azure (ACS), você pode adicionar recursos como chamadas telefônicas, bate-papo ao vivo, chamadas de áudio/vídeo e mensagens de email e SMS aos seus aplicativos. Anteriormente, você aprendeu como o Azure OpenAI pode gerar conclusões para mensagens de email e SMS. Agora, você aprenderá como enviar as mensagens. Juntos, o ACS e o OpenAI podem aprimorar seus aplicativos simplificando a comunicação, melhorando as interações e aumentando a produtividade dos negócios.

Neste exercício, você irá:

  • Crie um recurso dos Serviços de Comunicação do Azure (ACS).
  • Adicione um número de telefone gratuito com recursos de chamadas e SMS.
  • Conecte um domínio de e-mail.
  • Atualize o arquivo .env do projeto com valores do seu recurso ACS.

Visão geral do cenário do Microsoft Cloud

Criar um recurso dos Serviços de Comunicação do Azure

  1. Visite o portal do Azure em seu navegador e entre se ainda não o fez.

  2. Digite serviços de comunicação na barra de pesquisa na parte superior da página e selecione Serviços de comunicação nas opções exibidas.

    ACS no portal do Azure

  3. Selecione Criar na barra de ferramentas.

  4. Execute as seguintes tarefas:

    • Selecione sua assinatura do Azure.
    • Selecione o grupo de recursos a ser usado (crie um novo, se não existir).
    • Insira um nome de recurso ACS. Tem de ser um valor exclusivo.
    • Selecione um local de dados.

  5. Selecione Rever + Criar seguido de Criar.

  6. Você criou com êxito um novo recurso dos Serviços de Comunicação do Azure! Em seguida, você habilitará os recursos de chamadas telefônicas e SMS. Você também conectará um domínio de e-mail ao recurso.

Habilite os recursos de chamadas telefônicas e SMS

  1. Adicione um número de telefone e verifique se o número de telefone tem recursos de chamada ativados. Irá utilizar este número de telefone para ligar para um telefone a partir da aplicação.

    • Selecione Telefonia e SMS -->Números de telefone no menu Recurso.

    • Selecione + Obter na barra de ferramentas (ou selecione o botão Obter um número ) e insira as seguintes informações:

      • País ou região: United States
      • Tipo de número: Toll-free

      Observação

      É necessário um cartão de crédito na sua subscrição do Azure para criar o número gratuito. Se você não tiver um cartão registrado, sinta-se à vontade para pular a adição de um número de telefone e ir para a próxima seção do exercício que conecta um domínio de e-mail. Você ainda pode usar o aplicativo, mas não poderá ligar para um número de telefone.

      • Número: Selecione Adicionar ao carrinho para um dos números de telefone listados.

  2. Selecione Seguinte, reveja os detalhes do número de telefone e selecione Comprar agora.

    Observação

    A verificação por SMS para números gratuitos é agora obrigatória nos Estados Unidos e no Canadá. Para habilitar as mensagens SMS, você deve enviar a verificação após a compra do número de telefone. Embora este tutorial não passe por esse processo, você pode selecionar Telefonia e SMS -->Documentos regulatórios no menu de recursos e adicionar a documentação de validação necessária.

  3. Depois que o número de telefone for criado, selecione-o para acessar o painel Recursos . Certifique-se de que os seguintes valores estão definidos (eles devem ser definidos por padrão):

    • Na seção Chamadas , selecione Make calls.
    • Na seção SMS , selecione Send and receive SMS.
    • Selecione Guardar.

  4. Copie o valor do número de telefone em um arquivo para uso posterior. O número de telefone deve seguir este padrão geral: +12345678900.

Conectar um domínio de e-mail

  1. Execute as seguintes tarefas para criar um domínio de email conectado para seu recurso ACS para que você possa enviar email. Isso será usado para enviar e-mails do aplicativo.

    • Selecione Email -->Domínios no menu Recurso.
    • Selecione Conectar domínio na barra de ferramentas.
    • Selecione o seu grupo Subscrição e Recursos.
    • Na lista suspensa Serviço de e-mail , selecione Add an email service.
    • Dê ao serviço de e-mail um nome como acs-demo-email-service.
    • Selecione Rever + criar seguido de Criar.
    • Quando a implantação for concluída, selecione Go to resourcee selecione 1-click add para adicionar um subdomínio gratuito do Azure.
    • Depois que o subdomínio for adicionado (levará alguns momentos para ser implantado), selecione-o.
    • Quando estiver na tela AzureManagedDomain , selecione Serviços de email -->MailFrom addresses no menu Recurso.
    • Copie o valor MailFrom para um arquivo. Você o usará mais tarde à medida que atualizar o arquivo .env .
    • Volte para o recurso dos Serviços de Comunicação do Azure e selecione Email -->Domínios no menu de recursos.
    • Selecione Add domain e insira o MailFrom valor da etapa anterior (certifique-se de selecionar a assinatura, o grupo de recursos e o serviço de email corretos). Selecione o botão Connect.

Atualizar o .env arquivo

  1. Agora que seu número de telefone ACS (com chamadas e SMS habilitados) e domínio de e-mail estão prontos, atualize as seguintes chaves/valores no arquivo .env em seu projeto:

    ACS_CONNECTION_STRING=<ACS_CONNECTION_STRING>
ACS_PHONE_NUMBER=<ACS_PHONE_NUMBER>
ACS_EMAIL_ADDRESS=<ACS_EMAIL_ADDRESS>
CUSTOMER_EMAIL_ADDRESS=<EMAIL_ADDRESS_TO_SEND_EMAIL_TO>
CUSTOMER_PHONE_NUMBER=<UNITED_STATES_BASED_NUMBER_TO_SEND_SMS_TO>

    • ACS_CONNECTION_STRING: O connection string valor da seção Chaves do recurso ACS.

    • ACS_PHONE_NUMBER: Atribua o ACS_PHONE_NUMBER seu número gratuito ao valor.

    • ACS_EMAIL_ADDRESS: Atribua o valor do seu endereço de e-mail "MailTo".

    • CUSTOMER_EMAIL_ADDRESS: atribua um endereço de e-mail para o qual você gostaria que o e-mail fosse enviado do aplicativo (já que os dados do cliente no banco de dados do aplicativo são apenas dados de exemplo). Você pode usar um endereço de e-mail pessoal.

    • CUSTOMER_PHONE_NUMBER: Você precisará fornecer um número de telefone baseado nos Estados Unidos (a partir de hoje) devido à verificação adicional que é necessária em outros países/regiões para enviar mensagens SMS. Se não tiver um número baseado nos EUA, pode deixá-lo vazio.

Iniciar/reiniciar os servidores de aplicativos e API

Execute uma das seguintes etapas com base nos exercícios concluídos até este ponto:

  • Se você iniciou o banco de dados, o servidor de API e o servidor Web em um exercício anterior, precisará parar o servidor de API e o servidor Web e reiniciá-los para pegar as alterações do arquivo .env . Você pode deixar o banco de dados em execução.

    Localize as janelas do terminal que executam o servidor API e o servidor Web e pressione CTRL + C para pará-las. Inicie-os novamente digitando npm start em cada janela do terminal e pressionando Enter. Continue para o próximo exercício.

  • Se você ainda não iniciou o banco de dados, o servidor de API e o servidor Web, conclua as seguintes etapas:

    1. Nas etapas a seguir, você criará três janelas de terminal no Visual Studio Code.

      Três janelas de terminal no Visual Studio Code

    2. Clique com o botão direito do mouse no arquivo .env na lista de arquivos de código do Visual Studio e selecione Abrir no Terminal integrado. Certifique-se de que seu terminal está na raiz do projeto - openai-acs-msgraph - antes de continuar.

    3. Escolha uma das seguintes opções para iniciar o banco de dados PostgreSQL:

      • Se você tiver o Docker Desktop instalado e em execução, execute docker-compose up na janela do terminal e pressione Enter.

      • Se você tiver o Podman com podman-compose instalado e em execução, execute podman-compose up na janela do terminal e pressione Enter.

      • Para executar o contêiner PostgreSQL diretamente usando o Docker Desktop, o Podman, o nerdctl ou outro tempo de execução de contêiner instalado, execute o seguinte comando na janela do terminal:

        • Subsistema Mac, Linux ou Windows para Linux (WSL):

          [docker | podman | nerdctl] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v $(pwd)/data:/var/lib/postgresql/data -p 5432:5432 postgres

        • Windows com PowerShell:

          [docker | podman] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v ${PWD}/data:/var/lib/postgresql/data -p 5432:5432 postgres

    4. Quando o contêiner de banco de dados for iniciado, pressione o + ícone na barra de ferramentas Terminal de código do Visual Studio para criar uma segunda janela de terminal.

      Visual Studio Code + ícone na barra de ferramentas do terminal.

    5. cd na pasta server/typescript e execute os seguintes comandos para instalar as dependências e iniciar o servidor API.

      • npm install
      • npm start

    6. Pressione o + ícone novamente na barra de ferramentas Terminal de código do Visual Studio para criar uma terceira janela do terminal.

    7. cdna pasta cliente e execute os seguintes comandos para instalar as dependências e iniciar o servidor Web.

      • npm install
      • npm start

    8. Um navegador será iniciado e você será direcionado para http://localhost:4200.

      Captura de ecrã da aplicação com o Azure OpenAI ativado

Próximo Passo

Comunicação: Fazer uma chamada telefónica

  • Last updated on