Odeslání zprávy SMS

Important

Možnosti SMS závisí na telefonním čísle, které používáte, a na zemi nebo oblasti, ve které pracujete podle vaší fakturační adresy Azure. Další informace najdete v tématu Způsobilost k předplatnému.


Začínáme se službou Azure Communication Services pomocí modulu Komunikace v Azure CLI k odesílání zpráv SMS.

Dokončení tohoto článku může na vašem účtu Azure způsobit malý náklad v řádu několika amerických centů nebo méně.

Prerequisites

Kontrola předpokladů

  • V terminálu nebo příkazovém okně spusťte kontrolu az --version , jestli je nainstalované Rozhraní příkazového řádku Azure.

Instalace

Instalace komunikačního modulu

Pro instalaci komunikačního modulu spusťte v terminálu nebo příkazovém okně následující příkaz.

az extension add --name communication

Přihlášení k Azure CLI

Musíte se přihlásit k Azure CLI. Můžete se přihlásit spuštěním az login příkazu z terminálu a zadat své přihlašovací údaje.

Ujistěte se, že používáte správné předplatné.

Pokud máte ve svém účtu více předplatných, ujistěte se, že používáte ten správný pro účely tohoto kurzu.

V terminálu nebo v oknech příkazů spusťte následující příkaz a zkontrolujte aktuální předplatné.

az account show

Pokud potřebujete změnit předplatné, můžete to provést spuštěním následujícího příkazu.

az account set --subscription "<yourSubscriptionId>"

Musíte nahradit <yourSubscriptionId> skutečným ID předplatného, které najdete v části Předplatná na webu Azure Portal.

(Volitelné) Použití operací sms v Azure CLI bez předání připojovací řetězec

Proměnnou AZURE_COMMUNICATION_CONNECTION_STRING prostředí můžete nakonfigurovat tak, aby používala operace sms Azure CLI, aniž byste museli předávat --connection_string připojovací řetězec. Pokud chcete nakonfigurovat proměnnou prostředí, otevřete okno konzoly a na následujících kartách vyberte operační systém. Nahraďte <yourConnectionString> skutečnými připojovací řetězec.

Otevřete okno konzoly a zadejte následující příkaz:

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Po přidání proměnné prostředí možná bude nutné restartovat všechny spuštěné programy, které budou potřebovat číst tuto proměnnou prostředí, a to včetně okna konzoly. Pokud například jako editor používáte Sadu Visual Studio, restartujte sadu Visual Studio před spuštěním příkladu.

Operations

Odeslání zprávy SMS ve verzi 1:1

Pokud chcete poslat sms zprávu jednomu příjemci, zavolejte send metodu z modulu SMS s jedním telefonním číslem příjemce.

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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <fromPhoneNumber> telefonním číslem s podporou SMS spojeným s vaším prostředkem komunikačních služeb.
  • Nahraďte <toPhoneNumber> telefonním číslem, na které chcete poslat zprávu.
  • Nahraďte <yourConnectionString> připojovací řetězec.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnota <fromPhoneNumber> může být také krátký kód, například 23456 nebo ID alfanumerického odesílatele, například CONTOSO.

Odeslání zprávy SMS 1:N

Pokud chcete poslat sms zprávu do seznamu příjemců, zavolejte send metodu z modulu SMS s více telefonními čísly příjemců.

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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <fromPhoneNumber> telefonním číslem s podporou SMS spojeným s vaším prostředkem komunikačních služeb.
  • Nahraďte <toPhoneNumberN> N'th telefonním číslem, na které chcete poslat zprávu.
  • Nahraďte <yourConnectionString> připojovací řetězec.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnotou for <fromPhoneNumber> může být také krátký kód, například 23456 nebo alfanumerické ID odesílatele, například CONTOSO.

Odeslat SMS zprávu s výkazem doručení a štítkem DeliveryReport a Tag.

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

Tento deliveryReport parametr je volitelný parametr, který můžete použít ke konfiguraci vykazování doručení. Tuto funkci použijte, pokud chcete generovat události při doručování SMS zpráv. V části Zpracování událostí SMS nakonfigurujte hlášení o doručení zpráv SMS.

Parametr tag je volitelný parametr, který můžete použít k použití značky v sestavě doručení.

Proveďte tyto nahrazení v kódu:

  • Nahraďte <fromPhoneNumber> telefonním číslem s podporou SMS spojeným s vaším prostředkem komunikačních služeb.
  • Nahraďte <toPhoneNumber> telefonním číslem, na které chcete poslat zprávu.
  • Nahraďte <yourConnectionString> připojovací řetězec.
  • Nahraďte <yourCustomTag> vlastní značkou.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnota <fromPhoneNumber> může být také krátký kód, například 23456 nebo ID alfanumerického odesílatele, například CONTOSO.

Začínáme se službou Azure Communication Services pomocí sady SDK SMS služby Communication Services pro odesílání zpráv SMS

Dokončení tohoto článku může na vašem účtu Azure způsobit malý náklad v řádu několika amerických centů nebo méně.

Note

Finální kód najdete v tématu Ukázky Azure na GitHubu: Odeslání SMS zprávy pomocí .NET.

Prerequisites

Kontrola předpokladů

  • V terminálu nebo příkazovém okně spusťte dotnet příkaz a zkontrolujte, jestli je nainstalovaná sada .NET SDK.
  • Pokud chcete zobrazit telefonní čísla přidružená k vašemu prostředku Komunikační služby, přihlaste se k webu Azure Portal a vyhledejte prostředek Komunikační služby. V navigačním podokně vlevo vyberte Telefonní čísla.

Nastavení aplikačního prostředí

Pokud chcete nastavit prostředí pro odesílání zpráv, proveďte kroky v následujících částech.

Vytvoření nové aplikace jazyka C#

  1. V okně konzoly, například cmd, PowerShell nebo Bash, použijte dotnet new příkaz k vytvoření nové konzolové aplikace s názvem SmsQuickstart. Tento příkaz vytvoří jednoduchý projekt "Hello World" C# s jedním zdrojovým souborem Program.cs.

    dotnet new console -o SmsQuickstart

  2. Změňte adresář na nově vytvořenou složku aplikace a pomocí dotnet build příkazu zkompilujte aplikaci.

    cd SmsQuickstart
dotnet build

Nainstalujte balíček .

  1. V adresáři aplikace nainstalujte sadu SDK SMS služby Azure Communication Services pro .NET pomocí následujícího příkazu.

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

  2. Přidejte direktivu using na začátek Program.cs pro zahrnutí Azure.Communication oboru názvů.

    
using System;
using System.Collections.Generic;

using Azure;
using Azure.Communication;
using Azure.Communication.Sms;

Objektový model

Následující třídy a rozhraní zpracovávají některé z hlavních funkcí sady AZURE Communication Services SMS SDK pro jazyk C#.

Name Description
SmsClient Tato třída je nutná pro všechny funkce SMS. Vytvoříte instanci s informacemi o předplatném a použijete je k odesílání sms zpráv.
SmsSendOptions Tato třída poskytuje možnosti konfigurace generování sestav doručení. Pokud je enable_delivery_report nastavena na Hodnotu True, událost se vygeneruje při úspěšném doručení.
SmsSendResult Tato třída obsahuje výsledek ze služby SMS.

Ověření klienta

Otevřete Program.cs v textovém editoru a nahraďte tělo metody Main kódem, který inicializuje SmsClient pomocí vašeho připojovacího řetězce. Následující kód načte připojovací řetězec pro prostředek z proměnné prostředí s názvem COMMUNICATION_SERVICES_CONNECTION_STRING. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.

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

SmsClient smsClient = new SmsClient(connectionString);

Odeslání zprávy SMS ve verzi 1:1

Chcete-li odeslat sms zprávu jednomu příjemci, zavolejte Send nebo SendAsync funkci z SmsClient. Přidejte tento kód na konec Main metody v 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}");

Proveďte tyto nahrazení v kódu:

  • Nahraďte <from-phone-number> telefonním číslem s podporou SMS spojeným s vaším prostředkem komunikačních služeb.
  • Nahraďte <to-phone-number> telefonním číslem, na které chcete poslat zprávu.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnotou for <from-phone-number> může být také krátký kód, například 23456 nebo alfanumerické ID odesílatele, například CONTOSO.

Odeslání zprávy SMS 1:N s možnostmi

Pokud chcete poslat sms zprávu do seznamu příjemců, zavolejte Send na SmsClient funkci SendAsync se seznamem telefonních čísel příjemců. Můžete také zadat volitelné parametry, které určují, jestli má být zpráva o doručení povolená, a nastavit vlastní značky.

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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <from-phone-number> telefonním číslem s podporou SMS spojeným s vaším prostředkem komunikačních služeb.
  • Nahraďte <to-phone-number-1> telefonní <to-phone-number-2> čísla, na která chcete poslat zprávu.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnotou for <from-phone-number> může být také krátký kód, například 23456 nebo alfanumerické ID odesílatele, například CONTOSO.

Parametr enableDeliveryReport je volitelný parametr, který můžete použít ke konfiguraci generování sestav doručení. Tato funkce je užitečná, když chcete generovat události při doručení zpráv SMS. V rychlém startu Zpracování událostí SMS nakonfigurujte hlášení doručení pro zprávy SMS.

Pomocí parametru Tag můžete použít značku pro sestavu doručení.

Globální odesílání SMS pomocí služby Messaging Connect

Important

Tato funkce služeb Azure Communication Services je aktuálně ve verzi Preview. Funkce ve verzi Preview jsou veřejně dostupné a můžou je používat všichni noví a stávající zákazníci Microsoftu.

API a sady SDK ve verzi Preview jsou poskytovány bez smlouvy o úrovni služeb. Doporučujeme je nepoužívat pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou být omezené.

Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Pokud používáte telefonní číslo zřízené prostřednictvím služby Messaging Connect, můžete zprávy SMS odesílat pomocí standardní sady SDK služby Azure Communication Services. Jediným rozdílem je, že musíte zahrnout MessagingConnect objekt, abyste zadali název partnera a klíč rozhraní API.

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

Nahraďte tyto hodnoty:

  • <from-messaging-connect-number>: Telefonní číslo získané prostřednictvím služby Messaging Connect a propojené s vaším prostředkem služby ACS.
  • <to-phone-number-1> a <to-phone-number-2>: Telefonní čísla příjemce.
  • <partner-api-key>: Klíč rozhraní API od partnera služby Messaging Connect (např. Infobip).

Tip

Chcete se dozvědět více o globálním zasílání zpráv? Podívejte se na stránku Připojení k zasílání zpráv.

Warning

Telefonní čísla musí odpovídat mezinárodnímu standardnímu formátu E.164 (například +14255550123). Musí <rom-messaging-connect-number> to být číslo připojení k zasílání zpráv nebo ID dynamického alfa odesílatele (například CONTOSO) už zřízené a synchronizované s vaším prostředkem služby ACS.

Parametr enableDeliveryReport je volitelný parametr, který můžete použít ke konfiguraci generování sestav doručení. Tato funkce je užitečná, když chcete generovat události při doručení zpráv SMS. V rychlém startu Zpracování událostí SMS nakonfigurujte hlášení doručení pro zprávy SMS. Pomocí parametru Tag můžete použít značku pro sestavu doručení.

Spuštění kódu

Spusťte aplikaci z adresáře aplikace pomocí dotnet run příkazu.

dotnet run

Ukázkový kód

Stažení ukázkové aplikace z GitHubu s ukázkami Azure Odešlete zprávu SMS pomocí .NET.

Začněte používat Azure Communication Services pomocí sady SMS SDK JavaScriptu komunikačních služeb k odesílání zpráv SMS.

Dokončení tohoto článku může na vašem účtu Azure způsobit malý náklad v řádu několika amerických centů nebo méně.

Note

Podívejte se na finální kód Ukázky Azure GitHub Odeslání SMS zprávy pomocí JavaScriptu.

Prerequisites

Kontrola předpokladů

  • V terminálu nebo příkazovém okně spusťte kontrolu node --version , jestli je nainstalovaná Node.js.
  • Pokud chcete zobrazit telefonní čísla přidružená k vašemu prostředku Komunikační služby, přihlaste se k webu Azure Portal a vyhledejte prostředek Komunikační služby. V navigačním podokně vlevo vyberte Telefonní čísla.

Nastavení aplikačního prostředí

Pokud chcete nastavit prostředí pro odesílání zpráv, proveďte kroky v následujících částech.

Vytvoření nové aplikace Node.js

  1. Otevřete terminál nebo příkazové okno a spuštěním následujícího příkazu vytvořte pro aplikaci nový adresář a přejděte na něj.

    mkdir sms-quickstart && cd sms-quickstart

  2. Spuštěním následujícího příkazu vytvořte souborpackage.json s výchozím nastavením.

    npm init -y

  3. Pomocí textového editoru vytvořte soubor s názvem send-sms.js v kořenovém adresáři projektu.

V následujících částech přidejte veškerý zdrojový kód pro tento rychlý start do send-sms.js souboru, který jste vytvořili.

Nainstalujte balíček .

npm install Pomocí příkazu nainstalujte sadu SDK SMS služby Azure Communication Services pro JavaScript.

npm install @azure/communication-sms --save

Možnost --save uvádí knihovnu jako závislost ve vašem souboru package.json.

Objektový model

Následující třídy a rozhraní zpracovávají některé z hlavních funkcí sady AZURE Communication Services SMS SDK pro Node.js.

Name Description
SmsClient Tato třída je nutná pro všechny funkce SMS. Vytvoříte instanci s informacemi o předplatném a použijete je k odesílání sms zpráv.
SmsSendRequest Toto rozhraní je model pro sestavení požadavku SMS. Používáte ho ke konfiguraci telefonních čísel a z telefonních čísel a obsahu SMS.
SmsSendOptions Toto rozhraní poskytuje možnosti konfigurace generování sestav doručení. Pokud enableDeliveryReport je nastavená hodnota true, při úspěšném doručení se vygeneruje událost.
SmsSendResult Tato třída obsahuje výsledek ze služby SMS.

Ověření klienta

Pokud chcete ověřit klienta, naimportujete SmsClient ze sady SDK a vytvoříte jeho instanci pomocí připojovacího řetězce. Připojovací řetězec prostředku můžete načíst z proměnné prostředí. Například kód v této části načte připojovací řetězec z COMMUNICATION_SERVICES_CONNECTION_STRING proměnné prostředí. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.

Import klienta a jeho vytvoření instance:

  1. Vytvořte soubor s názvem send-sms.js.

  2. Do send-sms.jspřidejte následující kód.

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

Odeslání zprávy SMS 1:N

Pokud chcete poslat sms zprávu do seznamu příjemců, zavolejte send funkci z SmsClient se seznamem telefonních čísel příjemců. Pokud chcete poslat zprávu jednomu příjemci, uveďte do seznamu jenom jedno číslo. Přidejte tento kód na konec send-sms.js:

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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <from-phone-number> telefonním číslem s podporou SMS spojeným s vaším prostředkem komunikačních služeb.
  • Nahraďte <to-phone-number-1> a <to-phone-number-2> telefonními čísly, na která chcete odeslat zprávu.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnota <from-phone-number> může být také krátký kód, například 23456 nebo ID alfanumerického odesílatele, například CONTOSO.

Odeslání zprávy SMS 1:N s možnostmi

Můžete také zadat objekt možností, který určuje, jestli má být zpráva o doručení povolená a zda má být nastavena vlastní značky.


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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <from-phone-number> telefonním číslem s podporou SMS spojeným s vaším prostředkem komunikačních služeb.
  • Nahraďte <to-phone-number-1> telefonní <to-phone-number-2> čísla, na která chcete poslat zprávu.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnota <from-phone-number> může být také krátký kód, například 23456 nebo ID alfanumerického odesílatele, například CONTOSO.

Parametr enableDeliveryReport je volitelný parametr, který můžete použít ke konfiguraci generování sestav doručení. Tato funkce je užitečná, když chcete generovat události při doručení zpráv SMS. V rychlém startu Zpracování událostí SMS nakonfigurujte hlášení doručení pro zprávy SMS. Parametr tag je volitelný. Můžete ho použít k použití značky na zprávu o doručení.

Globální odesílání SMS pomocí služby Messaging Connect

Important

Tato funkce služeb Azure Communication Services je aktuálně ve verzi Preview. Funkce ve verzi Preview jsou veřejně dostupné a můžou je používat všichni noví a stávající zákazníci Microsoftu.

API a sady SDK ve verzi Preview jsou poskytovány bez smlouvy o úrovni služeb. Doporučujeme je nepoužívat pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou být omezené.

Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Pokud používáte telefonní číslo zřízené prostřednictvím služby Messaging Connect, můžete zprávy SMS odesílat pomocí standardní sady JAVAScript SDK služby Azure Communication Services. Jediným rozdílem je, že musíte zahrnout messagingConnect objekt, abyste zadali název partnera a klíč rozhraní API.

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

Nahraďte tyto hodnoty:

  • <from-messaging-connect-number>: Telefonní číslo získané prostřednictvím služby Messaging Connect a propojené s vaším prostředkem služby ACS.
  • <to-phone-number-1> a <to-phone-number-2>: Telefonní čísla příjemce.
  • <partner-api-key>: Klíč rozhraní API od partnera služby Messaging Connect (například Infobip).

Tip

Chcete se dozvědět více o globálním zasílání zpráv? Podívejte se na stránku Připojení k zasílání zpráv.

Warning

Telefonní čísla musí odpovídat mezinárodnímu standardnímu formátu E.164 (například +14255550123). Musí <from-messaging-connect-number> to být číslo připojení k zasílání zpráv nebo ID dynamického alfa odesílatele (například CONTOSO) už zřízené a synchronizované s vaším prostředkem služby ACS.

Parametr enableDeliveryReport umožňuje konfigurovat reportování doručení. Parametr tag je volitelný a umožňuje použít vlastní značku pro zprávu o doručení. Informace o konfiguraci zasílání zpráv SMS najdete v rychlém startu Zpracování událostí SMS .

Spuštění kódu

node Pomocí příkazu spusťte kód, který jste přidali do souborusend-sms.js.


node ./send-sms.js

Začínáme se službou Azure Communication Services pomocí sady SDK SMS služby Communication Services pro odesílání zpráv SMS

Při dokončení tohoto rychlého zprovoznění vzniknou ve vašem účtu Azure náklady ve výši několika centů USD (nebo menší).

Note

Dokončený kód pro tento článek najdete v tématu Ukázky Azure na GitHubu Správa telefonních čísel pomocí Pythonu.

Prerequisites

Kontrola předpokladů

  • V terminálu nebo příkazovém okně spusťte python --version příkaz a zkontrolujte, jestli je Python nainstalovaný.
  • Pokud chcete zobrazit telefonní čísla přidružená k vašemu prostředku Komunikační služby, přihlaste se k webu Azure Portal a vyhledejte prostředek Komunikační služby. V navigačním podokně vlevo vyberte Telefonní čísla.

Nastavení aplikačního prostředí

Chcete-li nastavit prostředí pro odesílání zpráv, postupujte podle následujících částí.

Vytvoření nové aplikace v Pythonu

  1. Otevřete terminál nebo příkazové okno. Pomocí následujícího příkazu vytvořte nový adresář pro vaši aplikaci a přejděte do něj.

    mkdir sms-quickstart && cd sms-quickstart

  2. Pomocí textového editoru vytvořte soubor s názvem send-sms.py v kořenovém adresáři projektu a přidejte strukturu programu, včetně základního zpracování výjimek.

    import os
from azure.communication.sms import SmsClient

try:
    # Quickstart code goes here.
except Exception as ex:
    print('Exception:')
    print(ex)

V následujících částech přidejte veškerý zdrojový kód pro tento rychlý start do send-sms.py souboru, který jste vytvořili.

Nainstalujte balíček .

I když ještě v adresáři aplikace, pomocí následujícího příkazu nainstalujte sadu SDK SMS služby Azure Communication Services pro Python.

pip install azure-communication-sms

Objektový model

Následující třídy a rozhraní zpracovávají některé z hlavních funkcí sady AZURE Communication Services SMS SDK pro Python.

Name Description
SmsClient Tato třída je nutná pro všechny funkce SMS. Vytvořte instanci s informacemi o vašem předplatném a použijte ji k odesílání zpráv SMS.
SmsSendResult Tato třída obsahuje výsledek ze služby SMS.

Ověření klienta

Vytvořte instanci smsclient pomocí připojovacího řetězce. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku.

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

Pro zjednodušení tento průvodce rychlým startem používá připojovací řetězce, ale v produkčních prostředích doporučujeme používat service principals.

Odeslání zprávy SMS ve verzi 1:1

Pokud chcete odeslat sms zprávu jednomu příjemci, zavolejte send metodu z SmsClient s jedním telefonním číslem příjemce. Můžete také zadat volitelné parametry, které určují, jestli má být zpráva o doručení povolená, a nastavit vlastní značky. Přidejte tento kód na konec try bloku v 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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <from-phone-number> jej telefonním číslem podporujícím SMS spojeným s vaší komunikační službou.
  • Nahraďte <to-phone-number> telefonním číslem, na které chcete poslat zprávu.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnota <from-phone-number> může být také krátký kód, například 23456 nebo ID alfanumerického odesílatele, například CONTOSO.

Odeslání zprávy SMS 1:N

Pokud chcete poslat sms zprávu do seznamu příjemců, zavolejte send metodu z SmsClient se seznamem telefonních čísel příjemců. Můžete také zadat volitelné parametry, které určují, jestli má být zpráva o doručení povolená, a nastavit vlastní značky. Přidejte tento kód na konec try bloku v 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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <from-phone-number> jej telefonním číslem podporujícím SMS spojeným s vaší komunikační službou.
  • Nahraďte <to-phone-number-1> telefonní <to-phone-number-2> čísla, na která chcete poslat zprávu.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnotou for <from-phone-number> může být také krátký kód, například 23456 nebo alfanumerické ID odesílatele, například CONTOSO.

Volitelné parametry

Tento enable_delivery_report parametr je volitelný parametr, který můžete použít ke konfiguraci vykazování doručení. Tuto funkci použijte, pokud chcete generovat události při doručování SMS zpráv. V části Zpracování událostí SMS nakonfigurujte hlášení o doručení zpráv SMS.

Parametr tag je volitelný parametr, který můžete použít k použití značky v sestavě doručení.

Spuštění kódu

Spusťte aplikaci z adresáře aplikace pomocí python příkazu.

python send-sms.py

Kompletní skript Pythonu by měl vypadat přibližně takto:


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)

Začínáme se službou Azure Communication Services pomocí sady SDK SMS služby Communication Services k odesílání zpráv SMS.

Dokončení tohoto článku může na vašem účtu Azure způsobit malý náklad v řádu několika amerických centů nebo méně.

Note

Podívejte se na finální kód Ukázky Azure GitHub Odeslání SMS zprávy pomocí Javy.

Prerequisites

Kontrola předpokladů

  • V terminálu nebo příkazovém okně spusťte kontrolu mvn -v , jestli je maven nainstalovaný.
  • Pokud chcete zobrazit telefonní čísla přidružená k vašemu prostředku Komunikační služby, přihlaste se k webu Azure Portal a vyhledejte prostředek Komunikační služby. V navigačním podokně vlevo vyberte Telefonní čísla.

Nastavení aplikačního prostředí

Chcete-li nastavit prostředí pro odesílání zpráv, postupujte podle následujících částí.

Vytvoření nové aplikace v Javě

Otevřete terminál nebo příkazové okno a přejděte do adresáře, do kterého chcete vytvořit aplikaci v Javě. Pokud chcete vygenerovat projekt Java ze šablony rychlého startu maven-archetype-quickstart, spusťte následující příkaz.

  • Příkazový řádek
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"

Cíl generate vytvoří adresář se stejným názvem jako artifactId hodnota. Pod tímto adresářem adresář src/main/java obsahuje zdrojový kód projektu, adresář src/test/java obsahuje testovací zdroj a soubor pom.xml je modelem objektu projektu (POM).

Nainstalujte balíček .

Otevřete soubor pom.xml v textovém editoru. Do skupiny závislostí přidejte následující prvek závislosti.

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

Nastavení architektury aplikace

Otevřete /src/main/java/com/communication/quickstart/App.java v textovém editoru, přidejte příkazy importu a odstraňte příkaz 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.
    }
}

Objektový model

Následující třídy a rozhraní zpracovávají některé z hlavních funkcí sady AZURE Communication Services SMS SDK pro Javu.

Name Description
SmsClientBuilder Tato třída vytvoří SmsClient. Zadáte ho pomocí koncového bodu, přihlašovacích údajů a klienta HTTP.
SmsClient Tato třída je nutná pro všechny funkce SMS. Používáte ho k odesílání zpráv SMS.
SmsSendOptions Tato třída poskytuje možnosti pro přidání vlastních značek a konfiguraci generování sestav doručení. Pokud je vlastnost deliveryReportEnabled nastavena na hodnotu true, při úspěšném doručení se vygeneruje událost.
SmsSendResult Tato třída obsahuje výsledek ze služby SMS.

Ověření klienta

Pokud chcete ověřit klienta, vytvořte instanci SmsClient s připojovací řetězec. Pro přihlašovací údaje použijte z Key webu Azure Portal. Zjistěte, jak spravovat připojovací řetězec vašeho prostředku. Klienta můžete také inicializovat pomocí libovolného vlastního klienta HTTP, který implementuje com.azure.core.http.HttpClient rozhraní.

Pokud chcete vytvořit instanci klienta, přidejte do main metody následující kód:

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

Celou připojovací řetězec můžete také poskytnout pomocí connectionString funkce místo poskytnutí koncového bodu a přístupového klíče.

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

Odeslání zprávy SMS ve verzi 1:1

Pokud chcete odeslat sms zprávu jednomu příjemci, zavolejte send metodu z SmsClient s jedním telefonním číslem příjemce. Můžete také zadat volitelné parametry, které určují, jestli má být zpráva o doručení povolená, a nastavit vlastní značky.

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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <from-phone-number> telefonním číslem s podporou SMS spojeným s vaším prostředkem komunikačních služeb.
  • Nahraďte <to-phone-number> telefonním číslem, na které chcete poslat zprávu.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnotou for <from-phone-number> může být také krátký kód, například 23456 nebo alfanumerické ID odesílatele, například CONTOSO.

Odeslání zprávy SMS 1:N s možnostmi

Pokud chcete poslat sms zprávu do seznamu příjemců, zavolejte send metodu se seznamem telefonních čísel příjemců. Můžete také zadat volitelné parametry, které určují, jestli má být zpráva o doručení povolená, a nastavit vlastní značky.

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

Proveďte tyto nahrazení v kódu:

  • Nahraďte <from-phone-number> telefonním číslem s podporou SMS přidruženým k vašemu prostředku komunikačních služeb
  • Nahraďte <to-phone-number-1> telefonní <to-phone-number-2> čísla, na která chcete poslat zprávu.

Warning

Zadejte telefonní čísla v mezinárodním standardním formátu E.164, například +14255550123. Hodnota <from-phone-number> může být také krátký kód, například 23456 nebo ID alfanumerického odesílatele, například CONTOSO.

Metoda setDeliveryReportEnabled se používá ke konfiguraci generování sestav doručení. Tato funkce je užitečná, když chcete generovat události při doručení zpráv SMS. V rychlém startu Zpracování událostí SMS nakonfigurujte hlášení doručení pro zprávy SMS.

Chcete-li použít štítek na zprávu o doručení, použijte tuto setTag metodu.

Spuštění kódu

  1. Přejděte do adresáře, který obsahuje soubor pom.xml , a pomocí příkazu zkompilujte projekt mvn .

    
mvn compile

  2. Sestavte balíček.

    
mvn package

  3. Spuštěním následujícího mvn příkazu spusťte aplikaci.

    • Příkazový řádek
    
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"

Pomocí konektoru SMS Azure Communication Services a Azure Logic Apps můžete vytvářet automatizované pracovní postupy, které mohou odesílat zprávy SMS.

Tento článek popisuje, jak automaticky odesílat textové zprávy v reakci na spouštěcí událost, což je první krok v pracovním postupu aplikace logiky. Spouštěcí událostí může být příchozí e-mailová zpráva, plán opakování, událost prostředku Azure Event Grid nebo jakákoli jiná aktivační událost podporovaná službou Azure Logic Apps.

Snímek obrazovky, který ukazuje Azure Portal otevřený v návrháři aplikace logiky. Azure Portal ukazuje ukázkovou aplikaci logiky, která používá akci Odeslat SMS pro konektor Azure Communication Services.

Ačkoli se tento článek zaměřuje na použití konektoru k reakci na spouštěč, můžete konektor použít také k reakci na jiné akce, což jsou kroky, které následují po spouštěči v pracovním postupu. Pokud s Logic Apps začínáte, přečtěte si téma Co je Azure Logic Apps , než začnete.

Note

Dokončení tohoto článku může na vašem účtu Azure způsobit malý náklad v řádu několika amerických centů nebo méně.

Prerequisites

Important

Možnosti sms a veřejné telefonní sítě závisí na telefonním čísle, které používáte, a na zemi nebo oblasti, ve které pracujete podle fakturační adresy Azure. Další informace najdete v dokumentaci k způsobilosti k předplatnému .

Přidání akce SMS

Pokud chcete přidat akci Odeslat SMS jako nový krok v pracovním postupu pomocí konektoru SMS služby Azure Communication Services, postupujte podle těchto kroků na webu Azure Portal s pracovním postupem aplikace logiky otevřeným v Návrháři aplikace logiky:

  1. V návrháři v kroku, do kterého chcete přidat novou akci, vyberte Nový krok. Pokud chcete přidat novou akci mezi kroky, přesuňte ukazatel myši na šipku mezi těmito kroky, vyberte znaménko plus (+) a vyberte Přidat akci.

  2. Do vyhledávacího pole Zvolit operaci zadejte Azure Communication Services. V seznamu akcí vyberte Odeslat SMS.

    Snímek obrazovky znázorňující Návrhář aplikace logiky a konektor Azure Communication Services s vybranou akcí Odeslat SMS

  3. Teď vytvořte připojení k prostředku komunikační služby.

    1. Ve stejném předplatném:

      1. Zadejte název připojení.

      2. Vyberte prostředek služby Azure Communication Services.

      3. Vyberte Vytvořit.

      Snímek obrazovky znázorňující konfiguraci akce Odeslat SMS s ukázkovými informacemi

    2. Použití připojovací řetězec z prostředku služby Communication Services:

      1. Zadejte název připojení.

      2. V možnostech rozevíracího seznamu vyberte Ověřování ConnectionString.

      3. Zadejte připojovací řetězec prostředku komunikační služby.

      4. Vyberte Vytvořit.

      Snímek obrazovky znázorňující konfiguraci ověřování připojovacího řetězce

    3. Použití instančního objektu (odkaz na vytvoření instančního objektu):

      1. Zadejte název připojení.

      2. V možnostech rozevíracího seznamu vyberte Ověřování instančního objektu (aplikace Microsoft Entra).

      3. Zadejte ID tenanta, ID klienta a tajný klíč klienta vašeho instančního objektu.

      4. Zadejte hodnotu URL koncového bodu komunikační služby vašeho prostředku komunikační služby.

      5. Vyberte Vytvořit.

      Snímek obrazovky znázorňující konfiguraci ověřování instančního objektu

  4. V akci Odeslat SMS zadejte následující informace:

    • Zdrojová a cílová telefonní čísla. Pro účely testování můžete jako cílové telefonní číslo použít vlastní telefonní číslo.

    • Obsah zprávy, který chcete odeslat, například "Hello from Logic Apps!".

    Tady je akce Odeslat SMS s ukázkovými informacemi:

    Snímek obrazovky znázorňující akci Odeslat SMS s ukázkovými informacemi

  5. Jakmile budete hotovi, na panelu nástrojů návrháře vyberte Uložit.

Dále spusťte pracovní postup pro testování.

Otestování pracovního postupu

Pokud chcete pracovní postup spustit ručně, vyberte na panelu nástrojů návrháře Spustit. Nebo můžete počkat, až se trigger aktivuje. V obou případech by měl pracovní postup odeslat zprávu SMS na zadané cílové telefonní číslo. Další informace najdete v postupu spuštění pracovního postupu.

Vyčištění prostředků pracovního postupu

Pokud chcete vyčistit pracovní postup aplikace logiky a související prostředky, přečtěte si , jak vyčistit prostředky Logic Apps.

Troubleshooting

Pokud chcete řešit problémy související s doručováním sms, můžete povolit generování sestav doručení pomocí event Gridu , abyste zachytili podrobnosti o doručení.

Vyčištění prostředků

Pokud chcete vyčistit a odebrat předplatné služby Communication Services, můžete odstranit prostředek nebo skupinu prostředků. Odstraněním skupiny prostředků se odstraní také všechny ostatní prostředky, které jsou k ní přidružené. Přečtěte si další informace o čištění prostředků.

Ověření bezplatnou linkou

Pokud chcete použít nové bezplatné číslo pro odesílání sms zpráv, musíte dokončit proces ověření bezplatnou bezplatnou linkou. Pokyny k dokončení ověření čísla bezplatné linky najdete v rychlém startu pro odeslání bezplatného ověření. K posílání provozu SMS mají oprávnění pouze plně ověřená bezplatná čísla. Veškerý provoz SMS z neověřených bezplatných čísel směrovaných na telefonní čísla USA a CA jsou blokovaná.

Další kroky

Tento článek popisuje, jak odesílat zprávy SMS pomocí Azure Communication Services.

Příjem sms a odpovídání na zprávu SMS

Povolení analýzy SMS

Typy telefonních čísel

Vyhledání informací o operátorovi pro telefonní číslo

  • Last updated on