Senden einer SMS-Nachricht

Steigen Sie in Azure Communication Services ein, indem Sie das Kommunikationsmodul in Azure CLI nutzen, um SMS-Nachrichten zu senden.

Um die Anleitungen in diesem Artikel zu befolgen, fallen in Ihrem Azure-Konto geringfügige Kosten von höchstens einigen wenigen Cent (USD) an.

Prerequisites

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie kostenlos ein Konto.
• Eine aktive Communication Services-Ressource und eine Verbindungszeichenfolge. Erstellen Sie eine Communication Services-Ressource.
• Eine SMS-fähige Telefonnummer, Kurzwahlnummer oder alphanumerische Absender-ID. Eine Telefonnummer erhalten.
• Die neueste Azure CLI-Version für Ihr Betriebssystem.

Prüfen der Voraussetzungen

• Führen Sie in einem Terminal- oder Befehlsfenster az --version aus, um sich zu vergewissern, dass Azure CLI installiert ist.

Einrichten

Installieren des Kommunikationsmoduls

Führen Sie zum Installieren des Kommunikationsmoduls den folgenden Befehl in einem Terminal- oder Befehlsfenster aus.

az extension add --name communication

Anmelden bei der Azure-Befehlszeilenschnittstelle

Sie müssen sich bei Azure CLI anmelden. Sie können sich beim Ausführen des az login-Befehls vom Terminal anmelden und Ihre Anmeldeinformationen bereitstellen.

Sicherstellen, dass Sie das richtige Abonnement verwenden

Wenn Sie über mehrere Abonnements in Ihrem Konto verfügen, stellen Sie sicher, dass Sie das richtige Abonnement für dieses Tutorial verwenden.

Führen Sie in einem Terminal- oder Befehlsfenster den folgenden Befehl aus, um das aktuelle Abonnement zu überprüfen.

az account show

Wenn Sie das Abonnement wechseln müssen, können Sie dazu den folgenden Befehl ausführen.

az account set --subscription "<yourSubscriptionId>"

Sie müssen <yourSubscriptionId> durch Ihre tatsächliche Abonnement-ID ersetzen, die Sie im Abschnitt „Abonnements“ im Azure-Portal finden.

(Optional) Verwenden von Azure CLI-SMS-Vorgängen ohne Übergeben einer Verbindungszeichenfolge

Sie können die Umgebungsvariable AZURE_COMMUNICATION_CONNECTION_STRING so konfigurieren, dass Azure CLI-SMS-Vorgänge verwendet werden, ohne dass Sie --connection_string zum Übergeben der Verbindungszeichenfolge verwenden müssen. Öffnen Sie zum Konfigurieren einer Umgebungsvariablen ein Konsolenfenster, und wählen Sie über die folgenden Registerkarten Ihr Betriebssystem aus. Ersetzen Sie <yourConnectionString> durch Ihre Verbindungszeichenfolge.

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

Operations

Senden einer SMS: 1:1

Wenn Sie eine SMS an eine*n einzelne*n Empfänger*in senden möchten, rufen Sie die send-Methode über das SMS-Modul mit der Telefonnummer eines einzelnen Empfängers auf.

az communication sms send --sender "<fromPhoneNumber>" --recipient "<toPhoneNumber>" --message "Hello world via SMS for Azure CLI!" --connection-string "<yourConnectionString>"

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <fromPhoneNumber> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist.
• Ersetzen Sie <toPhoneNumber> durch eine Telefonnummer, an die Sie eine Nachricht senden möchten.
• Ersetzen Sie <yourConnectionString> durch Ihre Verbindungszeichenfolge.

Senden einer SMS: 1:N

Wenn Sie eine SMS an mehrere Empfänger*innen senden möchten, rufen Sie die send-Methode über das SMS-Modul mit der Telefonnummer mehrerer Empfänger*innen auf.

az communication sms send --sender "<fromPhoneNumber>" --recipient "<toPhoneNumber1>" "<toPhoneNumber2>" "<toPhoneNumber3>" --message "Hello world via SMS for Azure CLI!" --connection-string "<yourConnectionString>"

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <fromPhoneNumber> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist.
• Ersetzen Sie <toPhoneNumberN> durch die n-te Telefonnummer, an die Sie eine Nachricht senden möchten.
• Ersetzen Sie <yourConnectionString> durch Ihre Verbindungszeichenfolge.

Senden einer SMS-Nachricht mit DeliveryReport und Tag

az communication sms send --sender "<fromPhoneNumber>" --recipient "<toPhoneNumber>" --message "Hello world via SMS for Azure CLI!" --connection-string "<yourConnectionString>" --deliveryReport --tag "<yourCustomTag>"

Der deliveryReport Parameter ist ein optionaler Parameter, den Sie zum Konfigurieren der Übermittlungsberichterstattung verwenden können. Verwenden Sie diese Funktion, wenn Sie Ereignisse ausgeben möchten, wenn SMS-Nachrichten übermittelt werden. Lesen Sie "Verarbeiten von SMS-Ereignissen ", um die Übermittlungsberichterstattung für Ihre SMS-Nachrichten zu konfigurieren.

Der tag-Parameter ist ein optionaler Parameter zum Anwenden eines Tags auf den Zustellbericht.

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <fromPhoneNumber> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist.
• Ersetzen Sie <toPhoneNumber> durch eine Telefonnummer, an die Sie eine Nachricht senden möchten.
• Ersetzen Sie <yourConnectionString> durch Ihre Verbindungszeichenfolge.
• Ersetzen Sie <yourCustomTag> durch Ihr benutzerdefiniertes Tag.

Steigen Sie in Azure Communication Services ein, indem Sie das C# SMS-SDK von Communication Services nutzen, um SMS-Nachrichten zu senden.

Um die Anleitungen in diesem Artikel zu befolgen, fallen in Ihrem Azure-Konto geringfügige Kosten von höchstens einigen wenigen Cent (USD) an.

Prerequisites

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie kostenlos ein Konto.
• Die neueste Version von .NET Core SDK für Ihr Betriebssystem.
• Eine aktive Communication Services-Ressource und eine Verbindungszeichenfolge. Erstellen Sie eine Communication Services-Ressource.
• Eine SMS-fähige Telefonnummer, Kurzwahlnummer oder alphanumerische Absender-ID. Eine Telefonnummer erhalten.

Prüfen der Voraussetzungen

• Führen Sie in einem Terminal- oder Befehlsfenster den Befehl dotnet aus, um sich zu vergewissern, dass das ,NET SDK installiert ist.
• Um die Telefonnummern anzuzeigen, die Ihrer Kommunikationsdienste-Ressource zugeordnet sind, melden Sie sich beim Azure-Portal an, und suchen Sie Ihre Kommunikationsdienste-Ressource. Wählen Sie im Navigationsbereich auf der linken Seite " Telefonnummern" aus.

Einrichten der Anwendungsumgebung

Um eine Umgebung zum Senden von Nachrichten einzurichten, müssen Sie die Schritte in den folgenden Abschnitten ausführen.

Erstellen einer neuen C#-Anwendung

1. Verwenden Sie in einem Konsolenfenster (z. B. cmd, PowerShell oder Bash) den Befehl dotnet new zum Erstellen einer neuen Konsolen-App mit dem Namen SmsQuickstart. Mit diesem Befehl wird ein einfaches C#-Projekt "Hello World" mit einer einzelnen Quelldatei Program.cs erstellt.

   dotnet new console -o SmsQuickstart
   

2. Wechseln Sie zum neu erstellten App-Ordner, und verwenden Sie den Befehl dotnet build, um Ihre Anwendung zu kompilieren.

   cd SmsQuickstart
   dotnet build
   

Installieren des Pakets

1. Installieren Sie im Anwendungsverzeichnis mithilfe des folgenden Befehls das SMS-SDK von Azure Communication Services für .NET.

   dotnet add package Azure.Communication.Sms --version 1.0.0
   

2. Fügen Sie eine using Direktive oben in Program.cs hinzu, um den Azure.Communication Namespace einzubinden.

   
   using System;
   using System.Collections.Generic;
   
   using Azure;
   using Azure.Communication;
   using Azure.Communication.Sms;
   
   

Objektmodell

Die folgenden Klassen und Schnittstellen dienen zur Behandlung einiger der wichtigsten Features des SMS SDK für C# von Azure Communication Services.

Authentifizieren des Clients

Öffnen Sie Program.cs in einem Texteditor und ersetzen Sie den Rumpf der Main-Methode durch Code, um ein SmsClient mit Ihrer Verbindungszeichenfolge zu initialisieren. Im folgenden Code wird die Verbindungszeichenfolge für die Ressource aus einer Umgebungsvariablen namens COMMUNICATION_SERVICES_CONNECTION_STRING abgerufen. Erfahren Sie, wie Sie die Verbindungszeichenfolge Ihrer Ressource verwalten.

// This code retrieves your connection string
// from an environment variable.
string connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");

SmsClient smsClient = new SmsClient(connectionString);

Senden einer SMS: 1:1

Um eine SMS-Nachricht an einen einzelnen Empfänger zu senden, rufen Sie die Funktion Send oder SendAsync über SmsClient auf. Fügen Sie diesen Code am Ende der Main Methode in Program.cs hinzu:

SmsSendResult sendResult = smsClient.Send(
    from: "<from-phone-number>",
    to: "<to-phone-number>",
    message: "Hello World via SMS"
);

Console.WriteLine($"Sms id: {sendResult.MessageId}");

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <from-phone-number> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist.
• Ersetzen Sie <to-phone-number> durch die Telefonnummer, an die Sie eine Nachricht senden möchten.

Senden einer SMS mit Optionen: 1:N

Wenn Sie eine SMS an mehrere Empfänger*innen senden möchten, rufen Sie die Funktion Send oder SendAsync über SmsClient mit einer Liste von Empfängertelefonnummern auf. Sie können auch optionale Parameter übergeben, um anzugeben, ob der Zustellbericht aktiviert werden soll, und um benutzerdefinierte Tags festzulegen.

Response<IReadOnlyList<SmsSendResult>> response = smsClient.Send(
    from: "<from-phone-number>",
    to: new string[] { "<to-phone-number-1>", "<to-phone-number-2>" },
    message: "Weekly Promotion!",
    options: new SmsSendOptions(enableDeliveryReport: true) // OPTIONAL
    {
        Tag = "marketing", // custom tags
    });

IEnumerable<SmsSendResult> results = response.Value;
foreach (SmsSendResult result in results)
{
    Console.WriteLine($"Sms id: {result.MessageId}");
    Console.WriteLine($"Send Result Successful: {result.Successful}");
}

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <from-phone-number> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist.
• Ersetzen <to-phone-number-1> und <to-phone-number-2> durch Telefonnummern, an die Sie eine Nachricht senden möchten.

Der enableDeliveryReport-Parameter ist ein optionaler Parameter zum Konfigurieren von Zustellberichten. Er ist in Szenarios hilfreich, in denen Ereignisse bei Zustellung von SMS-Nachrichten ausgegeben werden sollen. Lesen Sie die Schnellstartanleitung zum Behandeln von SMS-Ereignissen , um die Übermittlungsberichterstattung für Ihre SMS-Nachrichten zu konfigurieren.

Mithilfe des Tag-Parameters können Sie ein Tag auf den Zustellbericht anwenden.

Sms global mit Messaging Connect senden

Wenn Sie eine über Messaging Connect bereitgestellte Telefonnummer verwenden, können Sie SMS-Nachrichten über das standardmäßige Azure Communication Services SDK senden. Der einzige Unterschied besteht darin, dass Sie das MessagingConnect Objekt einschließen müssen, um den Partnernamen und den API-Schlüssel anzugeben.

Response<IReadOnlyList<SmsSendResult>> response = smsClient.Send(
    from: "<from-messaging-connect-number>",
    to: new string[] { "<to-phone-number-1>", "<to-phone-number-2>" },
    message: "Weekly Promotion!",
    options: new SmsSendOptions(enableDeliveryReport: true) // OPTIONAL
    {
        Tag = "marketing", // custom tags
        MessagingConnect = new MessagingConnectOptions("<partner-api-key>", "infobip")
    });

IEnumerable<SmsSendResult> results = response.Value;
foreach (SmsSendResult result in results)
{
    Console.WriteLine($"Sms id: {result.MessageId}");
    Console.WriteLine($"Send Result Successful: {result.Successful}");
}

Ersetzen Sie die folgenden Werte:

• <from-messaging-connect-number>: Die telefonnummer, die über Messaging Connect erworben wurde und mit Ihrer ACS-Ressource verknüpft ist.
• <to-phone-number-1> und <to-phone-number-2>: Die Telefonnummern des Empfängers.
• <partner-api-key>: Der API-Schlüssel von Ihrem Messaging Connect-Partner (z. B. Infobip).

Der enableDeliveryReport-Parameter ist ein optionaler Parameter zum Konfigurieren von Zustellberichten. Er ist in Szenarios hilfreich, in denen Ereignisse bei Zustellung von SMS-Nachrichten ausgegeben werden sollen. Lesen Sie die Schnellstartanleitung zum Behandeln von SMS-Ereignissen , um die Übermittlungsberichterstattung für Ihre SMS-Nachrichten zu konfigurieren. Mithilfe des Tag-Parameters können Sie ein Tag auf den Zustellbericht anwenden.

Ausführen des Codes

Führen Sie die Anwendung mit dem Befehl dotnet run aus dem Anwendungsverzeichnis aus.

dotnet run

Beispielcode

Laden Sie die Beispiel-App von Azure Samples GitHub Mit .NET eine SMS-Nachricht senden.

Erste Schritte mit Azure Communication Services mithilfe des JavaScript SMS SDK für Kommunikationsdienste zum Senden von SMS-Nachrichten.

Um die Anleitungen in diesem Artikel zu befolgen, fallen in Ihrem Azure-Konto geringfügige Kosten von höchstens einigen wenigen Cent (USD) an.

Prerequisites

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie kostenlos ein Konto.
• Node.js Aktive LTS- und Wartungs-LTS-Versionen (8.11.1 und 10.14.1 werden empfohlen).
• Eine aktive Communication Services-Ressource und eine Verbindungszeichenfolge. Erstellen Sie eine Communication Services-Ressource.
• Eine SMS-fähige Telefonnummer, Kurzwahlnummer oder alphanumerische Absender-ID. Eine Telefonnummer erhalten.

Prüfen der Voraussetzungen

• Führen Sie in einem Terminal- oder Befehlsfenster node --version aus, um sich zu vergewissern, dass Node.js installiert ist.
• Um die Telefonnummern anzuzeigen, die Ihrer Kommunikationsdienste-Ressource zugeordnet sind, melden Sie sich beim Azure-Portal an, und suchen Sie Ihre Kommunikationsdienste-Ressource. Wählen Sie im Navigationsbereich auf der linken Seite " Telefonnummern" aus.

Einrichten der Anwendungsumgebung

Um eine Umgebung zum Senden von Nachrichten einzurichten, müssen Sie die Schritte in den folgenden Abschnitten ausführen.

Erstellen einer neuen Node.js-Anwendung

1. Öffnen Sie Ihr Terminal oder Befehlsfenster, und führen Sie dann den folgenden Befehl aus, um ein neues Verzeichnis für Ihre App zu erstellen und zur App zu navigieren.

   mkdir sms-quickstart && cd sms-quickstart
   

2. Führen Sie den folgenden Befehl aus, um eine package.json Datei mit Standardeinstellungen zu erstellen.

   npm init -y
   

3. Verwenden Sie einen Text-Editor, um eine Datei namens send-sms.js im Projektstammverzeichnis zu erstellen.

Fügen Sie in den folgenden Abschnitten den gesamten Quellcode für diese Schnellstartanleitung zur send-sms.js Datei hinzu, die Sie erstellt haben.

Installieren des Pakets

Verwenden Sie den Befehl npm install, um das Azure Communication Services SMS SDK für JavaScript zu installieren.

npm install @azure/communication-sms --save

Durch die Option --save wird die Bibliothek als Abhängigkeit in der Datei package.json aufgeführt.

Objektmodell

Die folgenden Klassen und Schnittstellen dienen zur Behandlung einiger der wichtigsten Features des SMS SDK für Node.js von Azure Communication Services.

Authentifizieren des Clients

Um einen Client zu authentifizieren, importieren Sie den SmsClient aus dem SDK und instanziieren ihn mit Ihrer Verbindungszeichenfolge. Sie können die Verbindungszeichenfolge der Ressource aus einer Umgebungsvariablen abrufen. Der Code in diesem Abschnitt ruft beispielsweise die Verbindungszeichenfolge aus der Umgebungsvariable COMMUNICATION_SERVICES_CONNECTION_STRING ab. Erfahren Sie, wie Sie die Verbindungszeichenfolge Ihrer Ressource verwalten.

So importieren Sie den Client und instanziieren ihn

1. Erstellen Sie eine Datei mit dem Namen send-sms.js.

2. Fügen Sie den folgenden Code zum send-sms.jshinzu.

const { SmsClient } = require('@azure/communication-sms');

// This code retrieves your connection string
// from an environment variable.
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the SMS client.
const smsClient = new SmsClient(connectionString);

Senden einer SMS: 1:N

Wenn Sie eine SMS an mehrere Empfänger*innen senden möchten, rufen Sie die Funktion send über SmsClient mit einer Liste von Empfängertelefonnummern auf. Wenn Sie eine Nachricht an eine*n Empfänger*in senden möchten, geben Sie nur eine Nummer an. Fügen Sie diesen Code am Ende der send-sms.jshinzu:

async function main() {
  const sendResults = await smsClient.send({
    from: "<from-phone-number>",
    to: ["<to-phone-number-1>", "<to-phone-number-2>"],
    message: "Hello World 👋🏻 via SMS"
  });

  // Individual messages can encounter errors during sending.
  // Use the "successful" property to verify the status.
  for (const sendResult of sendResults) {
    if (sendResult.successful) {
      console.log("Success: ", sendResult);
    } else {
      console.error("Something went wrong when trying to send this message: ", sendResult);
    }
  }
}

main();

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <from-phone-number> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist.
• Ersetzen Sie <to-phone-number-1> und <to-phone-number-2> durch die Telefonnummern, an die Sie eine Nachricht senden möchten.

Senden einer SMS mit Optionen: 1:N

Sie können auch ein options-Objekt übergeben, um anzugeben, ob der Zustellbericht aktiviert werden soll, und um benutzerdefinierte Tags festzulegen.

async function main() {
  const sendResults = await smsClient.send({
    from: "<from-phone-number>",
    to: ["<to-phone-number-1>", "<to-phone-number-2>"],
    message: "Weekly Promotion!"
  }, {
    // Optional parameters
    enableDeliveryReport: true,
    tag: "marketing"
  });

  // Individual messages can encounter errors during sending.
  // Use the "successful" property to verify the status.
  for (const sendResult of sendResults) {
    if (sendResult.successful) {
      console.log("Success: ", sendResult);
    } else {
      console.error("Something went wrong when trying to send this message: ", sendResult);
    }
  }
}

main();

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <from-phone-number> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist.
• Ersetzen <to-phone-number-1> und <to-phone-number-2> durch Telefonnummern, an die Sie eine Nachricht senden möchten.

Der enableDeliveryReport-Parameter ist ein optionaler Parameter zum Konfigurieren von Zustellberichten. Er ist in Szenarios hilfreich, in denen Ereignisse bei Zustellung von SMS-Nachrichten ausgegeben werden sollen. Lesen Sie die Schnellstartanleitung zum Behandeln von SMS-Ereignissen , um die Übermittlungsberichterstattung für Ihre SMS-Nachrichten zu konfigurieren. Das tag ist optional. Mit diesem Parameter können Sie ein Tag auf den Zustellbericht anwenden.

Sms global mit Messaging Connect senden

Wenn Sie eine über Messaging Connect bereitgestellte Telefonnummer verwenden, können Sie SMS-Nachrichten über das Standardmäßige JavaScript SDK für Azure Communication Services senden. Der einzige Unterschied besteht darin, dass Sie das messagingConnect Objekt einschließen müssen, um den Partnernamen und den API-Schlüssel anzugeben.

async function main() {
  const sendResults = await smsClient.send({
    from: "<from-messaging-connect-number>",
    to: ["<to-phone-number-1>", "<to-phone-number-2>"],
    message: "Weekly Promotion!"
  }, {
    // Optional parameters
    enableDeliveryReport: true,
    tag: "marketing", // custom tag
    messagingConnect: {
      apiKey: "<partner-api-key>",
      partner: "infobip"
    }
  });

  for (const sendResult of sendResults) {
    if (sendResult.successful) {
      console.log("Success:", sendResult);
    } else {
      console.error("Failed to send message:", sendResult);
    }
  }
}

main();

Ersetzen Sie die folgenden Werte:

• <from-messaging-connect-number>: Die telefonnummer, die über Messaging Connect erworben wurde und mit Ihrer ACS-Ressource verknüpft ist.
• <to-phone-number-1> und <to-phone-number-2>: Die Telefonnummern des Empfängers.
• <partner-api-key>: Der API-Schlüssel von Ihrem Messaging Connect-Partner (z. B. Infobip).

Mit dem enableDeliveryReport Parameter können Sie die Übermittlungsberichterstattung konfigurieren. Der tag Parameter ist optional und ermöglicht es Ihnen, eine benutzerdefinierte Markierung auf den Übermittlungsbericht anzuwenden. Informationen zum Konfigurieren der SMS-Übermittlungsberichterstattung finden Sie in der Schnellstartanleitung zum Behandeln von SMS-Ereignissen .

Ausführen des Codes

Verwenden Sie den node-Befehl, um den Code auszuführen, den Sie der Datei send-sms.js hinzugefügt haben.

node ./send-sms.js

Steigen Sie ein in Azure Communication Services, indem Sie das Python-SDK für SMS von Communication Services nutzen, um SMS-Nachrichten zu senden.

Im Rahmen dieser Schnellstartanleitung fallen in Ihrem Azure-Konto ggf. geringfügige Kosten im Centbereich an.

Prerequisites

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie kostenlos ein Konto.
• Python 3.7+.
• Eine aktive Communication Services-Ressource und eine Verbindungszeichenfolge. Erstellen Sie eine Communication Services-Ressource.
• Eine SMS-fähige Telefonnummer, Kurzwahlnummer oder alphanumerische Absender-ID. Eine Telefonnummer erhalten.

Prüfen der Voraussetzungen

• Führen Sie in einem Terminal- oder Befehlsfenster den Befehl python --version aus, um sich zu vergewissern, dass Python installiert ist.
• Um die Telefonnummern anzuzeigen, die Ihrer Kommunikationsdienste-Ressource zugeordnet sind, melden Sie sich beim Azure-Portal an, und suchen Sie Ihre Kommunikationsdienste-Ressource. Wählen Sie im Navigationsbereich auf der linken Seite " Telefonnummern" aus.

Einrichten der Anwendungsumgebung

Führen Sie die folgenden Abschnitte aus, um eine Umgebung zum Senden von Nachrichten einzurichten.

Erstellen einer neuen Python-Anwendung

1. Öffnen Sie Ihr Terminal oder Befehlsfenster. Verwenden Sie den folgenden Befehl, um ein neues Verzeichnis für Ihre App zu erstellen und zu ihr zu navigieren.

   mkdir sms-quickstart && cd sms-quickstart
   

2. Verwenden Sie einen Text-Editor, um eine Datei namens send-sms.py im Projektstammverzeichnis zu erstellen und die Struktur für das Programm hinzuzufügen, einschließlich grundlegender Ausnahmebehandlung.

   import os
   from azure.communication.sms import SmsClient
   
   try:
       # Quickstart code goes here.
   except Exception as ex:
       print('Exception:')
       print(ex)
   

Fügen Sie in den folgenden Abschnitten den gesamten Quellcode für diese Schnellstartanleitung zur send-sms.py Datei hinzu, die Sie erstellt haben.

Installieren des Pakets

Installieren Sie im Anwendungsverzeichnis mithilfe des folgenden Befehls das SMS-SDK von Azure Communication Services für Python.

pip install azure-communication-sms

Objektmodell

Die folgenden Klassen und Schnittstellen dienen zur Behandlung einiger der wichtigsten Features des SMS SDK für Python von Azure Communication Services.

Authentifizieren des Clients

Instanziieren Sie einen SmsClient mit Ihrer Verbindungszeichenfolge. Erfahren Sie, wie Sie die Verbindungszeichenfolge Ihrer Ressource verwalten.

# Create the SmsClient object that you use to send SMS messages.
sms_client = SmsClient.from_connection_string(<connection_string>)

Der Einfachheit halber verwendet dieser Schnellstartanleitung Verbindungszeichenfolgen. In Produktionsumgebungen empfehlen wir jedoch die Verwendung von Dienstprinzipalen.

Senden einer SMS: 1:1

Um eine SMS-Nachricht an einen einzelnen Empfänger zu senden, rufen Sie die send Methode vom SmsClient mit einer einzelnen Empfängertelefonnummer auf. Sie können auch optionale Parameter übergeben, um anzugeben, ob der Zustellbericht aktiviert werden soll, und um benutzerdefinierte Tags festzulegen. Fügen Sie diesen Code am Ende des try Blocks in send-sms.py hinzu:

# Call send() with SMS values.
sms_responses = sms_client.send(
    from_="<from-phone-number>",
    to="<to-phone-number>",
    message="Hello World via SMS",
    enable_delivery_report=True, # optional property
    tag="custom-tag") # optional property

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <from-phone-number> eine SMS-fähige Telefonnummer, die Ihrem Kommunikationsdienst zugeordnet ist.
• Ersetzen Sie <to-phone-number> durch die Telefonnummer, an die Sie eine Nachricht senden möchten.

Senden einer SMS: 1:N

Um eine SMS-Nachricht an eine Liste von Empfängern zu senden, rufen Sie die send Methode vom SmsClient mit einer Liste der Empfängertelefonnummern auf. Sie können auch optionale Parameter übergeben, um anzugeben, ob der Zustellbericht aktiviert werden soll, und um benutzerdefinierte Tags festzulegen. Fügen Sie diesen Code am Ende des try Blocks in send-sms.py hinzu:

# Call send() with SMS values.
sms_responses = sms_client.send(
    from_="<from-phone-number>",
    to=["<to-phone-number-1>", "<to-phone-number-2>"],
    message="Hello World via SMS",
    enable_delivery_report=True, # optional property
    tag="custom-tag") # optional property

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <from-phone-number> eine SMS-fähige Telefonnummer, die Ihrem Kommunikationsdienst zugeordnet ist.
• Ersetzen <to-phone-number-1> und <to-phone-number-2> durch Telefonnummern, an die Sie eine Nachricht senden möchten.

Optionale Parameter

Der enable_delivery_report Parameter ist ein optionaler Parameter, den Sie zum Konfigurieren der Übermittlungsberichterstattung verwenden können. Verwenden Sie diese Funktion, wenn Sie Ereignisse ausgeben möchten, wenn SMS-Nachrichten übermittelt werden. Lesen Sie "Verarbeiten von SMS-Ereignissen ", um die Übermittlungsberichterstattung für Ihre SMS-Nachrichten zu konfigurieren.

Der tag-Parameter ist ein optionaler Parameter zum Anwenden eines Tags auf den Zustellbericht.

Ausführen des Codes

Führen Sie die Anwendung mit dem Befehl python aus dem Anwendungsverzeichnis aus.

python send-sms.py

Das komplette Python-Skript sollte in etwa wie der folgende Code aussehen:

import os
from azure.communication.sms import SmsClient

try:
    # Create the SmsClient object that you use to send SMS messages.
    sms_client = SmsClient.from_connection_string("<connection string>")
    # Call send() with SMS values.
    sms_responses = sms_client.send(
       from_="<from-phone-number>",
       to="<to-phone-number>",
       message="Hello World via SMS",
       enable_delivery_report=True, # optional property
       tag="custom-tag") # optional property

except Exception as ex:
    print('Exception:')
    print(ex)

Steigen Sie in Azure Communication Services ein, indem Sie das Java SMS-SDK von Communication Services nutzen, um SMS-Nachrichten zu senden.

Um die Anleitungen in diesem Artikel zu befolgen, fallen in Ihrem Azure-Konto geringfügige Kosten von höchstens einigen wenigen Cent (USD) an.

Prerequisites

• Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie kostenlos ein Konto.
• Java Development Kit (JDK) Version 8 oder höher.
• Apache Maven.
• Eine aktive Communication Services-Ressource und eine Verbindungszeichenfolge. Erstellen Sie eine Communication Services-Ressource.
• Eine SMS-fähige Telefonnummer, Kurzwahlnummer oder alphanumerische Absender-ID. Eine Telefonnummer erhalten.

Prüfen der Voraussetzungen

• Führen Sie in einem Terminal- oder Befehlsfenster mvn -v aus, um sich zu vergewissern, dass Maven installiert ist.
• Um die Telefonnummern anzuzeigen, die Ihrer Kommunikationsdienste-Ressource zugeordnet sind, melden Sie sich beim Azure-Portal an, und suchen Sie Ihre Kommunikationsdienste-Ressource. Wählen Sie im Navigationsbereich auf der linken Seite " Telefonnummern" aus.

Einrichten der Anwendungsumgebung

Führen Sie die folgenden Abschnitte aus, um eine Umgebung zum Senden von Nachrichten einzurichten.

Erstellen einer neuen Java-Anwendung

Öffnen Sie ein Terminal- oder Befehlsfenster, und navigieren Sie zu dem Verzeichnis, in dem Sie Ihre Java-Anwendung erstellen möchten. Führen Sie den folgenden Befehl aus, um das Java-Projekt aus der Vorlage maven-archetype-quickstart zu generieren.

• Eingabeaufforderung

mvn archetype:generate -DgroupId=com.communication.quickstart -DartifactId=communication-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

• PowerShell

mvn archetype:generate "-DgroupId=com.communication.quickstart" "-DartifactId=communication-quickstart" "-DarchetypeArtifactId=maven-archetype-quickstart" "-DarchetypeVersion=1.4" "-DinteractiveMode=false"

Das generate-Ziel erstellt ein Verzeichnis, das den gleichen Namen wie der artifactId-Wert besitzt. In diesem Verzeichnis enthält das Verzeichnis src/main/java den Quellcode des Projekts. Das Verzeichnis src/test/java enthält die Testquelle, und die Datei pom.xml ist das Projektobjektmodell (POM) des Projekts.

Installieren des Pakets

Öffnen Sie die Datei pom.xml in Ihrem Text-Editor. Fügen Sie der Gruppe „dependencies“ das folgende Abhängigkeitselement hinzu.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-sms</artifactId>
    <version>1.0.1</version>
</dependency>

Einrichten des App-Frameworks

Öffnen Sie /src/main/java/com/communication/quickstart/App.java in einem Text-Editor, fügen Sie Importanweisungen hinzu, und entfernen Sie die System.out.println("Hello world!");-Anweisung:

package com.communication.quickstart;

import com.azure.communication.sms.models.*;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.communication.sms.*;
import com.azure.core.util.Context;
import java.util.Arrays;

public class App
{
    public static void main( String[] args )
    {
        // Quickstart code goes here.
    }
}

Objektmodell

Die folgenden Klassen und Schnittstellen dienen zur Behandlung einiger der wichtigsten Features des SMS SDK für Java von Azure Communication Services.

Authentifizieren des Clients

Um einen Client zu authentifizieren, instanziieren Sie SmsClient mit Ihrer Verbindungszeichenfolge. Verwenden Sie für die Anmeldeinformationen den Key-Wert aus dem Azure-Portal. Erfahren Sie, wie Sie die Verbindungszeichenfolge Ihrer Ressource verwalten. Sie können den Client auch mit einem beliebigen benutzerdefinierten HTTP-Client initialisieren, der die com.azure.core.http.HttpClient-Schnittstelle implementiert.

Um einen Client zu instanziieren, fügen Sie der main-Methode den folgenden Code hinzu:

// You can get your endpoint and access key from your resource in the Azure portal.
String endpoint = "https://<resource-name>.communication.azure.com/";
AzureKeyCredential azureKeyCredential = new AzureKeyCredential("<access-key-credential>");

SmsClient smsClient = new SmsClientBuilder()
                .endpoint(endpoint)
                .credential(azureKeyCredential)
                .buildClient();

Anstelle des Endpunkts und Zugriffsschlüssels können Sie mithilfe der connectionString-Funktion auch die gesamte Verbindungszeichenfolge bereitstellen.

// You can get your connection string from your resource in the Azure portal.
String connectionString = "endpoint=https://<resource-name>.communication.azure.com/;accesskey=<access-key>";

SmsClient smsClient = new SmsClientBuilder()
            .connectionString(connectionString)
            .buildClient();

Senden einer SMS: 1:1

Wenn Sie eine SMS an einen einzelnen Empfänger senden möchten, rufen Sie über SmsClient die Methode send mit der Telefonnummer eines einzelnen Empfängers auf. Sie können auch optionale Parameter übergeben, um anzugeben, ob der Zustellbericht aktiviert werden soll, und um benutzerdefinierte Tags festzulegen.

SmsSendResult sendResult = smsClient.send(
                "<from-phone-number>",
                "<to-phone-number>",
                "Weekly Promotion");

System.out.println("Message Id: " + sendResult.getMessageId());
System.out.println("Recipient Number: " + sendResult.getTo());
System.out.println("Send Result Successful:" + sendResult.isSuccessful());

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen Sie diese durch <from-phone-number> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist.
• Ersetzen Sie <to-phone-number> durch eine Telefonnummer, an die Sie eine Nachricht senden möchten.

Senden einer SMS mit Optionen: 1:N

Wenn Sie eine SMS an eine Empfängerliste senden möchten, rufen Sie die Methode send mit einer Liste mit den Telefonnummern der Empfänger auf. Sie können auch optionale Parameter übergeben, um anzugeben, ob der Zustellbericht aktiviert werden soll, und um benutzerdefinierte Tags festzulegen.

SmsSendOptions options = new SmsSendOptions();
options.setDeliveryReportEnabled(true);
options.setTag("Marketing");

Iterable<SmsSendResult> sendResults = smsClient.sendWithResponse(
    "<from-phone-number>",
    Arrays.asList("<to-phone-number1>", "<to-phone-number2>"),
    "Weekly Promotion",
    options /* Optional */,
    Context.NONE).getValue();

for (SmsSendResult result : sendResults) {
    System.out.println("Message Id: " + result.getMessageId());
    System.out.println("Recipient Number: " + result.getTo());
    System.out.println("Send Result Successful:" + result.isSuccessful());
}

Führen Sie im Code die folgenden Ersetzungen durch:

• Ersetzen durch <from-phone-number> eine SMS-aktivierte Telefonnummer, die Ihrer Kommunikationsdienste-Ressource zugeordnet ist
• Ersetzen <to-phone-number-1> und <to-phone-number-2> durch Telefonnummern, an die Sie eine Nachricht senden möchten.

Mithilfe der setDeliveryReportEnabled-Methode können Sie Zustellberichte konfigurieren. Er ist in Szenarios hilfreich, in denen Ereignisse bei Zustellung von SMS-Nachrichten ausgegeben werden sollen. Lesen Sie die Schnellstartanleitung zum Behandeln von SMS-Ereignissen , um die Übermittlungsberichterstattung für Ihre SMS-Nachrichten zu konfigurieren.

Verwenden Sie die Methode setTag, um eine Kennzeichnung auf den Übermittlungsbericht anzuwenden.

Ausführen des Codes

1. Navigieren Sie zu dem Verzeichnis, das die pom.xml Datei enthält, und kompilieren Sie das Projekt mithilfe des mvn Befehls.

   
   mvn compile
   
   

2. Erstellen Sie das Paket.

   
   mvn package
   
   

3. Führen Sie die App mit dem folgenden mvn-Befehl aus.

   • Eingabeaufforderung

   
   mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false
   
   

   • PowerShell

   mvn exec:java "-Dexec.mainClass=com.communication.quickstart.App" "-Dexec.cleanupDaemonThreads=false"
   

Verwenden Sie den Azure Communication Services SMS-Connector und Azure Logic Apps , um automatisierte Workflows zu erstellen, die SMS-Nachrichten senden können.

In diesem Artikel wird beschrieben, wie Textnachrichten automatisch als Reaktion auf ein Triggerereignis gesendet werden, was der erste Schritt in einem Logik-App-Workflow ist. Ein Triggerereignis kann eine eingehende E-Mail-Nachricht, ein Serienzeitplan, ein Azure Event Grid-Ressourcenereignis oder ein anderer Trigger sein, der von Azure Logic Apps unterstützt wird.

Obwohl sich dieser Artikel darauf konzentriert, den Connector zur Reaktion auf einen Trigger zu verwenden, können Sie den Connector auch nutzen, um auf nachfolgende Aktionen zu reagieren, die Schritte sind, die im Verlauf eines Workflows auf den Trigger folgen. Wenn Sie mit Logic Apps noch nicht vertraut sind, lesen Sie , was Azure Logic Apps ist , bevor Sie beginnen.

Prerequisites

• Ein Azure-Konto mit einem aktiven Abonnement, oder erstellen Sie kostenlos ein Azure-Konto.

• Eine aktive Azure Communication Services-Ressource, oder erstellen Sie eine Communication Services-Ressource.

• Eine aktive Logik-Apps-Ressource (Logik-App) oder erstellen Sie eine leere Logik-App, jedoch mit dem Trigger, den Sie verwenden möchten. Derzeit bietet der SMS-Connector von Azure Communication Services nur Aktionen, sodass Ihre Logik-App mindestens einen Trigger erfordert.

  In dieser Schnellstartanleitung wird der Trigger "Wenn eine neue E-Mail eintrifft " verwendet, die mit dem Office 365 Outlook-Connector verfügbar ist.

• Eine SMS-fähige Telefonnummer, Kurzwahlnummer oder alphanumerische Absender-ID. Eine Telefonnummer erhalten.

Hinzufügen einer SMS-Aktion

Um die Sms-Aktion als neuen Schritt in Ihrem Workflow mithilfe des Azure Communication Services SMS-Connectors hinzuzufügen, führen Sie die folgenden Schritte im Azure-Portal aus, wobei Ihr Logik-App-Workflow im Logic App Designer geöffnet ist:

1. Wählen Sie im Designer unter dem Schritt, in dem Sie die neue Aktion hinzufügen möchten, " Neuer Schritt" aus. Wenn Sie die neue Aktion zwischen den Schritten hinzufügen möchten, bewegen Sie den Mauszeiger über den Pfeil zwischen diesen Schritten, wählen Sie das Pluszeichen (+) und dann "Aktion hinzufügen" aus.

2. Geben Sie im Suchfeld "Vorgang auswählen " die Zeichenfolge Azure Communication Servicesein. Wählen Sie in der Aktionsliste " SMS senden" aus.

   

3. Erstellen Sie jetzt eine Verbindung mit Ihrer Communication Services-Ressource.

   1. Wenn Sie die Verbindung innerhalb desselben Abonnements vornehmen möchten:

      1. Geben Sie einen Namen für die Verbindung an.

      2. Wählen Sie Ihre Azure Communication Services-Ressource aus.

      3. Wählen Sie "Erstellen" aus.

      

   2. Wenn Sie die Verbindung unter Verwendung der Verbindungszeichenfolge aus Ihrer Communication Services-Ressource vornehmen möchten:

      1. Geben Sie einen Namen für die Verbindung an.

      2. Wählen Sie in den Dropdownoptionen „ConnectionString-Authentifizierung“ aus.

      3. Geben Sie die Verbindungszeichenfolge aus Ihrer Communication Services-Ressource ein.

      4. Wählen Sie "Erstellen" aus.

      

   3. Verwenden des Dienstprinzipals (siehe Erstellen eines Dienstprinzipals):

      1. Geben Sie einen Namen für die Verbindung an.

      2. Wählen Sie die Dienstprinzipalauthentifizierung (Microsoft Entra-Anwendung) aus den Dropdownoptionen aus.

      3. Geben Sie die Mandanten-ID, die Client-ID und das Clientgeheimnis Ihres Dienstprinzipals ein.

      4. Geben Sie den Wert der Communication Services Endpunkt-URL Ihrer Communication Services-Ressource ein.

      5. Wählen Sie "Erstellen" aus.

      

4. Geben Sie in der Aktion "SMS senden " die folgenden Informationen an:

   • Die Telefonnummern von Quelle und Ziel. Zu Testzwecken können Sie Ihre eigene Telefonnummer als Zielrufnummer verwenden.

   • Der Inhalt der Nachricht, die Sie senden möchten, z. B. „Hallo aus Logic Apps!“.

   Hier ist eine Aktion SMS senden mit Beispielinformationen:

   

5. Wenn Sie fertig sind, wählen Sie auf der Symbolleiste des Designers die Option Speichern aus.

Führen Sie als Nächstes Ihren Workflow für den Testvorgang aus.

Testen Ihres Workflows

Wählen Sie auf der Symbolleiste des Designers die Option Ausführen aus, um Ihren Workflow manuell zu starten. Sie können auch warten, bis der Trigger ausgelöst wird. In beiden Fällen sollte der Workflow eine SMS-Nachricht an Ihre angegebene Zieltelefonnummer senden. Weitere Informationen hierzu erfahren Sie, wie Sie Ihren Workflow ausführen.

Bereinigen von Workflow-Ressourcen

Um Ihren Logik-App-Workflow und die zugehörigen Ressourcen zu bereinigen, sehen Sie sich an, wie Sie Logik-Apps-Ressourcen bereinigen können.