Megosztás a következőn keresztül:


Rövid útmutató: SMS-üzenet küldése

Fontos

Az SMS-képességek az Ön által használt telefonszámtól és az Azure számlázási címe által meghatározott országtól/régiótól függenek. További információ: Előfizetési jogosultság.

Feljegyzés

Ossza meg velünk gondolatait és visszajelzéseit az Azure Communication Servicesről ezen rövid felméréssel.


Ismerkedés az Azure Communication Services szolgáltatással az Azure CLI Kommunikációs moduljával SMS-üzenetek küldéséhez.

A rövid útmutató elvégzése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókját illetően.

Előfeltételek

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa az --version az Azure CLI telepítésének ellenőrzéséhez.

Beállítás

A kommunikációs modul telepítése

Futtassa a következő parancsot egy terminálban vagy parancsablakban a kommunikációs modul telepítéséhez.

az extension add --name communication

Bejelentkezés az Azure CLI-be

Be kell jelentkeznie az Azure CLI-be. Bejelentkezhet a az login parancs terminálról való futtatásával, és megadhatja a hitelesítő adatait.

Győződjön meg arról, hogy a megfelelő előfizetést használja

Ha több előfizetése is van a fiókjában, győződjön meg arról, hogy a megfelelőt használja ehhez az oktatóanyaghoz.

Terminál- vagy parancsablakokban futtassa az alábbi parancsot az aktuális előfizetés ellenőrzéséhez.

az account show

Ha módosítania kell az előfizetést, ezt az alábbi parancs futtatásával teheti meg.

az account set --subscription "<yourSubcriptionId>"

Le kell cserélnie <yourSubscriptionId> a tényleges előfizetés-azonosítót, amelyet az Azure Portal Előfizetések szakaszában talál.

(Nem kötelező) Azure CLI SMS-műveletek használata kapcsolati sztring átadása nélkül

A környezeti változót AZURE_COMMUNICATION_CONNECTION_STRING úgy konfigurálhatja, hogy az Azure CLI SMS-műveleteit használja anélkül, hogy --connection_string a kapcsolati sztring kellene átadnia. Környezeti változó konfigurálásához nyisson meg egy konzolablakot, és válassza ki az operációs rendszert az alábbi lapokról. Cserélje le <yourConnectionString> a tényleges kapcsolati sztring.

Nyisson meg egy konzolablakot, és írja be a következő parancsot:

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Miután hozzáadta a környezeti változót, előfordulhat, hogy újra kell indítania minden futó programot, amelynek szüksége lehet a környezeti változó beolvasására, beleértve a konzolablakot is. Ha például a Visual Studiót használja szerkesztőként, indítsa újra a Visual Studiót a példa futtatása előtt.

Üzemeltetés

1:1-os SMS-üzenet küldése

Ha egyetlen címzettnek szeretne SMS-üzenetet küldeni, hívja meg a send metódust az SMS-modulból egyetlen címzett telefonszámával.

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

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <fromPhoneNumber> egy SMS-kompatibilis telefonszámra, amely a Communication Services-erőforráshoz van társítva.
  • Cserélje le <toPhoneNumber> azt a telefonszámot, amelynek üzenetet szeretne küldeni.
  • Cserélje le <yourConnectionString> a kapcsolati sztring.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <fromPhoneNumber> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

1:N SMS-üzenet küldése

Ha SMS-üzenetet szeretne küldeni a címzettek listájára, hívja meg a send metódust az SMS-modulból több címzett telefonszámával.

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

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <fromPhoneNumber> egy SMS-kompatibilis telefonszámra, amely a Communication Services-erőforráshoz van társítva.
  • Cserélje le <toPhoneNumberN> azt az N'th telefonszámot, amelynek üzenetet szeretne küldeni.
  • Cserélje le <yourConnectionString> a kapcsolati sztring.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <fromPhoneNumber> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services C# SMS SDK használatával SMS-üzenetek küldéséhez.

A rövid útmutató elvégzése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókját illetően.

Feljegyzés

Keresse meg a gitHubon a rövid útmutató véglegesített kódját.

Előfeltételek

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa a dotnet parancsot a .NET SDK telepítésének ellenőrzéséhez.
  • A Communication Services-erőforráshoz társított telefonszámok megtekintéséhez jelentkezzen be az Azure Portalra , és keresse meg a Communication Services-erőforrást. A bal oldali navigációs panelen válassza a Telefonszámok lehetőséget.

Az alkalmazáskörnyezet beállítása

Az üzenetek küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.

Új C#-alkalmazás létrehozása

  1. Egy konzolablakban , például a parancsmagban, a PowerShellben vagy a Bashben a dotnet new paranccsal hozzon létre egy új, a névvel SmsQuickstartellátott konzolalkalmazást. Ez a parancs létrehoz egy egyszerű "„Helló világ!” alkalmazás" C#-projektet egyetlen forrásfájllal, Program.cs.

    dotnet new console -o SmsQuickstart
    
  2. Módosítsa a könyvtárat az újonnan létrehozott alkalmazásmappára, és használja a dotnet build parancsot az alkalmazás fordításához.

    cd SmsQuickstart
    dotnet build
    

Telepítse a(z) csomagot

  1. Amíg az alkalmazáskönyvtárban marad, telepítse az Azure Communication Services SMS SDK for .NET-csomagot az alábbi paranccsal.

    dotnet add package Azure.Communication.Sms --version 1.0.0
    
  2. Adjon hozzá egy direktívát using a Program.cs elejéhez, hogy belefoglalja a névteret Azure.Communication .

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

Objektummodell

Az alábbi osztályok és felületek az Azure Communication Services SMS SDK for C# néhány fő funkcióját kezelik.

Név Leírás
SmsClient Ez az osztály minden SMS-funkcióhoz szükséges. Az előfizetés adataival példányosíthatja azokat, és SMS-üzeneteket küldhet velük.
SmsSendOptions Ez az osztály a kézbesítési jelentés konfigurálásának lehetőségeit tartalmazza. Ha enable_delivery_report értéke Igaz, a kézbesítés sikeres befejezésekor egy esemény lesz kibocsátva.
SmsSendResult Ez az osztály az SMS-szolgáltatás eredményét tartalmazza.

Az ügyfél hitelesítése

Nyissa meg a Program.cs egy szövegszerkesztőben, és cserélje le a Main metódus törzsét kódra a kapcsolati sztring inicializálásáhozSmsClient. Az alábbi kód lekéri az erőforrás kapcsolati sztring egy nevesített COMMUNICATION_SERVICES_CONNECTION_STRINGkörnyezeti változóból. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.

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

SmsClient smsClient = new SmsClient(connectionString);

1:1-os SMS-üzenet küldése

Ha egyetlen címzettnek szeretne SMS-üzenetet küldeni, hívja meg az Send SmsClient függvényt vagy SendAsync függvényt. Adja hozzá ezt a kódot a metódus végéhez a Main Program.cs:

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

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

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <from-phone-number> egy SMS-kompatibilis telefonszámra, amely a Communication Services-erőforráshoz van társítva.
  • Cserélje le <to-phone-number> azt a telefonszámot, amelynek üzenetet szeretne küldeni.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <from-phone-number> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

1:N SMS-üzenet küldése a beállításokkal

Ha SMS-üzenetet szeretne küldeni a címzettek listájára, hívja meg vagy hívja meg az Send SendAsync SmsClient függvényt a címzett telefonszámainak listájával. Opcionális paramétereket is megadhat annak megadásához, hogy engedélyezve legyen-e a kézbesítési jelentés, és egyéni címkéket állítson be.

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}");
}

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <from-phone-number> egy SMS-kompatibilis telefonszámra, amely a Communication Services-erőforráshoz van társítva.
  • Cserélje le <to-phone-number-1> és <to-phone-number-2> írja be azokat a telefonszámokat, amelyeknek üzenetet szeretne küldeni.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <from-phone-number> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

A enableDeliveryReport paraméter egy opcionális paraméter, amellyel konfigurálhatja a kézbesítési jelentéskészítést. Ez a funkció akkor hasznos, ha eseményeket szeretne kibocsátani az SMS-üzenetek kézbesítésekor. Az SMS-üzenetek kézbesítési jelentésének konfigurálásához tekintse meg az SMS-események kezelése rövid útmutatót.

A paraméterrel Tag címkét alkalmazhat a kézbesítési jelentésre.

A kód futtatása

Futtassa az alkalmazást az alkalmazáskönyvtárból a dotnet run paranccsal.

dotnet run

Mintakód

A mintaalkalmazást a GitHubról töltheti le.

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services JavaScript SMS SDK használatával SMS-üzenetek küldéséhez.

A rövid útmutató elvégzése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókját illetően.

Feljegyzés

Keresse meg a gitHubon a rövid útmutató véglegesített kódját.

Előfeltételek

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa node --version a Node.js telepítésének ellenőrzéséhez.
  • A Communication Services-erőforráshoz társított telefonszámok megtekintéséhez jelentkezzen be az Azure Portalra , és keresse meg a Communication Services-erőforrást. A bal oldali navigációs panelen válassza a Telefonszámok lehetőséget.

Az alkalmazáskörnyezet beállítása

Az üzenetek küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.

Új Node.js-alkalmazás létrehozása

  1. Nyissa meg a terminált vagy a parancsablakot, majd futtassa a következő parancsot egy új könyvtár létrehozásához az alkalmazáshoz, és keresse meg.

    mkdir sms-quickstart && cd sms-quickstart
    
  2. Futtassa a következő parancsot egy alapértelmezett beállításokkal rendelkező package.json fájl létrehozásához.

    npm init -y
    
  3. Szövegszerkesztővel hozzon létre egy send-sms.js nevű fájlt a projekt gyökérkönyvtárában.

A következő szakaszokban a rövid útmutató összes forráskódját hozzáadja az imént létrehozott send-sms.js fájlhoz.

Telepítse a(z) csomagot

npm install A parancs használatával telepítse az Azure Communication Services SMS SDK for JavaScriptet.

npm install @azure/communication-sms --save

A --save beállítás függőségként sorolja fel a tárat a package.json fájlban.

Objektummodell

Az alábbi osztályok és felületek az Azure Communication Services SMS SDK Node.js főbb funkcióit kezelik.

Név Leírás
SmsClient Ez az osztály minden SMS-funkcióhoz szükséges. Az előfizetés adataival példányosíthatja azokat, és SMS-üzeneteket küldhet velük.
SmsSendRequest Ez az interfész az SMS-kérés létrehozásának modellje. Ezzel konfigurálhatja a telefonszámokat és az SMS-tartalmakat.
SmsSendOptions Ez az interfész a kézbesítési jelentés konfigurálására szolgáló lehetőségeket nyújt. Ha enableDeliveryReport be van állítva true, a rendszer egy eseményt bocsát ki, amikor a kézbesítés sikeres.
SmsSendResult Ez az osztály az SMS-szolgáltatás eredményét tartalmazza.

Az ügyfél hitelesítése

Az ügyfél hitelesítéséhez importálja az SmsClientet az SDK-ból, és példányosíthatja azt a kapcsolati sztring. Az erőforrás kapcsolati sztring lekérheti egy környezeti változóból. Az ebben a szakaszban szereplő kód például lekéri a kapcsolati sztring a COMMUNICATION_SERVICES_CONNECTION_STRING környezeti változóból. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.

Az ügyfél importálása és példányosítása:

  1. Hozzon létre egy send-sms.js nevű fájlt.

  2. Adja hozzá a következő kódot a send-sms.js.

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);

1:N SMS-üzenet küldése

Ha SMS-üzenetet szeretne küldeni a címzettek listájára, hívja meg az send SmsClient függvényt a címzett telefonszámainak listájával. Ha egyetlen címzettnek szeretne üzenetet küldeni, csak egy számot adjon meg a listában. Adja hozzá ezt a kódot a send-sms.js végéhez:

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();

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <from-phone-number> egy SMS-kompatibilis telefonszámra, amely a Communication Services-erőforráshoz van társítva.
  • Cserélje le és <to-phone-number-2> írja be <to-phone-number-1> azokat a telefonszámokat, amelyeknek üzenetet szeretne küldeni.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <from-phone-number> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

1:N SMS-üzenet küldése a beállításokkal

Megadhat egy beállításobjektumot is, amely megadja, hogy engedélyezve legyen-e a kézbesítési jelentés, és egyéni címkéket állítson be.


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();

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <from-phone-number> egy SMS-kompatibilis telefonszámra, amely a Communication Services-erőforráshoz van társítva.
  • Cserélje le <to-phone-number-1> és <to-phone-number-2> írja be azokat a telefonszámokat, amelyeknek üzenetet szeretne küldeni.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <from-phone-number> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

A enableDeliveryReport paraméter egy opcionális paraméter, amellyel konfigurálhatja a kézbesítési jelentéskészítést. Ez a funkció akkor hasznos, ha eseményeket szeretne kibocsátani az SMS-üzenetek kézbesítésekor. Az SMS-üzenetek kézbesítési jelentésének konfigurálásához tekintse meg az SMS-események kezelése rövid útmutatót. A tag paraméter megadása nem kötelező. Ezzel címkét alkalmazhat a kézbesítési jelentésre.

A kód futtatása

node A paranccsal futtassa a send-sms.js fájlhoz hozzáadott kódot.


node ./send-sms.js

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services Python SMS SDK használatával SMS-üzenetek küldéséhez.

A rövid útmutató elvégzése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókját illetően.

Feljegyzés

Keresse meg a gitHubon a rövid útmutató véglegesített kódját.

Előfeltételek

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa a parancsot annak python --version ellenőrzéséhez, hogy telepítve van-e a Python.
  • A Communication Services-erőforráshoz társított telefonszámok megtekintéséhez jelentkezzen be az Azure Portalra , és keresse meg a Communication Services-erőforrást. A bal oldali navigációs panelen válassza a Telefonszámok lehetőséget.

Az alkalmazáskörnyezet beállítása

Az üzenetek küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.

Új Python-alkalmazás létrehozása

  1. Nyissa meg a terminált vagy a parancsablakot. Ezután az alábbi paranccsal hozzon létre egy új könyvtárat az alkalmazáshoz, és navigáljon hozzá.

    mkdir sms-quickstart && cd sms-quickstart
    
  2. Szövegszerkesztővel hozzon létre egy send-sms.py nevű fájlt a projekt gyökérkönyvtárában, és adja hozzá a program struktúráját, beleértve az alapvető kivételkezelést is.

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

A következő szakaszokban a rövid útmutató összes forráskódját hozzáadja az imént létrehozott send-sms.py fájlhoz.

Telepítse a(z) csomagot

Amíg továbbra is az alkalmazáskönyvtárban van, telepítse az Azure Communication Services SMS SDK for Python-csomagot az alábbi paranccsal.

pip install azure-communication-sms

Objektummodell

Az alábbi osztályok és felületek kezelik a Pythonhoz készült Azure Communication Services SMS SDK főbb funkcióit.

Név Leírás
SmsClient Ez az osztály minden SMS-funkcióhoz szükséges. Az előfizetés adataival példányosíthatja azokat, és SMS-üzeneteket küldhet velük.
SmsSendResult Ez az osztály az SMS-szolgáltatás eredményét tartalmazza.

Az ügyfél hitelesítése

Az SmsClient példányosítása a kapcsolati sztring. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring.

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

Az egyszerűség kedvéért ez a rövid útmutató kapcsolati sztring használ, éles környezetben azonban a szolgáltatásnevek használatát javasoljuk.

1:1-os SMS-üzenet küldése

Ha egyetlen címzettnek szeretne SMS-üzenetet küldeni, hívja meg az send SmsClient metódusát egyetlen címzett telefonszámával. Opcionális paramétereket is megadhat annak megadásához, hogy engedélyezve legyen-e a kézbesítési jelentés, és egyéni címkéket állítson be. Adja hozzá ezt a kódot a blokk végéhez a try send-sms.py:


# 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

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <from-phone-number> a kommunikációs szolgáltatáshoz társított SMS-kompatibilis telefonszámra.
  • Cserélje le <to-phone-number> azt a telefonszámot, amelynek üzenetet szeretne küldeni.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <from-phone-number> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

1:N SMS-üzenet küldése

Ha SMS-üzenetet szeretne küldeni a címzettek listájára, hívja meg az send SmsClient metódusát a címzett telefonszámainak listájával. Opcionális paramétereket is megadhat annak megadásához, hogy engedélyezve legyen-e a kézbesítési jelentés, és egyéni címkéket állítson be. Adja hozzá ezt a kódot a blokk végéhez a try send-sms.py:


# 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

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <from-phone-number> a kommunikációs szolgáltatáshoz társított SMS-kompatibilis telefonszámra.
  • Cserélje le <to-phone-number-1> és <to-phone-number-2> írja be azokat a telefonszámokat, amelyeknek üzenetet szeretne küldeni.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <from-phone-number> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

Választható paraméterek

A enable_delivery_report paraméter egy opcionális paraméter, amellyel konfigurálhatja a kézbesítési jelentéskészítést. Ez a funkció akkor hasznos, ha eseményeket szeretne kibocsátani az SMS-üzenetek kézbesítésekor. Az SMS-üzenetek kézbesítési jelentésének konfigurálásához tekintse meg az SMS-események kezelése rövid útmutatót.

A tag paraméter egy választható paraméter, amellyel címkét alkalmazhat a kézbesítési jelentésre.

A kód futtatása

Futtassa az alkalmazást az alkalmazáskönyvtárból a python paranccsal.

python send-sms.py

A teljes Python-szkriptnek a következő kódhoz hasonlóan kell kinéznie:


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)

Ismerkedés az Azure Communication Services szolgáltatással a Communication Services Java SMS SDK használatával SMS-üzenetek küldéséhez.

A rövid útmutató elvégzése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókját illetően.

Feljegyzés

Keresse meg a gitHubon a rövid útmutató véglegesített kódját.

Előfeltételek

Előfeltételek ellenőrzése

  • Egy terminál vagy parancsablakban futtassa mvn -v a Maven telepítését.
  • A Communication Services-erőforráshoz társított telefonszámok megtekintéséhez jelentkezzen be az Azure Portalra , és keresse meg a Communication Services-erőforrást. A bal oldali navigációs panelen válassza a Telefonszámok lehetőséget.

Az alkalmazáskörnyezet beállítása

Az üzenetek küldésére szolgáló környezet beállításához kövesse az alábbi szakaszok lépéseit.

Új Java-alkalmazás létrehozása

Nyissa meg a terminált vagy a parancsablakot, és lépjen arra a könyvtárra, ahol létre szeretné hozni a Java-alkalmazást. Futtassa a következő parancsot a Java-projekt létrehozásához a maven-archetype-quickstart sablonból.

  • Parancssorba
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"

A generate cél létrehoz egy olyan könyvtárat, amelynek neve megegyezik az artifactId értékkel. Ebben a könyvtárban az src/main/java könyvtár tartalmazza a projekt forráskódját, az src/test/java könyvtár a tesztforrást, a pom.xml fájl pedig a projekt projektobjektum-modelljét (POM).

Telepítse a(z) csomagot

Nyissa meg a pom.xml fájlt a szövegszerkesztőben. Adja hozzá a következő függőségi elemet a függőségek csoportjához.

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

Az alkalmazás-keretrendszer beállítása

Nyissa meg a /src/main/java/com/communication/quickstart/App.java szövegszerkesztőben, adjon hozzá importálási irányelveket, és távolítsa el az utasítást System.out.println("Hello world!"); :

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.
    }
}

Objektummodell

Az alábbi osztályok és felületek kezelik az Azure Communication Services SMS SDK for Java néhány fő funkcióját.

Név Leírás
SmsClientBuilder Ez az osztály létrehozza az SmsClientet. Adjon meg egy végpontot, egy hitelesítő adatot és egy HTTP-ügyfelet.
SmsClient Ez az osztály minden SMS-funkcióhoz szükséges. Sms-üzenetek küldéséhez használja.
SmsSendOptions Ez az osztály lehetőséget biztosít egyéni címkék hozzáadására és a kézbesítési jelentés konfigurálására. Ha a deliveryReportEnabled értéke igaz, egy eseményt bocsát ki a rendszer, ha a kézbesítés sikeres.
SmsSendResult Ez az osztály az SMS-szolgáltatás eredményét tartalmazza.

Az ügyfél hitelesítése

Az ügyfél hitelesítéséhez példányt kell létrehoznia a SmsClient kapcsolati sztring. A hitelesítő adatokhoz használja az Key Azure Portalról származó adatokat. Megtudhatja, hogyan kezelheti az erőforrás kapcsolati sztring. Az ügyfelet inicializálhatja bármely egyéni HTTP-ügyféllel is, amely implementálja a com.azure.core.http.HttpClient felületet.

Ügyfél példányosításához adja hozzá a következő kódot a main metódushoz:

// 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();

A teljes kapcsolati sztring a végpont és a hozzáférési kulcs megadása helyett a connectionString függvény használatával is megadhatja.

// 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();

1:1-os SMS-üzenet küldése

Ha egyetlen címzettnek szeretne SMS-üzenetet küldeni, hívja meg az send SmsClient metódusát egyetlen címzett telefonszámával. Opcionális paramétereket is megadhat annak megadásához, hogy engedélyezve legyen-e a kézbesítési jelentés, és egyéni címkéket állítson be.

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());

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <from-phone-number> egy SMS-kompatibilis telefonszámra, amely a Communication Services-erőforráshoz van társítva.
  • Cserélje le <to-phone-number> azt a telefonszámot, amelynek üzenetet szeretne küldeni.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <from-phone-number> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

1:N SMS-üzenet küldése a beállításokkal

Ha SMS-üzenetet szeretne küldeni a címzettek listájára, hívja meg a send metódust a címzett telefonszámainak listájával. Opcionális paramétereket is megadhat annak megadásához, hogy engedélyezve legyen-e a kézbesítési jelentés, és egyéni címkéket állítson be.

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());
}

Végezze el ezeket a csereeket a kódban:

  • Cserélje le <from-phone-number> a Communication Services-erőforráshoz társított SMS-kompatibilis telefonszámra
  • Cserélje le <to-phone-number-1> és <to-phone-number-2> írja be azokat a telefonszámokat, amelyeknek üzenetet szeretne küldeni.

Figyelmeztetés

Adjon meg telefonszámokat E.164 nemzetközi szabvány formátumban, például +14255550123. Az érték <from-phone-number> lehet egy rövid kód is, például 23456 vagy alfanumerikus feladóazonosító, például CONTOSO.

A setDeliveryReportEnabled metódus a kézbesítési jelentés konfigurálására szolgál. Ez a funkció akkor hasznos, ha eseményeket szeretne kibocsátani az SMS-üzenetek kézbesítésekor. Az SMS-üzenetek kézbesítési jelentésének konfigurálásához tekintse meg az SMS-események kezelése rövid útmutatót.

Ezzel a setTag módszerrel címkét alkalmazhat a kézbesítési jelentésre.

A kód futtatása

  1. Lépjen a pom.xml fájlt tartalmazó könyvtárra, és fordítsa le a projektet a mvn parancs használatával.

    
    mvn compile
    
    
  2. Hozza létre a csomagot.

    
    mvn package
    
    
  3. Futtassa a következő mvn parancsot az alkalmazás végrehajtásához.

    • Parancssorba
    
    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"
    

Az Azure Communication Services SMS-összekötő és az Azure Logic Apps használatával olyan automatizált munkafolyamatokat hozhat létre, amelyek SMS-üzeneteket küldhetnek. Ez a rövid útmutató bemutatja, hogyan küldhet automatikusan szöveges üzeneteket egy eseményindító eseményre válaszul, amely egy logikai alkalmazás munkafolyamatának első lépése. Az eseményindító lehet bejövő e-mail üzenet, ismétlődési ütemezés, Azure Event Grid-erőforrásesemény vagy az Azure Logic Apps által támogatott egyéb eseményindító.

Képernyőkép a Logic App Designer számára megnyitott Azure Portalról, és egy példa logikai alkalmazásról, amely az Sms küldése műveletet használja az Azure Communication Services-összekötőhöz.

Bár ez a rövid útmutató arra összpontosít, hogy az összekötővel reagáljon egy eseményindítóra, az összekötővel más műveletekre is reagálhat, amelyek a munkafolyamat eseményindítójának lépései. Ha még csak most ismerkedik a Logic Apps szolgáltatásokkal, első lépésként tekintse át az Azure Logic Apps újdonságait .

Feljegyzés

A rövid útmutató elvégzése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókját illetően.

Előfeltételek

Fontos

Az SMS és a PSTN képességei a használt telefonszámtól és az Azure számlázási címétől függően működő országtól/régiótól függenek. További információkért tekintse meg az előfizetés jogosultsági dokumentációját.

SMS-művelet hozzáadása

Ha új lépésként szeretné hozzáadni az SMS-küldési műveletet a munkafolyamathoz az Azure Communication Services SMS-összekötőjével, kövesse az alábbi lépéseket az Azure Portalon , és nyissa meg a logikai alkalmazás munkafolyamatát a Logic App Designerben:

  1. A tervezőn a lépés alatt, ahol hozzá szeretné adni az új műveletet, válassza az Új lépés lehetőséget. Másik lehetőségként az új művelet lépések közötti hozzáadásához vigye az egérmutatót a lépések közötti nyíl fölé, válassza a pluszjelet (+), és válassza a Művelet hozzáadása lehetőséget.

  2. A Művelet kiválasztása keresőmezőbe írja be a következőtAzure Communication Services: A műveletek listájában válassza az SMS küldése lehetőséget.

    Képernyőkép a Logic App Designerről és az Azure Communication Services-összekötőről, amelyen az SMS-küldés művelet van kiválasztva.

  3. Most hozzon létre egy kapcsolatot a Communication Services-erőforrással.

    1. Ugyanabban az előfizetésben:

      1. Adja meg a kapcsolat nevét.

      2. Válassza ki az Azure Communication Services-erőforrást.

      3. Válassza a Létrehozás lehetőséget.

      Képernyőkép az SMS-műveletkonfiguráció mintainformációkkal való elküldéséről.

    2. A Communication Services-erőforrásból származó kapcsolati sztring használata:

      1. Adja meg a kapcsolat nevét.

      2. Válassza a ConnectionString Authentication lehetőséget a legördülő menüben.

      3. Adja meg a Communication Services-erőforrás kapcsolati sztring.

      4. Válassza a Létrehozás lehetőséget.

      Képernyőkép a kapcsolati sztring-hitelesítés konfigurációjáról.

    3. Szolgáltatásnév használata (hivatkozási szolgáltatásnév létrehozása):

      1. Adja meg a kapcsolat nevét.

      2. Válassza ki a szolgáltatásnév (Microsoft Entra-alkalmazás) hitelesítését a legördülő menüből.

      3. Adja meg a szolgáltatásnév bérlőazonosítóját, ügyfél-azonosítóját és ügyfélkulcsát.

      4. Adja meg a Communication Services-végpont URL-címét a Communication Services-erőforrásban.

      5. Válassza a Létrehozás lehetőséget.

      Képernyőkép a szolgáltatásnév-hitelesítés konfigurációjáról.

  4. Az SMS küldése műveletben adja meg a következő információkat:

    • A forrás és a cél telefonszámai. Tesztelési célokra használhatja a saját telefonszámát cél telefonszámként.

    • A küldeni kívánt üzenet tartalma, például "Hello from Logic Apps!".

    Íme egy SMS-küldési művelet példainformációkkal:

    Képernyőkép az SMS-küldés műveletről mintaadatokkal.

  5. Ha elkészült, a tervező eszköztárán válassza a Mentés lehetőséget.

Ezután futtassa a munkafolyamatot teszteléshez.

A munkafolyamat tesztelése

A munkafolyamat manuális elindításához a tervező eszköztárán válassza a Futtatás lehetőséget. Vagy megvárhatja, amíg az eseményindító kigyullad. A munkafolyamatnak mindkét esetben SMS-üzenetet kell küldenie a megadott cél telefonszámra. További információkért tekintse át a munkafolyamat futtatásának módját.

Munkafolyamat-erőforrások törlése

A logikai alkalmazás munkafolyamatának és a kapcsolódó erőforrások törléséhez tekintse át a Logic Apps-erőforrások törlésének módját.

Hibaelhárítás

Az SMS-kézbesítéssel kapcsolatos problémák elhárításához engedélyezheti a kézbesítési jelentéskészítést az Event Griddel a kézbesítési adatok rögzítéséhez.

Az erőforrások eltávolítása

Ha törölni és eltávolítani szeretne egy Communication Services-előfizetést, törölheti az erőforrást vagy az erőforráscsoportot. Az erőforráscsoport törlése a hozzá társított egyéb erőforrásokat is törli. További információ az erőforrások tisztításáról.

Ingyenes ellenőrzés

Ha új ingyenes számot szeretne használni az SMS-üzenetek küldéséhez, kötelező az ingyenes ellenőrzési folyamat. Az ingyenes szám ellenőrzésének elvégzésével kapcsolatos útmutatásért tekintse meg az ingyenes ellenőrzés elküldéséhez szükséges rövid útmutatót. Vegye figyelembe, hogy csak a teljes mértékben ellenőrzött ingyenes számok jogosultak SMS-forgalom küldésére. Az USA-ba és a CA-ra irányuló nem ellenőrzött ingyenes számokról érkező SMS-forgalom le lesz tiltva.

Következő lépések

Ebben a rövid útmutatóban megtanulta, hogyan küldhet SMS-üzeneteket az Azure Communication Services használatával.