JavaScript için Azure İletişim Email istemci kitaplığı - sürüm 1.0.0

Makale
04/06/2023

Bu paket, Email için Azure İletişim Hizmetleri için bir JavaScript/TypeScript SDK içerir.

Başlarken

Ön koşullar

Azure aboneliğine, İletişim Hizmeti Kaynağına ve etkin etki alanına sahip bir Email İletişim Kaynağına ihtiyacınız vardır.

Bu kaynağı oluşturmak için Azure Portalı, Azure PowerShell veya .NET yönetim istemci kitaplığını kullanabilirsiniz.

Yükleme

npm install @azure/communication-email

Örnekler

EmailClient e-posta iletileri gönderme işlevselliğini sağlar.

Kimlik Doğrulaması

Email istemcilerin kimliği, Azure Portaldaki bir Azure İletişim Kaynağından alınan bağlantı dizesi kullanılarak doğrulanabilir.

const { EmailClient } = require("@azure/communication-email");

const connectionString = `endpoint=https://<resource-name>.communication.azure.com/;accessKey=<Base64-Encoded-Key>`;
const client = new EmailClient(connectionString);

Azure Kimlik kitaplığını kullanarak Azure Active Directory ile kimlik doğrulaması da yapabilirsiniz. Aşağıda gösterilen DefaultAzureCredential sağlayıcısını veya Azure SDK ile sağlanan diğer kimlik bilgileri sağlayıcılarını kullanmak için lütfen paketi yükleyin @azure/identity :

npm install @azure/identity

Paket, @azure/identity uygulamanızın bunu yapmak için kullanabileceği çeşitli kimlik bilgileri türleri sağlar. için README @azure/identity , başlamanıza yönelik daha fazla ayrıntı ve örnek sağlar. defaultAzureCredential nesnesi oluşturmak için AZURE_CLIENT_SECRET, AZURE_CLIENT_ID ve AZURE_TENANT_ID ortam değişkenleri gerekir.

import { DefaultAzureCredential } from "@azure/identity";
import { EmailClient } from "@azure/communication-email";

const endpoint = "https://<resource-name>.communication.azure.com";
let credential = new DefaultAzureCredential();
const client = new EmailClient(endpoint, credential);

Email İletisi Gönderme

E-posta iletisi göndermek için işlevinden çağırın beginSendEmailClient. Bu bir poller döndürür. İşlemin durumunu denetlemek ve tamamlandıktan sonra sonucu almak için bu poller'ı kullanabilirsiniz.

const message = {
  senderAddress: "sender@contoso.com",
  content: {
    subject: "This is the subject",
    plainText: "This is the body",
  },
  recipients: {
    to: [
      {
        address: "customer@domain.com",
        displayName: "Customer Name",
      },
    ],
  },
};

const poller = await emailClient.beginSend(message);
const response = await poller.pollUntilDone();

Birden Çok Alıcıya Email İletiSi Gönderme

Birden çok alıcıya e-posta iletisi göndermek için, her alıcı türü için bir nesne ve her alıcı için bir nesne ekleyin.

const message = {
  senderAddress: "sender@contoso.com",
  content: {
    subject: "This is the subject",
    plainText: "This is the body",
  },
  recipients: {
    to: [
      {
        address: "customer1@domain.com",
        displayName: "Customer Name 1",
      },
      {
        address: "customer2@domain.com",
        displayName: "Customer Name 2",
      },
    ],
    cc: [
      {
        address: "ccCustomer1@domain.com",
        displayName: " CC Customer 1",
      },
      {
        address: "ccCustomer2@domain.com",
        displayName: "CC Customer 2",
      },
    ],
    bcc: [
      {
        address: "bccCustomer1@domain.com",
        displayName: " BCC Customer 1",
      },
      {
        address: "bccCustomer2@domain.com",
        displayName: "BCC Customer 2",
      },
    ],
  },
};

const poller = await emailClient.beginSend(message);
const response = await poller.pollUntilDone();

Eklerle Email Gönderme

Azure İletişim Hizmetleri ekleri olan e-posta gönderme desteği.

const filePath = "C://readme.txt";

const message = {
  senderAddress: "sender@contoso.com",
  content: {
    subject: "This is the subject",
    plainText: "This is the body",
  },
  recipients: {
    to: [
      {
        address: "customer@domain.com",
        displayName: "Customer Name",
      },
    ],
  },
  attachments: [
    {
      name: path.basename(filePath),
      contentType: "text/plain",
      contentInBase64: readFileSync(filePath, "base64"),
    },
  ],
};

const poller = await emailClient.beginSend(message);
const response = await poller.pollUntilDone();

Sonraki adımlar

Azure İletişim Hizmetleri'da Email hakkında daha fazla bilgi edinin

Katkıda bulunma

Bu proje, katkı ve önerilere açıktır. Çoğu durumda, sağladığınız katkıyı kullanmamız için bize hak tanıma hakkına sahip olduğunuzu ve bu hakkı bize tanıdığınızı bildiren bir Katkıda Bulunan Lisans Sözleşmesi’ni (CLA) kabul etmeniz gerekir. Ayrıntılar için cla.microsoft.com adresini ziyaret edin.

Bu proje Microsoft Open Source Code of Conduct (Microsoft Açık Kaynak Kullanım Kuralları) belgesinde listelenen kurallara uygundur. Daha fazla bilgi için Kullanım Kuralları SSS bölümüne bakın veya ek sorular veya yorumlarla iletişime geçin opencode@microsoft.com .

Aracılığıyla paylaş