Freigeben über


Schnellstart: Senden einer SMS-Nachricht

Wichtig

Die SMS-Funktionen hängen von Ihrer Telefonnummer und dem durch Ihre Azure-Rechnungsadresse festgelegten Land bzw. der Region ab. Weitere Informationen finden Sie unter Abonnementberechtigung.

Hinweis

Teilen Sie Ihre Gedanken und Ihr Feedback zu Azure Communication Services mit uns, indem Sie diese kurze Umfrage machen.


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

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

Voraussetzungen

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 den folgenden Befehl in einem Terminal- oder Befehlsfenster aus, um das Kommunikationsmodul zu installieren.

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 "<yourSubcriptionId>"

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.

Öffnen Sie ein Konsolenfenster, und geben Sie den folgenden Befehl ein:

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Nachdem Sie die Umgebungsvariable hinzugefügt haben, müssen Sie unter Umständen alle ausgeführten Programme neu starten, von denen die Umgebungsvariable gelesen werden muss, z.B. das Konsolenfenster. Wenn Sie beispielsweise Visual Studio als Editor verwenden, müssen Sie Visual Studio neu starten, bevor Sie das Beispiel ausführen.

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 <fromPhoneNumber> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Ressource zugeordnet ist.
  • Ersetzen Sie <toPhoneNumber> durch eine Telefonnummer, an die Sie eine Nachricht senden möchten.
  • Ersetzen Sie <yourConnectionString> durch Ihre Verbindungszeichenfolge.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <fromPhoneNumber> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

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 <fromPhoneNumber> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-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.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <fromPhoneNumber> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

Steigen Sie in Azure Communication Services ein, indem Sie das C# SMS-SDK 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.

Hinweis

Den fertigen Code für diese Schnellstartanleitung finden Sie auf GitHub.

Voraussetzungen

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 mit Ihrer Communication Services-Ressource verknüpften Telefonnummern anzuzeigen, melden Sie sich beim Azure-Portal an, und suchen Sie nach Ihrer Communication Services-Ressource. Klicken Sie im Navigationsbereich links auf Phone numbers (Telefonnummern).

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. Dieser Befehl erstellt ein einfaches C#-Projekt vom Typ „Hallo Welt“ mit einer einzelnen Quelldatei, program.cs.

    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 am Anfang von Program.cs eine Anweisung vom Typ using hinzu, um den Namespace Azure.Communication einzuschließen.

    
    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.

name Beschreibung
SmsClient Diese Klasse ist für alle SMS-Funktionen erforderlich. Sie instanziieren sie mit Ihren Abonnementinformationen und verwenden sie zum Senden von SMS-Nachrichten.
SmsSendOptions Diese Klasse stellt Optionen zum Konfigurieren von Zustellberichten bereit. Ist „enable_delivery_report“ auf TRUE festgelegt, wird bei erfolgreicher Zustellung ein Ereignis ausgegeben.
SmsSendResult Diese Klasse enthält das Ergebnis des SMS-Diensts.

Authentifizieren des Clients

Öffnen Sie Program.cs in einem Text-Editor, und ersetzen Sie den Text der Methode Main durch Code zum Initialisieren eines SMS-Clients (SmsClient) mit Ihrer Verbindungszeichenfolge. Im folgenden Code wird die Verbindungszeichenfolge für die Ressource aus einer Umgebungsvariablen namens COMMUNICATION_SERVICES_CONNECTION_STRING abgerufen. Informationen zur Verwaltung der Verbindungszeichenfolge Ihrer Ressource.

// 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 in Program.cs am Ende der Methode Main den folgenden Code 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 <from-phone-number> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Ressource zugeordnet ist.
  • Ersetzen Sie <to-phone-number> durch die Telefonnummer, an die Sie eine Nachricht senden möchten.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <from-phone-number> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

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 <from-phone-number> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Ressource zugeordnet ist.
  • Ersetzen <to-phone-number-1> und <to-phone-number-2> durch Telefonnummern, an die Sie eine Nachricht senden möchten.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <from-phone-number> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

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. Informationen zum Konfigurieren von Zustellberichten für SMS-Nachrichten finden Sie im Schnellstart Verarbeiten von SMS-Ereignissen.

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

Sie können die Beispiel-App von GitHub herunterladen.

Steigen Sie ein in Azure Communication Services, indem Sie das JavaScript-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.

Hinweis

Den fertigen Code für diese Schnellstartanleitung finden Sie auf GitHub.

Voraussetzungen

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 mit Ihrer Communication Services-Ressource verknüpften Telefonnummern anzuzeigen, melden Sie sich beim Azure-Portal an, und suchen Sie nach Ihrer Communication Services-Ressource. Klicken Sie im Navigationsbereich links auf Phone numbers (Telefonnummern).

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 den Standardeinstellungen zu erstellen.

    npm init -y
    
  3. Verwenden Sie einen Text-Editor, um im Stammverzeichnis des Projekts die Datei send-sms.js zu erstellen.

In den folgenden Abschnitten fügen Sie den gesamten Quellcode aus diesem Schnellstart zur soeben erstellten Datei send-sms.js hinzu.

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.

name Beschreibung
SmsClient Diese Klasse ist für alle SMS-Funktionen erforderlich. Sie instanziieren sie mit Ihren Abonnementinformationen und verwenden sie zum Senden von SMS-Nachrichten.
SmsSendRequest Bei dieser Schnittstelle handelt es sich um das Modell für die Erstellung der SMS-Anforderung. Hiermit konfigurieren Sie die Sender- und Empfängertelefonnummern sowie den SMS-Inhalt.
SmsSendOptions Diese Schnittstelle stellt Optionen zum Konfigurieren von Zustellberichten bereit. Ist enableDeliveryReport auf true festgelegt, wird bei erfolgreicher Zustellung ein Ereignis ausgegeben.
SmsSendResult Diese Klasse enthält das Ergebnis des SMS-Diensts.

Authentifizieren des Clients

Um einen Client zu authentifizieren, importieren Sie SmsClient aus dem SDK, und instanziieren Sie 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. Informationen zur Verwaltung der Verbindungszeichenfolge Ihrer Ressource.

So importieren Sie den Client und instanziieren ihn

  1. Erstellen Sie eine Datei namens send-sms.js.

  2. Fügen Sie send-sms.js den folgenden Code hinzu.

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 am Ende von send-sms.js den folgenden Code hinzu:

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 <from-phone-number> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Ressource zugeordnet ist.
  • Ersetzen <to-phone-number-1> und <to-phone-number-2> durch die Telefonnummern, an die Sie eine Nachricht senden möchten.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <from-phone-number> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

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 <from-phone-number> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Ressource zugeordnet ist.
  • Ersetzen <to-phone-number-1> und <to-phone-number-2> durch Telefonnummern, an die Sie eine Nachricht senden möchten.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <from-phone-number> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

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. Informationen zum Konfigurieren von Zustellberichten für SMS-Nachrichten finden Sie im Schnellstart Verarbeiten von SMS-Ereignissen. Das tag ist optional. Mit diesem Parameter können Sie ein Tag auf den Zustellbericht anwenden.

Ausführen des Codes

Verwenden Sie den Befehl node, 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.

Hinweis

Den fertigen Code für diese Schnellstartanleitung finden Sie auf GitHub.

Voraussetzungen

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 mit Ihrer Communication Services-Ressource verknüpften Telefonnummern anzuzeigen, melden Sie sich beim Azure-Portal an, und suchen Sie nach Ihrer Communication Services-Ressource. Klicken Sie im Navigationsbereich links auf Phone numbers (Telefonnummern).

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 Python-Anwendung

  1. Öffnen Sie Ihr Terminal oder Befehlsfenster. 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. Erstellen Sie mithilfe eines Text-Editors eine Datei mit dem Namen send-sms.py im Stammverzeichnis des Projekts, und fügen Sie die Struktur für das Programm hinzu (einschließlich einer einfachen Ausnahmebehandlung).

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

In den folgenden Abschnitten fügen Sie den gesamten Quellcode aus diesem Schnellstart zur soeben erstellten Datei send-sms.py hinzu.

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.

name Beschreibung
SmsClient Diese Klasse ist für alle SMS-Funktionen erforderlich. Sie instanziieren sie mit Ihren Abonnementinformationen und verwenden sie zum Senden von SMS-Nachrichten.
SmsSendResult Diese Klasse enthält das Ergebnis des SMS-Diensts.

Authentifizieren des Clients

Instanziieren Sie einen SMS-Client (SmsClient) mit Ihrer Verbindungszeichenfolge. Informationen zur Verwaltung der Verbindungszeichenfolge Ihrer Ressource.

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

Der Einfachheit halber werden Verbindungszeichenfolgen verwendet. In Produktionsumgebungen sollten jedoch Dienstprinzipale verwendet werden.

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. Fügen Sie in send-sms.py am Ende des try-Blocks den folgenden Code 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 <from-phone-number> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Instanz zugeordnet ist.
  • Ersetzen Sie <to-phone-number> durch die Telefonnummer, an die Sie eine Nachricht senden möchten.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <from-phone-number> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

Senden einer SMS: 1:N

Wenn Sie eine SMS an mehrere Empfänger*innen senden möchten, rufen Sie die send-Methode ü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. Fügen Sie in send-sms.py am Ende des try-Blocks den folgenden Code 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 <from-phone-number> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Instanz zugeordnet ist.
  • Ersetzen <to-phone-number-1> und <to-phone-number-2> durch Telefonnummern, an die Sie eine Nachricht senden möchten.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <from-phone-number> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

Optionale Parameter

Der enable_delivery_report-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. Informationen zum Konfigurieren von Zustellberichten für SMS-Nachrichten finden Sie im Schnellstart Verarbeiten von SMS-Ereignissen.

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.

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

Hinweis

Den fertigen Code für diese Schnellstartanleitung finden Sie auf GitHub.

Voraussetzungen

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 mit Ihrer Communication Services-Ressource verknüpften Telefonnummern anzuzeigen, melden Sie sich beim Azure-Portal an, und suchen Sie nach Ihrer Communication Services-Ressource. Klicken Sie im Navigationsbereich links auf Phone numbers (Telefonnummern).

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 Java-Anwendung

Öffnen Sie Ihr 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.

name Beschreibung
SmsClientBuilder Diese Klasse dient zum Erstellen des SMS-Clients (SmsClient). Sie müssen hierfür einen Endpunkt, Anmeldeinformationen sowie einen HTTP-Client bereitstellen.
SmsClient Diese Klasse ist für alle SMS-Funktionen erforderlich. Sie wird zum Senden von SMS-Nachrichten verwendet.
SmsSendOptions Diese Klasse stellt Optionen zum Hinzufügen benutzerdefinierter Tags und zum Konfigurieren von Zustellberichten bereit. Ist „deliveryReportEnabled“ auf TRUE festgelegt, wird bei erfolgreicher Zustellung ein Ereignis ausgegeben.
SmsSendResult Diese Klasse enthält das Ergebnis des SMS-Diensts.

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. Informationen zur Verwaltung der Verbindungszeichenfolge Ihrer Ressource. 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 <from-phone-number> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Ressource zugeordnet ist.
  • Ersetzen Sie <to-phone-number> durch eine Telefonnummer, an die Sie eine Nachricht senden möchten.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <from-phone-number> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

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 Sie <from-phone-number> durch eine SMS-fähige Telefonnummer, die Ihrer Communication Services-Ressource zugeordnet ist.
  • Ersetzen <to-phone-number-1> und <to-phone-number-2> durch Telefonnummern, an die Sie eine Nachricht senden möchten.

Warnung

Geben Sie Telefonnummern im internationalen Standardformat E.164 an, z. B. +14255550123. Der Wert für <from-phone-number> kann auch ein kurzer Code wie 23456 oder eine alphanumerische Absender-ID wie CONTOSO sein.

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. Informationen zum Konfigurieren von Zustellberichten für SMS-Nachrichten finden Sie im Schnellstart Verarbeiten von SMS-Ereignissen.

Mithilfe der setTag-Methode können Sie ein Tag auf den Zustellbericht anwenden.

Ausführen des Codes

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

    
    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"
    

Mithilfe des Azure Communication Services SMS-Connectors und Azure Logic Apps können Sie automatisierte Workflows erstellen, die SMS-Nachrichten versenden können. In dieser Schnellstartanleitung erfahren Sie, wie automatisch Textnachrichten als Antwort auf ein Triggerereignis gesendet werden können, was der erste Schritt in einem Logik-App-Workflow ist. Ein Triggerereignis kann eine eingehende E-Mail-Nachricht, ein Wiederholungszeitplan, ein Azure Event Grid-Ressourcenereignis oder jeder andere Trigger sein, der von Azure Logic Apps unterstützt wird.

Der Screenshot zeigt das Azure-Portal, das für den Logic App Designer geöffnet ist, und zeigt ein Logik-App-Beispiel, das die Aktion „SMS senden“ für den Azure Communication Services-Connector verwendet.

Obwohl sich dieser Schnellstart darauf konzentriert, den Connector als Antwort auf einen Trigger zu verwenden, können Sie den Connector auch nutzen, um auf andere Aktionen zu reagieren, also auf die Schritte, die in einem Workflow auf den Trigger folgen. Falls Sie noch nicht mit Logic Apps vertraut sind, finden Sie weitere Informationen unter Was ist Azure Logic Apps?, bevor Sie starten.

Hinweis

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

Voraussetzungen

Wichtig

Die SMS- und PSTN-Funktionen hängen von Ihrer Telefonnummer und dem durch Ihre Azure-Rechnungsanschrift festgelegten Land bzw. der Region ab. Weitere Informationen finden Sie in der Dokumentation zur Abonnementberechtigung.

Hinzufügen einer SMS-Aktion

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

  1. Wählen Sie im Designer unter dem Schritt, zu dem Sie die neue Aktion hinzufügen möchten, die Option Neuer Schritt aus. Alternativ können Sie die neue Aktion zwischen den Schritten hinzufügen, indem Sie den Mauszeiger über den Pfeil zwischen diesen Schritten bewegen, das Pluszeichen ( + ) und dann die Option Aktion hinzufügen auswählen.

  2. Geben Sie in das Suchfeld Vorgang auswählen die Zeichenfolge Azure Communication Services ein. Wählen Sie in der Aktionsliste SMS senden aus.

    Der Screenshot zeigt den Logic App Designer und den Azure Communication Services-Connector mit der ausgewählten Aktion „SMS senden“.

  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. Klicken Sie auf Erstellen.

      Der Screenshot zeigt die Konfiguration der Aktion „SMS senden“ mit Beispielinformationen.

    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. Klicken Sie auf Erstellen.

      Screenshot: Konfiguration der Authentifizierung für die Verbindungszeichenfolgen

    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. Klicken Sie auf Erstellen.

      Screenshot: Konfiguration der Dienstprinzipalauthentifizierung

  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 SMS senden-Aktion mit Beispielinformationen:

    Der Screenshot zeigt die 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 finden Sie im Abschnitt zum Ausführen Ihres Workflows.

Bereinigen von Workflow-Ressourcen

Zur Bereinigung Ihres Logik-Apps-Workflows und von verwandten Ressourcen finden Sie weitere Informationen unter Bereinigen von Logic Apps-Ressourcen.

Problembehandlung

Bei der Behandlung von Problemen im Zusammenhang mit der SMS-Übermittlung können Sie Übermittlungsberichte mit Event Grid aktivieren, um Übermittlungsdetails zu erfassen.

Bereinigen von Ressourcen

Wenn Sie ein Communication Services-Abonnement bereinigen und entfernen möchten, können Sie die Ressource oder die Ressourcengruppe löschen. Wenn Sie die Ressourcengruppe löschen, werden auch alle anderen Ressourcen gelöscht, die ihr zugeordnet sind. Weitere Informationen zum Bereinigen von Ressourcen finden Sie hier.

Gebührenfreie Überprüfung

Um eine neue gebührenfreie Nummer zum Senden von SMS-Nachrichten zu nutzen, muss der gebührenfreie Überprüfungsprozess durchlaufen werden. Anleitungen zum Abschließen der Überprüfung Ihrer gebührenfreien Nummer finden Sie im Schnellstart zum Übermitteln einer gebührenfreien Überprüfung. Beachten Sie, dass nur gebührenfreie Nummern, die vollständig überprüft wurden, berechtigt sind, SMS-Datenverkehr zu senden. SMS-Datenverkehr von nicht überprüften gebührenfreien Telefonnummern an Telefonnummern in den USA und Kanada wird blockiert.

Nächste Schritte

In dieser Schnellstartanleitung haben Sie erfahren, wie Sie Azure Communication Services zum Senden von SMS-Nachrichten verwenden.