Skicka ett SMS-meddelande

Kom igång med Azure Communication Services med hjälp av kommunikationsmodulen i Azure CLI för att skicka SMS.

Att slutföra den här artikeln medför en liten kostnad på några USD cent eller mindre i ditt Azure-konto.

Prerequisites

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto kostnadsfritt.
• En aktiv Communication Services-resurs och anslutningssträng. Skapa en resurs för Communication Services.
• Ett SMS-aktiverat telefonnummer, kort kod eller alfanumeriskt avsändar-ID. Hämta ett telefonnummer.
• Den senaste Azure CLI-versionen för ditt operativsystem.

Förutsättningskontroll

• I ett terminal- eller kommandofönster kör du az --version för att kontrollera att Azure CLI är installerat.

Förbereda

Installera kommunikationsmodulen

Om du vill installera kommunikationsmodulen kör du följande kommando i en terminal eller ett kommandofönster.

az extension add --name communication

Logga in på Azure CLI

Du måste logga in på Azure CLI. Du kan logga in med az login kommandot från terminalen och ange dina autentiseringsuppgifter.

Kontrollera att du använder rätt prenumeration

Om du har flera prenumerationer på ditt konto kontrollerar du att du använder rätt prenumeration för den här självstudien.

I en terminal eller kommandofönster kör du följande kommando för att kontrollera den aktuella prenumerationen.

az account show

Om du behöver ändra prenumerationen kan du göra det genom att köra följande kommando.

az account set --subscription "<yourSubscriptionId>"

Du måste ersätta <yourSubscriptionId> med ditt faktiska prenumerations-ID, som du hittar i avsnittet Prenumerationer i Azure Portal.

(Valfritt) Använda Azure CLI-sms-åtgärder utan att skicka in en anslutningssträng

Du kan konfigurera AZURE_COMMUNICATION_CONNECTION_STRING miljövariabeln så att den använder Azure CLI-sms-åtgärder utan att behöva använda --connection_string för att skicka in anslutningssträng. Om du vill konfigurera en miljövariabel öppnar du ett konsolfönster och väljer ditt operativsystem på flikarna nedan. Ersätt <yourConnectionString> med din faktiska anslutningssträng.

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

export AZURE_COMMUNICATION_CONNECTION_STRING="<yourConnectionString>"

Operations

Skicka ett 1:1 SMS-meddelande

Om du vill skicka ett SMS till en enskild mottagare anropar send du metoden från sms-modulen med ett enda mottagartelefonnummer.

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

Gör följande ersättningar i koden:

• Ersätt <fromPhoneNumber> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs.
• Ersätt <toPhoneNumber> med ett telefonnummer som du vill skicka ett meddelande till.
• Ersätt <yourConnectionString> med din anslutningssträng.

Skicka ett 1:N SMS-meddelande

Om du vill skicka ett SMS till en lista över mottagare anropar send du metoden från sms-modulen med flera mottagartelefonnummer.

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

Gör följande ersättningar i koden:

• Ersätt <fromPhoneNumber> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs.
• Ersätt <toPhoneNumberN> med det N:e telefonnummer som du vill skicka ett meddelande till.
• Ersätt <yourConnectionString> med din anslutningssträng.

Skicka ett SMS med DeliveryReport och tagg

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

Parametern deliveryReport är en valfri parameter som du kan använda för att konfigurera leveransrapportering. Använd den här funktionen om du vill generera händelser när SMS levereras. Se Hantera SMS-händelser för att konfigurera leveransrapportering för dina SMS-meddelanden.

Parametern tag är en valfri parameter som du kan använda för att tillämpa en tagg på leveransrapporten.

Gör följande ersättningar i koden:

• Ersätt <fromPhoneNumber> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs.
• Ersätt <toPhoneNumber> med ett telefonnummer som du vill skicka ett meddelande till.
• Ersätt <yourConnectionString> med din anslutningssträng.
• Ersätt <yourCustomTag> med din anpassade tagg.

Kom igång med Azure Communication Services med hjälp av Communication Services C# SMS SDK för att skicka SMS.

Att slutföra den här artikeln medför en liten kostnad på några USD cent eller mindre i ditt Azure-konto.

Prerequisites

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto kostnadsfritt.
• Den senaste versionen av .NET Core SDK för ditt operativsystem.
• En aktiv Communication Services-resurs och anslutningssträng. Skapa en resurs för Communication Services.
• Ett SMS-aktiverat telefonnummer, kort kod eller alfanumeriskt avsändar-ID. Hämta ett telefonnummer.

Förutsättningskontroll

• I ett terminal- eller kommandofönster kör du dotnet kommandot för att kontrollera att .NET SDK är installerat.
• Om du vill visa de telefonnummer som är associerade med din Communication Services-resurs loggar du in på Azure-portalen och letar reda på din Communication Services-resurs. I navigeringsfönstret till vänster väljer du Telefonnummer.

Konfigurera programmiljön

Utför stegen i följande avsnitt för att konfigurera en miljö för att skicka meddelanden.

Skapa ett nytt C#-program

1. I ett konsolfönster, till exempel cmd, PowerShell eller Bash, använder du dotnet new kommandot för att skapa en ny konsolapp med namnet SmsQuickstart. Det här kommandot skapar ett enkelt "Hello World" C#-projekt med en enda källfil , Program.cs.

   dotnet new console -o SmsQuickstart
   

2. Ändra katalogen till den nyligen skapade appmappen dotnet build och använd kommandot för att kompilera programmet.

   cd SmsQuickstart
   dotnet build
   

Installera -paketet

1. Installera AZURE Communication Services SMS SDK för .NET-paketet med hjälp av följande kommando medan du fortfarande är i programkatalogen.

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

2. Lägg till ett using direktiv överst i Program.cs för att inkludera Azure.Communication namnområdet.

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

Objektmodell

Följande klasser och gränssnitt hanterar några av de viktigaste funktionerna i Azure Communication Services SMS SDK för C#.

Autentisera klienten

Öppna Program.cs i en textredigerare och ersätt metodens Main brödtext med kod för att initiera en SmsClient med din anslutningssträng. Följande kod hämtar anslutningssträng för resursen från en miljövariabel med namnet COMMUNICATION_SERVICES_CONNECTION_STRING. Lär dig hur du hanterar resursens anslutningssträng.

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

SmsClient smsClient = new SmsClient(connectionString);

Skicka ett 1:1 SMS-meddelande

Om du vill skicka ett SMS till en enskild mottagare anropar Send du funktionen eller SendAsync från SmsClient. Lägg till den här koden i slutet av Main metoden i 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}");

Gör följande ersättningar i koden:

• Ersätt <from-phone-number> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs.
• Ersätt <to-phone-number> med det telefonnummer som du vill skicka ett meddelande till.

Skicka ett 1:N SMS-meddelande med alternativ

Om du vill skicka ett SMS till en lista över mottagare anropar Send du funktionen eller SendAsync från SmsClient med en lista över mottagartelefonnummer. Du kan också ange valfria parametrar för att ange om leveransrapporten ska vara aktiverad och för att ange anpassade taggar.

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

Gör följande ersättningar i koden:

• Ersätt <from-phone-number> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs.
• Ersätt <to-phone-number-1> och <to-phone-number-2> med telefonnummer som du vill skicka ett meddelande till.

Parametern enableDeliveryReport är en valfri parameter som du kan använda för att konfigurera leveransrapportering. Den här funktionen är användbar när du vill generera händelser när SMS levereras. Se snabbstarten Hantera SMS-händelser för att konfigurera leveransrapportering för dina SMS.

Du kan använda parametern Tag för att tillämpa en tagg på leveransrapporten.

Skicka SMS globalt med Messaging Connect

Om du använder ett telefonnummer som etablerats via Messaging Connect kan du skicka SMS med standard-SDK:et för Azure Communication Services. Den enda skillnaden är att du måste inkludera MessagingConnect objektet för att ange partnernamnet och API-nyckeln.

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

Ersätt dessa värden:

• <from-messaging-connect-number>: Telefonnumret som hämtas via Messaging Connect och som är länkat till din ACS-resurs.
• <to-phone-number-1> och <to-phone-number-2>: Mottagarens telefonnummer.
• <partner-api-key>: API-nyckeln från din Messaging Connect-partner (t.ex. Infobip).

Parametern enableDeliveryReport är en valfri parameter som du kan använda för att konfigurera leveransrapportering. Den här funktionen är användbar när du vill generera händelser när SMS levereras. Se snabbstarten Hantera SMS-händelser för att konfigurera leveransrapportering för dina SMS. Du kan använda parametern Tag för att tillämpa en tagg på leveransrapporten.

Kör koden

Kör programmet från programkatalogen dotnet run med kommandot .

dotnet run

Exempelkod

Ladda ned exempelappen från Azure Samples GitHub Skicka ett SMS med hjälp av .NET.

Kom igång med Azure Communication Services med hjälp av Communication Services JavaScript SMS SDK för att skicka SMS.

Att slutföra den här artikeln medför en liten kostnad på några USD cent eller mindre i ditt Azure-konto.

Prerequisites

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto kostnadsfritt.
• Node.js Aktiva LTS- och underhålls-LTS-versioner (8.11.1 och 10.14.1 rekommenderas).
• En aktiv Communication Services-resurs och anslutningssträng. Skapa en resurs för Communication Services.
• Ett SMS-aktiverat telefonnummer, kort kod eller alfanumeriskt avsändar-ID. Hämta ett telefonnummer.

Förutsättningskontroll

• I ett terminal- eller kommandofönster kör du node --version för att kontrollera att Node.js är installerat.
• Om du vill visa de telefonnummer som är associerade med din Communication Services-resurs loggar du in på Azure-portalen och letar reda på din Communication Services-resurs. I navigeringsfönstret till vänster väljer du Telefonnummer.

Konfigurera programmiljön

Utför stegen i följande avsnitt för att konfigurera en miljö för att skicka meddelanden.

Skapa ett nytt Node.js-program

1. Öppna terminalen eller kommandofönstret och kör sedan följande kommando för att skapa en ny katalog för din app och navigera till den.

   mkdir sms-quickstart && cd sms-quickstart
   

2. Kör följande kommando för att skapa en package.json fil med standardinställningar.

   npm init -y
   

3. Använd en textredigerare för att skapa en fil med namnet send-sms.js i projektets rotkatalog.

I följande avsnitt lägger du till all källkod för den här snabbstarten i densend-sms.js fil som du skapade.

Installera -paketet

npm install Använd kommandot för att installera SMS SDK för Azure Communication Services för JavaScript.

npm install @azure/communication-sms --save

Alternativet --save visar biblioteket som ett beroende i dinpackage.json-fil .

Objektmodell

Följande klasser och gränssnitt hanterar några av de viktigaste funktionerna i Azure Communication Services SMS SDK för Node.js.

Autentisera klienten

Om du vill autentisera en klient importerar du SmsClient från SDK:n och instansierar den med anslutningssträngen. Du kan hämta anslutningssträng för resursen från en miljövariabel. Koden i det här avsnittet hämtar till exempel anslutningssträng från COMMUNICATION_SERVICES_CONNECTION_STRING miljövariabeln. Lär dig hur du hanterar resursens anslutningssträng.

Så här importerar du klienten och instansierar den:

1. Skapa en fil med namnet send-sms.js.

2. Lägg till följande kod i 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);

Skicka ett 1:N SMS-meddelande

Om du vill skicka ett SMS till en lista över mottagare anropar send du funktionen från SmsClient med en lista över mottagartelefonnummer. Om du vill skicka ett meddelande till en enskild mottagare ska du bara inkludera ett nummer i listan. Lägg till den här koden i slutet av 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();

Gör följande ersättningar i koden:

• Ersätt <from-phone-number> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs.
• Ersätt <to-phone-number-1> och <to-phone-number-2> med de telefonnummer som du vill skicka ett meddelande till.

Skicka ett 1:N SMS-meddelande med alternativ

Du kan också ange ett alternativobjekt för att ange om leveransrapporten ska vara aktiverad och för att ange anpassade taggar.

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

Gör följande ersättningar i koden:

• Ersätt <from-phone-number> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs.
• Ersätt <to-phone-number-1> och <to-phone-number-2> med telefonnummer som du vill skicka ett meddelande till.

Parametern enableDeliveryReport är en valfri parameter som du kan använda för att konfigurera leveransrapportering. Den här funktionen är användbar när du vill generera händelser när SMS levereras. Se snabbstarten Hantera SMS-händelser för att konfigurera leveransrapportering för dina SMS. Parametern tag är valfri. Du kan använda den för att tillämpa en tagg på leveransrapporten.

Skicka SMS globalt med Messaging Connect

Om du använder ett telefonnummer som etablerats via Messaging Connect kan du skicka SMS med hjälp av Standard Azure Communication Services JavaScript SDK. Den enda skillnaden är att du måste inkludera messagingConnect objektet för att ange partnernamnet och API-nyckeln.

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

Ersätt dessa värden:

• <from-messaging-connect-number>: Telefonnumret som hämtas via Messaging Connect och som är länkat till din ACS-resurs.
• <to-phone-number-1> och <to-phone-number-2>: Mottagarens telefonnummer.
• <partner-api-key>: API-nyckeln från din Messaging Connect-partner (till exempel Infobip).

Med parametern enableDeliveryReport kan du konfigurera leveransrapportering. Parametern tag är valfri och gör att du kan använda en anpassad tagg i leveransrapporten. Information om hur du konfigurerar SMS-leveransrapportering finns i snabbstarten Hantera SMS-händelser .

Kör koden

node Använd kommandot för att köra koden som du lade till i filensend-sms.js.

node ./send-sms.js

Kom igång med Azure Communication Services med hjälp av Communication Services Python SMS SDK för att skicka SMS.

Slutförande av den här snabbstarten medför en liten kostnad på några USD-cent eller mindre på ditt Azure-konto.

Prerequisites

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto kostnadsfritt.
• Python 3.7+.
• En aktiv Communication Services-resurs och anslutningssträng. Skapa en resurs för Communication Services.
• Ett SMS-aktiverat telefonnummer, kort kod eller alfanumeriskt avsändar-ID. Hämta ett telefonnummer.

Förutsättningskontroll

• I ett terminal- eller kommandofönster kör du python --version kommandot för att kontrollera att Python är installerat.
• Om du vill visa de telefonnummer som är associerade med din Communication Services-resurs loggar du in på Azure-portalen och letar reda på din Communication Services-resurs. I navigeringsfönstret till vänster väljer du Telefonnummer.

Konfigurera programmiljön

Om du vill konfigurera en miljö för att skicka meddelanden slutför du följande avsnitt.

Skapa ett nytt Python-program

1. Öppna terminalen eller kommandofönstret. Använd följande kommando för att skapa en ny katalog för din app och navigera till den.

   mkdir sms-quickstart && cd sms-quickstart
   

2. Använd en textredigerare för att skapa en fil med namnet send-sms.py i projektets rotkatalog och lägga till strukturen för programmet, inklusive grundläggande undantagshantering.

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

I följande avsnitt lägger du till all källkod för den här snabbstarten i den send-sms.py fil som du skapade.

Installera -paketet

Installera SMS SDK för Azure Communication Services för Python-paketet i programkatalogen med hjälp av följande kommando.

pip install azure-communication-sms

Objektmodell

Följande klasser och gränssnitt hanterar några av de viktigaste funktionerna i Azure Communication Services SMS SDK för Python.

Autentisera klienten

Börja med att instansiera en SmsClient med din anslutningssträng. Lär dig hur du hanterar resursens anslutningssträng.

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

För enkelhetens skull använder den här snabbstarten anslutningssträngar, men i produktionsmiljöer rekommenderar vi att du använder tjänstens huvudnamn.

Skicka ett 1:1 SMS-meddelande

Om du vill skicka ett SMS till en enskild mottagare anropar send du metoden från SmsClient med ett enda mottagartelefonnummer. Du kan också ange valfria parametrar för att ange om leveransrapporten ska vara aktiverad och för att ange anpassade taggar. Lägg till den här koden i slutet av try blocket i 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

Gör följande ersättningar i koden:

• Ersätt <from-phone-number> med ett SMS-aktiverat telefonnummer som är kopplat till kommunikationstjänsten.
• Ersätt <to-phone-number> med det telefonnummer som du vill skicka ett meddelande till.

Skicka ett 1:N SMS-meddelande

Om du vill skicka ett SMS till en lista över mottagare anropar send du metoden från SmsClient med en lista över mottagartelefonnummer. Du kan också ange valfria parametrar för att ange om leveransrapporten ska vara aktiverad och för att ange anpassade taggar. Lägg till den här koden i slutet av try blocket i 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

Gör följande ersättningar i koden:

• Ersätt <from-phone-number> med ett SMS-aktiverat telefonnummer som är kopplat till kommunikationstjänsten.
• Ersätt <to-phone-number-1> och <to-phone-number-2> med telefonnummer som du vill skicka ett meddelande till.

Valfria parametrar

Parametern enable_delivery_report är en valfri parameter som du kan använda för att konfigurera leveransrapportering. Använd den här funktionen om du vill generera händelser när SMS levereras. Se Hantera SMS-händelser för att konfigurera leveransrapportering för dina SMS-meddelanden.

Parametern tag är en valfri parameter som du kan använda för att tillämpa en tagg på leveransrapporten.

Kör koden

Kör programmet från programkatalogen python med kommandot .

python send-sms.py

Det fullständiga Python-skriptet bör se ut ungefär så här:

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)

Kom igång med Azure Communication Services med hjälp av Communication Services Java SMS SDK för att skicka SMS.

Att slutföra den här artikeln medför en liten kostnad på några USD cent eller mindre i ditt Azure-konto.

Prerequisites

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto kostnadsfritt.
• Java Development Kit (JDK) version 8 eller senare.
• Apache Maven.
• En aktiv Communication Services-resurs och anslutningssträng. Skapa en resurs för Communication Services.
• Ett SMS-aktiverat telefonnummer, kort kod eller alfanumeriskt avsändar-ID. Hämta ett telefonnummer.

Förutsättningskontroll

• I ett terminal- eller kommandofönster kör du mvn -v för att kontrollera att Maven är installerat.
• Om du vill visa de telefonnummer som är associerade med din Communication Services-resurs loggar du in på Azure-portalen och letar reda på din Communication Services-resurs. I navigeringsfönstret till vänster väljer du Telefonnummer.

Konfigurera programmiljön

Om du vill konfigurera en miljö för att skicka meddelanden slutför du följande avsnitt.

Skapa ett nytt Java-program

Öppna ett terminal- eller kommandofönster och navigera till katalogen där du vill skapa java-programmet. Kör följande kommando för att generera Java-projektet från mallen maven-archetype-quickstart.

• Kommandotolk

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"

Målet generate skapar en katalog med samma namn som värdet artifactId . Under den här katalogen innehåller katalogen src/main/java projektets källkod, katalogen src/test/java innehåller testkällan och filen pom.xml är projektets projektobjektmodell (POM).

Installera -paketet

Öppna filen pom.xml i textredigeraren. Lägg till följande beroendeelement i gruppen med beroenden.

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

Konfigurera appramverket

Öppna /src/main/java/com/communication/quickstart/App.java i en textredigerare, lägg till importdirektiv och ta bort instruktionen 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.
    }
}

Objektmodell

Följande klasser och gränssnitt hanterar några av de viktigaste funktionerna i Azure Communication Services SMS SDK för Java.

Autentisera klienten

Om du vill autentisera en klient instansierar du en SmsClient med din anslutningssträng. För autentiseringsuppgifterna använder du Key från Azure Portal. Lär dig hur du hanterar resursens anslutningssträng. Du kan också initiera klienten med en anpassad HTTP-klient som implementerar com.azure.core.http.HttpClient gränssnittet.

Om du vill instansiera en klient lägger du till följande kod i main metoden:

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

Du kan också ange hela anslutningssträng med hjälp connectionString av funktionen i stället för att ange slutpunkten och åtkomstnyckeln.

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

Skicka ett 1:1 SMS-meddelande

Om du vill skicka ett SMS till en enskild mottagare anropar send du metoden från SmsClient med ett enda mottagartelefonnummer. Du kan också ange valfria parametrar för att ange om leveransrapporten ska vara aktiverad och för att ange anpassade taggar.

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

Gör följande ersättningar i koden:

• Ersätt <from-phone-number> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs.
• Ersätt <to-phone-number> med ett telefonnummer som du vill skicka ett meddelande till.

Skicka ett 1:N SMS-meddelande med alternativ

Om du vill skicka ett SMS till en lista över mottagare anropar send du metoden med en lista över mottagartelefonnummer. Du kan också ange valfria parametrar för att ange om leveransrapporten ska vara aktiverad och för att ange anpassade taggar.

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

Gör följande ersättningar i koden:

• Ersätt <from-phone-number> med ett SMS-aktiverat telefonnummer som är associerat med din Communication Services-resurs
• Ersätt <to-phone-number-1> och <to-phone-number-2> med telefonnummer som du vill skicka ett meddelande till.

Metoden setDeliveryReportEnabled används för att konfigurera leveransrapportering. Den här funktionen är användbar när du vill generera händelser när SMS levereras. Se snabbstarten Hantera SMS-händelser för att konfigurera leveransrapportering för dina SMS.

Använd setTag-metoden för att applicera en tagg på leveransrapporten.

Kör koden

1. Navigera till katalogen som innehåller pom.xml-filen och kompilera projektet med hjälp av mvn kommandot .

   
   mvn compile
   
   

2. Skapa paketet.

   
   mvn package
   
   

3. Kör följande mvn kommando för att köra appen.

   • Kommandotolk

   
   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"
   

Använd SMS-anslutningsappen för Azure Communication Services och Azure Logic Apps för att skapa automatiserade arbetsflöden som kan skicka SMS.

Den här artikeln beskriver hur du automatiskt skickar textmeddelanden som svar på en utlösarhändelse, vilket är det första steget i ett logikapparbetsflöde. En utlösarhändelse kan vara ett inkommande e-postmeddelande, ett upprepningsschema, en Azure Event Grid-resurshändelse eller någon annan utlösare som stöds av Azure Logic Apps.

Även om den här artikeln fokuserar på att använda anslutningsappen för att svara på en utlösare, kan du också använda anslutningsappen för att svara på andra åtgärder, vilket är de steg som följer utlösaren i ett arbetsflöde. Om du inte har använt Logic Apps tidigare kan du läsa Vad är Azure Logic Apps innan du kommer igång?

Prerequisites

• Ett Azure-konto med en aktiv prenumeration eller skapa ett Azure-konto kostnadsfritt.

• En aktiv Azure Communication Services-resurs eller skapa en Communication Services-resurs.

• En aktiv Logic Apps-resurs (logikapp) eller skapa en tom logikapp med den utlösare du vill använda. För närvarande tillhandahåller SMS-anslutningsappen för Azure Communication Services endast åtgärder, så logikappen kräver minst en utlösare.

  Den här snabbstarten använder utlösaren När ett nytt e-postmeddelande tas emot , som är tillgängligt med Office 365 Outlook-anslutningsappen.

• Ett SMS-aktiverat telefonnummer, kort kod eller alfanumeriskt avsändar-ID. Hämta ett telefonnummer.

Lägga till en SMS-åtgärd

Om du vill lägga till åtgärden Skicka SMS som ett nytt steg i arbetsflödet med hjälp av SMS-anslutningsappen för Azure Communication Services följer du dessa steg i Azure-portalen med logikappens arbetsflöde öppet i Logikappdesignern:

1. I designern går du till steget där du vill lägga till den nya åtgärden och väljer Nytt steg. Du kan också lägga till den nya åtgärden mellan stegen genom att flytta pekaren över pilen mellan dessa steg, välja plustecknet (+) och välja Lägg till en åtgärd.

2. I sökrutan Välj en åtgärd anger du Azure Communication Services. I åtgärdslistan väljer du Skicka SMS.

   

3. Skapa nu en anslutning till din Communication Services-resurs.

   1. Inom samma prenumeration:

      1. Ange ett namn för anslutningen.

      2. Välj din Azure Communication Services-resurs.

      3. Välj Skapa.

      

   2. Använda anslutningssträng från din Communication Services-resurs:

      1. Ange ett namn för anslutningen.

      2. Välj ConnectionString Authentication (Anslutningssträngsautentisering) i listrutan.

      3. Ange anslutningssträng för din Communication Services-resurs.

      4. Välj Skapa.

      

   3. Använda tjänstens huvudnamn (se Skapande av tjänstens huvudnamn):

      1. Ange ett namn för anslutningen.

      2. Välj Tjänstens huvudnamn (Microsoft Entra-program) Autentisering i listrutan.

      3. Ange klientorganisations-ID, klient-ID och klienthemlighet för tjänstens huvudnamn.

      4. Ange url-värdet för Slutpunkts-URL för Communication Services för din Communication Services-resurs.

      5. Välj Skapa.

      

4. I åtgärden Skicka SMS anger du följande information:

   • Käll- och måltelefonnumren. I testsyfte kan du använda ditt eget telefonnummer som måltelefonnummer.

   • Det meddelandeinnehåll som du vill skicka, till exempel "Hello from Logic Apps!".

   Här är en skicka SMS-åtgärd med exempelinformation:

   

5. När du är klar klickar du på tabelldesignern Spara på kommandofältet.

Kör sedan arbetsflödet för testning.

Testa arbetsflödet

Om du vill starta arbetsflödet manuellt går du till verktygsfältet designer och väljer Kör. Eller så kan du vänta tills utlösaren utlöses. I båda fallen bör arbetsflödet skicka ett SMS till ditt angivna måltelefonnummer. Mer information finns i hur du kör arbetsflödet.

Rensa arbetsflödesresurser

Om du vill rensa logikappens arbetsflöde och relaterade resurser kan du läsa om hur du rensar Logic Apps-resurser.