Partage via

Envoi d’un SMS

Important

Les fonctionnalités SMS dépendent du numéro de téléphone que vous utilisez et du pays / de la région dans lequel/laquelle vous travaillez, déterminé par votre adresse de facturation Azure. Pour plus d’informations, consultez l’éligibilité de l’abonnement.


Commencez avec Azure Communication Services en utilisant le module Communication dans Azure CLI pour envoyer des SMS.

Le fait d’effectuer les étapes de cet article entraîne un coût minime de quelques centimes de dollar USD ou moins sur votre compte Azure.

Prerequisites

Vérification du prérequis

  • Dans une fenêtre de terminal ou de commande, exécutez az --version pour vérifier qu’Azure CLI Maven est installé.

Configuration

Installer le module de communication

Pour installer le module de communication, exécutez la commande suivante dans un terminal ou une fenêtre de commande.

az extension add --name communication

Connectez-vous à Azure CLI

Connectez-vous à Azure CLI. Vous pouvez vous connecter en exécutant la commande az login à partir du terminal et fournir vos informations d’identification.

S’assurer de toujours utiliser l’abonnement approprié

Si vous avez plusieurs abonnements dans votre compte, assurez-vous que vous utilisez le bon abonnement pour ce tutoriel.

Dans un terminal ou des fenêtres de commande, exécutez la commande suivante pour vérifier l’abonnement actuel.

az account show

Si vous devez changer d’abonnement, vous pouvez le faire en exécutant la commande suivante.

az account set --subscription "<yourSubscriptionId>"

Vous devez remplacer <yourSubscriptionId> par votre ID d’abonnement réel, que vous pouvez trouver dans la section Abonnements du Portail Azure.

(Facultatif) Utiliser les opérations sms Azure CLI sans passer de chaîne de connexion

Vous pouvez configurer la variable d’environnement AZURE_COMMUNICATION_CONNECTION_STRING pour utiliser les opérations d’identité SMS d’Azure CLI sans avoir à utiliser --connection_string pour passer la chaîne de connexion. Pour configurer une variable d’environnement, ouvrez une fenêtre de console, puis sélectionnez votre système d’exploitation dans les onglets ci-dessous. Remplacez <yourConnectionString> par votre chaîne de connexion.

Ouvrez une fenêtre de console et entrez la commande suivante :

setx AZURE_COMMUNICATION_CONNECTION_STRING "<yourConnectionString>"

Après avoir ajouté la variable d’environnement, vous devrez peut-être redémarrer tous les programmes en cours d’exécution qui devront la lire, y compris la fenêtre de console. Par exemple, si vous utilisez Visual Studio comme éditeur, redémarrez Visual Studio avant d’exécuter l’exemple.

Operations

Envoyer un message SMS 1:1

Pour envoyer un message SMS à un seul destinataire, appelez la méthode send à partir du module SMS avec un seul numéro de téléphone de destinataire.

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

Apportez ces remplacements dans le code :

  • Remplacez <fromPhoneNumber> par un numéro de téléphone avec SMS associé à votre ressource Communication Services.
  • Remplacez <toPhoneNumber> par un numéro de téléphone auquel vous voulez envoyer un message.
  • Remplacez <yourConnectionString> par votre chaîne de connexion.

Warning

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123. La valeur de <fromPhoneNumber> peut également être un code court, par exemple, 23456 ou un ID d’expéditeur alphanumérique, par exemple CONTOSO.

Envoyer un message SMS 1:N

Pour envoyer un SMS à une liste de destinataires, appelez la méthode send à partir du module SMS avec plusieurs numéros de téléphone de destinataires.

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

Apportez ces remplacements dans le code :

  • Remplacez <fromPhoneNumber> par un numéro de téléphone avec SMS associé à votre ressource Communication Services.
  • Remplacez <toPhoneNumberN> par le numéro de téléphone auquel vous voulez envoyer un message.
  • Remplacez <yourConnectionString> par votre chaîne de connexion.

Warning

Fournissez des numéros de téléphone au format standard international E.164, tels que +14255550123. La valeur de <fromPhoneNumber> peut également être un code court, tel que 23456, ou un ID d’expéditeur alphanumérique, tel que CONTOSO.

Envoyer un sms avec DeliveryReport et tag

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

Le deliveryReport paramètre est un paramètre facultatif que vous pouvez utiliser pour configurer la création de rapports de remise. Utilisez cette fonction si vous souhaitez émettre des événements lorsque des sms sont remis. Consultez Gérer les événements SMS pour configurer la création de rapports de remise pour vos messages SMS.

Le paramètre tag est un paramètre facultatif que vous pouvez utiliser pour appliquer une balise au rapport de remise.

Apportez ces remplacements dans le code :

  • Remplacez <fromPhoneNumber> par un numéro de téléphone avec SMS associé à votre ressource Communication Services.
  • Remplacez <toPhoneNumber> par un numéro de téléphone auquel vous voulez envoyer un message.
  • Remplacez <yourConnectionString> par votre chaîne de connexion.
  • Remplacez par <yourCustomTag> votre balise personnalisée.

Warning

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123. La valeur de <fromPhoneNumber> peut également être un code court, par exemple, 23456 ou un ID d’expéditeur alphanumérique, par exemple CONTOSO.

Commencez avec Azure Communication Services en utilisant le kit de développement logiciel (SDK) Communication Services SMS C# pour envoyer des SMS.

Le fait d’effectuer les étapes de cet article entraîne un coût minime de quelques centimes de dollar USD ou moins sur votre compte Azure.

Note

Consultez le code finalisé sur Azure Samples GitHub Envoyer un sms à l’aide de .NET.

Prerequisites

Vérification du prérequis

  • Dans une fenêtre de terminal ou de commande, exécutez la commande dotnet pour vérifier que le kit de développement logiciel (SDK) .NET est installé.
  • Pour afficher les numéros de téléphone associés à votre ressource Communication Services, connectez-vous au portail Azure et recherchez votre ressource Communication Services. Dans le volet de navigation de gauche, sélectionnez Numéros de téléphone.

Configurer l’environnement d’application

Pour configurer un environnement afin d’envoyer des messages, effectuez les étapes décrites dans les sections suivantes.

Créer une application C#

  1. Dans une fenêtre de console (par exemple cmd, PowerShell ou Bash), utilisez la commande dotnet new pour créer une application console avec le nom SmsQuickstart. Cette commande crée un projet C# simple « Hello World » avec un fichier source unique, Program.cs.

    dotnet new console -o SmsQuickstart

  2. Remplacez votre répertoire par le dossier d’application que vous venez de créer, puis utilisez la commande dotnet build pour compiler votre application.

    cd SmsQuickstart
dotnet build

Installer le package

  1. Toujours dans le répertoire de l’application, installez le package SDK Azure Communication Services SMS pour .NET à l’aide de la commande suivante.

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

  2. Ajoutez une directive using en haut du fichier Program.cs pour inclure l’espace de noms Azure.Communication.

    
using System;
using System.Collections.Generic;

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

Modèle d'objet

Les classes et les interfaces suivantes gèrent certaines des principales fonctionnalités du kit de développement logiciel (SDK) Azure Communication Services SMS pour C#.

Name Description
SmsClient Cette classe est nécessaire pour toutes les fonctionnalités SMS. Vous l’instanciez avec vos informations d’abonnement et vous l’utilisez pour envoyer des SMS.
SmsSendOptions Cette classe fournit des options permettant de configurer la création de rapports de remise. Si enable_delivery_report a la valeur True, un événement est émis quand la remise a réussi.
SmsSendResult Cette classe contient le résultat du service SMS.

Authentifier le client

Ouvrez Program.cs dans un éditeur de texte, puis remplacez le corps de la méthode Main par du code permettant d’initialiser un SmsClient avec votre chaîne de connexion. Le code suivant récupère la chaîne de connexion de la ressource à partir d’une variable d’environnement nommée COMMUNICATION_SERVICES_CONNECTION_STRING. Découvrez comment gérer la chaîne de connexion de la ressource.

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

SmsClient smsClient = new SmsClient(connectionString);

Envoyer un message SMS 1:1

Pour envoyer un message SMS à un seul destinataire, appelez la fonction Send ou SendAsync à partir du SmsClient. Ajoutez ce code à la fin de la Main méthode dans 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}");

Apportez ces remplacements dans le code :

  • Remplacez <from-phone-number> par un numéro de téléphone avec SMS associé à votre ressource Communication Services.
  • Remplacez <to-phone-number> par le numéro de téléphone auquel vous voulez envoyer un message.

Warning

Fournissez des numéros de téléphone au format standard international E.164, tels que +14255550123. La valeur de <from-phone-number> peut également être un code court, tel que 23456, ou un ID d’expéditeur alphanumérique, tel que CONTOSO.

Envoyer un message SMS 1:N avec des options

Pour envoyer un SMS à une liste de destinataires, appelez la fonction Send ou SendAsync à partir du SmsClient avec une liste de numéros de téléphone de destinataire. Vous pouvez aussi fournir des paramètres facultatifs pour spécifier si le rapport de remise doit être activé et pour définir des balises personnalisées.

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

Apportez ces remplacements dans le code :

  • Remplacez <from-phone-number> par un numéro de téléphone avec SMS associé à votre ressource Communication Services.
  • Remplacez <to-phone-number-1> et <to-phone-number-2> par des numéros de téléphone auxquels vous voulez envoyer un message.

Warning

Fournissez des numéros de téléphone au format standard international E.164, tels que +14255550123. La valeur de <from-phone-number> peut également être un code court, tel que 23456, ou un ID d’expéditeur alphanumérique, tel que CONTOSO.

Le paramètre enableDeliveryReport est un paramètre facultatif que vous pouvez utiliser pour configurer la création de rapports de remise. Cette fonctionnalité s’avère utile pour émettre des événements quand des SMS sont remis. Consultez le guide de démarrage rapide Gérer les événements SMS pour configurer la création de rapports de remise pour vos SMS.

Vous pouvez utiliser le paramètre Tag pour appliquer une balise au rapport de remise.

Envoyer des SMS globalement avec Messaging Connect

Important

Cette fonctionnalité d’Azure Communication Services est actuellement en préversion. Les fonctionnalités en préversion sont disponibles publiquement et peuvent être utilisées par tous les clients Microsoft nouveaux et existants.

Ces interfaces de programmation d’applications et kits de développement logiciel (SDK) en préversion sont fournis sans contrat au niveau du service. Nous vous recommandons de ne pas les utiliser pour les charges de travail de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou les fonctionnalités peuvent être limitées.

Pour plus d’informations, consultez Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure.

Si vous utilisez un numéro de téléphone approvisionné via Messaging Connect, vous pouvez envoyer des sms à l’aide du Kit de développement logiciel (SDK) Azure Communication Services standard. La seule différence est que vous devez inclure l’objet pour spécifier le MessagingConnect nom du partenaire et la clé 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}");
}

Remplacez les valeurs suivantes :

  • <from-messaging-connect-number>: numéro de téléphone acquis via Messaging Connect et lié à votre ressource ACS.
  • <to-phone-number-1> et <to-phone-number-2>: Numéros de téléphone du destinataire.
  • <partner-api-key>: clé API de votre partenaire Messaging Connect (par exemple, Infobip).

Tip

Vous souhaitez en savoir plus sur la messagerie globale ? Consultez la page de Messaging Connect

Warning

Les numéros de téléphone doivent respecter le format standard international E.164 (par exemple, +14255550123). Le <rom-messaging-connect-number> doit être un numéro Messaging Connect ou un ID d’expéditeur alphanumérique dynamique (par exemple, CONTOSO) déjà approvisionné et synchronisé avec votre ressource ACS.

Le paramètre enableDeliveryReport est un paramètre facultatif que vous pouvez utiliser pour configurer la création de rapports de remise. Cette fonctionnalité s’avère utile pour émettre des événements quand des SMS sont remis. Consultez le guide de démarrage rapide Gérer les événements SMS pour configurer la création de rapports de remise pour vos SMS. Vous pouvez utiliser le paramètre Tag pour appliquer une balise au rapport de remise.

Exécuter le code

Exécutez l’application à partir de votre répertoire d’application avec la commande dotnet run.

dotnet run

Exemple de code

Téléchargez l’exemple d’application à partir d’Exemples Azure GitHub Envoyer un sms à l’aide de .NET.

Commencez avec Azure Communication Services en utilisant le SDK JavaScript SMS de Communication Services pour envoyer des SMS.

Le fait d’effectuer les étapes de cet article entraîne un coût minime de quelques centimes de dollar USD ou moins sur votre compte Azure.

Note

Consultez le code finalisé Azure Samples GitHub Envoyer un sms à l’aide de JavaScript.

Prerequisites

Vérification du prérequis

  • Dans une fenêtre de terminal ou de commande, exécutez node --version pour vérifier que Node.js est installé.
  • Pour afficher les numéros de téléphone associés à votre ressource Communication Services, connectez-vous au portail Azure et recherchez votre ressource Communication Services. Dans le volet de navigation de gauche, sélectionnez Numéros de téléphone.

Configurer l’environnement d’application

Pour configurer un environnement afin d’envoyer des messages, effectuez les étapes décrites dans les sections suivantes.

Création d’une application Node.js

  1. Ouvrez votre fenêtre de terminal ou de commande, puis exécutez la commande suivante pour créer un répertoire pour votre application et accédez-y.

    mkdir sms-quickstart && cd sms-quickstart

  2. Exécutez la commande suivante pour créer un fichier package.json avec les paramètres par défaut.

    npm init -y

  3. Utilisez un éditeur de texte pour créer un fichier appelé send-sms.js dans le répertoire racine du projet.

Dans les sections suivantes, ajoutez tout le code source de ce guide de démarrage rapide au fichier send-sms.js que vous avez créé.

Installer le package

Utilisez la commande npm install pour installer le kit de développement logiciel (SDK) Azure Communication Services SMS pour JavaScript.

npm install @azure/communication-sms --save

L’option --save liste la bibliothèque comme dépendance dans votre fichier package.json.

Modèle d'objet

Les classes et les interfaces suivantes gèrent certaines des principales fonctionnalités du kit de développement logiciel (SDK) Azure Communication Services SMS pour Node.js.

Name Description
SmsClient Cette classe est nécessaire pour toutes les fonctionnalités SMS. Vous l’instanciez avec vos informations d’abonnement et vous l’utilisez pour envoyer des SMS.
SmsSendRequest Cette interface est le modèle de génération de la demande par SMS. Utilisez-la pour configurer les numéros de téléphone d’origine et de destination, ainsi que le contenu du SMS.
SmsSendOptions Cette interface fournit des options permettant de configurer la création de rapports de remise. Si enableDeliveryReport a la valeur true, un événement est émis quand la remise a réussi.
SmsSendResult Cette classe contient le résultat du service SMS.

Authentifier le client

Pour authentifier un client, vous importez smsClient à partir du Kit de développement logiciel (SDK) et instanciez-le avec votre chaîne de connexion. Vous pouvez récupérer la chaîne de connexion de la ressource à partir d’une variable d’environnement. Par exemple, le code indiqué dans cette section récupère la chaîne de connexion à partir de la variable d’environnement COMMUNICATION_SERVICES_CONNECTION_STRING. Découvrez comment gérer la chaîne de connexion de la ressource.

Pour importer le client et l’instancier :

  1. Créez un fichier nommé send-sms.js.

  2. Ajoutez le code suivant à 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);

Envoyer un message SMS 1:N

Pour envoyer un SMS à une liste de destinataires, appelez la fonction send à partir du SmsClient avec une liste de numéros de téléphone de destinataire. Si vous voulez envoyer un message à un seul destinataire, incluez un seul numéro dans la liste. Ajoutez ce code à la fin de 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();

Apportez ces remplacements dans le code :

  • Remplacez <from-phone-number> par un numéro de téléphone avec SMS associé à votre ressource Communication Services.
  • Remplacez <to-phone-number-1> et <to-phone-number-2> par les numéros de téléphone auxquels vous souhaitez envoyer un message.

Warning

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123. La valeur de <from-phone-number> peut également être un code court, par exemple, 23456 ou un ID d’expéditeur alphanumérique, par exemple CONTOSO.

Envoyer un message SMS 1:N avec des options

Vous pouvez aussi fournir un objet d’options pour spécifier si le rapport de remise doit être activé et pour définir des balises personnalisées.


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

Apportez ces remplacements dans le code :

  • Remplacez <from-phone-number> par un numéro de téléphone avec SMS associé à votre ressource Communication Services.
  • Remplacez <to-phone-number-1> et <to-phone-number-2> par des numéros de téléphone auxquels vous voulez envoyer un message.

Warning

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123. La valeur de <from-phone-number> peut également être un code court, par exemple, 23456 ou un ID d’expéditeur alphanumérique, par exemple CONTOSO.

Le paramètre enableDeliveryReport est un paramètre facultatif que vous pouvez utiliser pour configurer la création de rapports de remise. Cette fonctionnalité s’avère utile pour émettre des événements quand des SMS sont remis. Consultez le guide de démarrage rapide Gérer les événements SMS pour configurer la création de rapports de remise pour vos SMS. Le paramètre tag est facultatif. Vous pouvez l’utiliser pour appliquer une balise au rapport de remise.

Envoyer des SMS globalement avec Messaging Connect

Important

Cette fonctionnalité d’Azure Communication Services est actuellement en préversion. Les fonctionnalités en préversion sont disponibles publiquement et peuvent être utilisées par tous les clients Microsoft nouveaux et existants.

Ces interfaces de programmation d’applications et kits de développement logiciel (SDK) en préversion sont fournis sans contrat au niveau du service. Nous vous recommandons de ne pas les utiliser pour les charges de travail de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou les fonctionnalités peuvent être limitées.

Pour plus d’informations, consultez Conditions d’utilisation supplémentaires pour les préversions de Microsoft Azure.

Si vous utilisez un numéro de téléphone approvisionné via Messaging Connect, vous pouvez envoyer des sms à l’aide du Kit de développement logiciel (SDK) JavaScript Azure Communication Services standard. La seule différence est que vous devez inclure l’objet pour spécifier le messagingConnect nom du partenaire et la clé 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();

Remplacez les valeurs suivantes :

  • <from-messaging-connect-number>: numéro de téléphone acquis via Messaging Connect et lié à votre ressource ACS.
  • <to-phone-number-1> et <to-phone-number-2>: Numéros de téléphone du destinataire.
  • <partner-api-key>: clé API de votre partenaire Messaging Connect (par exemple, Infobip).

Tip

Vous souhaitez en savoir plus sur la messagerie globale ? Consultez la page de Messaging Connect

Warning

Les numéros de téléphone doivent respecter le format standard international E.164 (par exemple, +14255550123). Le <from-messaging-connect-number> doit être un numéro Messaging Connect ou un ID d’expéditeur alphanumérique dynamique (par exemple, CONTOSO) déjà approvisionné et synchronisé avec votre ressource ACS.

Le enableDeliveryReport paramètre vous permet de configurer le rapport de remise. Le tag paramètre est facultatif et vous permet d’appliquer une balise personnalisée au rapport de remise. Pour configurer la création de rapports de remise SMS, consultez le guide de démarrage rapide Gérer les événements SMS .

Exécuter le code

Utilisez la node commande pour exécuter le code que vous avez ajouté au fichier send-sms.js .


node ./send-sms.js

Commencez avec Azure Communication Services en utilisant le kit de développement logiciel (SDK) Communication Services SMS Python pour envoyer des SMS.

Le fait de suivre ce guide de démarrage rapide entraîne une petite dépense de quelques cents USD tout au plus dans votre compte Azure.

Note

Pour obtenir le code finalisé de cet article, consultez GitHub Azure Samples Manage phone numbers using Python( Gérer les numéros de téléphone à l’aide de Python).

Prerequisites

Vérification du prérequis

  • Dans une fenêtre de terminal ou de commande, exécutez la commande python --version pour vérifier que Python est installé.
  • Pour afficher les numéros de téléphone associés à votre ressource Communication Services, connectez-vous au portail Azure et recherchez votre ressource Communication Services. Dans le volet de navigation de gauche, sélectionnez Numéros de téléphone.

Configurer l’environnement d’application

Pour configurer un environnement pour l’envoi de messages, suivez les sections suivantes.

Créer une application Python

  1. Ouvrez votre fenêtre de terminal ou de commande. Utilisez la commande suivante pour créer un répertoire pour votre application et y accéder.

    mkdir sms-quickstart && cd sms-quickstart

  2. Utilisez un éditeur de texte pour créer un fichier appelé send-sms.py dans le répertoire racine du projet et ajouter la structure du programme, y compris la gestion des exceptions de base.

    import os
from azure.communication.sms import SmsClient

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

Dans les sections suivantes, ajoutez tout le code source de ce guide de démarrage rapide au fichier send-sms.py que vous avez créé.

Installer le package

Toujours dans le répertoire de l’application, installez le package SDK Azure Communication Services SMS pour Python à l’aide de la commande suivante.

pip install azure-communication-sms

Modèle d'objet

Les classes et les interfaces suivantes gèrent certaines des principales fonctionnalités du kit de développement logiciel (SDK) Azure Communication Services SMS pour Python.

Name Description
SmsClient Cette classe est nécessaire pour toutes les fonctionnalités SMS. Instanciez-le avec vos informations d’abonnement et utilisez-le pour envoyer des sms.
SmsSendResult Cette classe contient le résultat du service SMS.

Authentifier le client

Instanciez un SmsClient avec votre chaîne de connexion. Découvrez comment gérer la chaîne de connexion de la ressource.

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

Par souci de simplicité, ce guide de démarrage rapide utilise des chaînes de connexion, mais, dans des environnements de production, nous recommandons l’utilisation de principaux de service.

Envoyer un message SMS 1:1

Pour envoyer un sms à un seul destinataire, appelez la send méthode à partir du SmsClient avec un numéro de téléphone de destinataire unique. Vous pouvez aussi fournir des paramètres facultatifs pour spécifier si le rapport de remise doit être activé et pour définir des balises personnalisées. Ajoutez ce code à la fin du try bloc dans 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

Apportez ces remplacements dans le code :

  • Remplacez <from-phone-number> par un numéro de téléphone activé par SMS associé à votre service de communication.
  • Remplacez <to-phone-number> par le numéro de téléphone auquel vous voulez envoyer un message.

Warning

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123. La valeur de <from-phone-number> peut également être un code court, par exemple, 23456 ou un ID d’expéditeur alphanumérique, par exemple CONTOSO.

Envoyer un message SMS 1:N

Pour envoyer un sms à une liste de destinataires, appelez la send méthode à partir de SmsClient avec une liste de numéros de téléphone de destinataire. Vous pouvez aussi fournir des paramètres facultatifs pour spécifier si le rapport de remise doit être activé et pour définir des balises personnalisées. Ajoutez ce code à la fin du try bloc dans 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

Apportez ces remplacements dans le code :

  • Remplacez <from-phone-number> par un numéro de téléphone activé par SMS associé à votre service de communication.
  • Remplacez <to-phone-number-1> et <to-phone-number-2> par des numéros de téléphone auxquels vous voulez envoyer un message.

Warning

Fournissez des numéros de téléphone au format standard international E.164, tels que +14255550123. La valeur de <from-phone-number> peut également être un code court, tel que 23456, ou un ID d’expéditeur alphanumérique, tel que CONTOSO.

Paramètres facultatifs

Le enable_delivery_report paramètre est un paramètre facultatif que vous pouvez utiliser pour configurer la création de rapports de remise. Utilisez cette fonction si vous souhaitez émettre des événements lorsque des sms sont remis. Consultez Gérer les événements SMS pour configurer la création de rapports de remise pour vos messages SMS.

Le paramètre tag est un paramètre facultatif que vous pouvez utiliser pour appliquer une balise au rapport de remise.

Exécuter le code

Exécutez l’application à partir de votre répertoire d’application avec la commande python.

python send-sms.py

Le script Python complet doit ressembler au code suivant :


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)

Commencez avec Azure Communication Services en utilisant le kit de développement logiciel (SDK) Communication Services SMS Java pour envoyer des SMS.

Le fait d’effectuer les étapes de cet article entraîne un coût minime de quelques centimes de dollar USD ou moins sur votre compte Azure.

Note

Consultez le code finalisé Azure Samples GitHub Envoyer un sms à l’aide de Java.

Prerequisites

Vérification du prérequis

  • Dans une fenêtre de terminal ou de commande, exécutez mvn -v pour vérifier que Maven est installé.
  • Pour afficher les numéros de téléphone associés à votre ressource Communication Services, connectez-vous au portail Azure et recherchez votre ressource Communication Services. Dans le volet de navigation de gauche, sélectionnez Numéros de téléphone.

Configurer l’environnement d’application

Pour configurer un environnement pour l’envoi de messages, suivez les sections suivantes.

Créer une application Java

Ouvrez une fenêtre de terminal ou une fenêtre Commande, puis accédez au répertoire dans lequel vous souhaitez créer votre application Java. Pour générer le projet Java à partir du modèle de démarrage rapide maven-archetype-quickstart, exécutez la commande suivante.

  • Invite de commandes
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"

L’objectif generate crée un répertoire qui porte le même nom que la valeur artifactId. Sous ce répertoire, le répertoire src/main/java contient le code source du projet, le répertoire src/test/java contient la source de test et le fichier pom.xml est le modèle objet du projet (POM, Project Object Model).

Installer le package

Ouvrez le fichier pom.xml dans votre éditeur de texte. Ajoutez l’élément dépendance suivant au groupe de dépendances.

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

Configurer le framework d’application

Ouvrez /src/main/java/com/communication/quickstart/App.java dans un éditeur de texte, ajoutez des directives d’importation, puis supprimez l’instruction 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.
    }
}

Modèle d'objet

Les classes et les interfaces suivantes gèrent certaines des principales fonctionnalités du kit de développement logiciel (SDK) Azure Communication Services SMS pour Java.

Name Description
SmsClientBuilder Cette classe crée le SmsClient. Vous lui fournissez un point de terminaison, des informations d’identification et un client HTTP.
SmsClient Cette classe est nécessaire pour toutes les fonctionnalités SMS. Vous l’utilisez pour envoyer des SMS.
SmsSendOptions Cette classe fournit des options pour ajouter des balises personnalisées et configurer la remise de rapports. Si deliveryReportEnabled a la valeur true, un événement est émis quand la remise a réussi.
SmsSendResult Cette classe contient le résultat du service SMS.

Authentifier le client

Pour authentifier un client, vous instanciez un SmsClient avec votre chaîne de connexion. Pour les informations d’identification, utilisez la Key à partir du portail Azure. Découvrez comment gérer la chaîne de connexion de la ressource. Vous pouvez aussi initialiser le client avec n’importe quel client HTTP personnalisé qui implémente l’interface com.azure.core.http.HttpClient.

Pour instancier un client, ajoutez le code suivant à la méthode main :

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

Vous pouvez aussi fournir la chaîne de connexion entière à l’aide de la fonction connectionString au lieu de fournir le point de terminaison et la clé d’accès.

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

Envoyer un message SMS 1:1

Pour envoyer un message SMS à un seul destinataire, appelez la méthode send à partir du SmsClient avec un numéro de téléphone de destinataire unique. Vous pouvez aussi fournir des paramètres facultatifs pour spécifier si le rapport de remise doit être activé et pour définir des balises personnalisées.

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

Apportez ces remplacements dans le code :

  • Remplacez <from-phone-number> par un numéro de téléphone avec SMS associé à votre ressource Communication Services.
  • Remplacez <to-phone-number> par un numéro de téléphone auquel vous voulez envoyer un message.

Warning

Fournissez des numéros de téléphone au format standard international E.164, tels que +14255550123. La valeur de <from-phone-number> peut également être un code court, tel que 23456, ou un ID d’expéditeur alphanumérique, tel que CONTOSO.

Envoyer un message SMS 1:N avec des options

Pour envoyer un message SMS à une liste de destinataires, appelez la méthode send avec une liste de numéros de téléphone de destinataire. Vous pouvez aussi fournir des paramètres facultatifs pour spécifier si le rapport de remise doit être activé et pour définir des balises personnalisées.

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

Apportez ces remplacements dans le code :

  • Remplacer <from-phone-number> par un numéro de téléphone activé par SMS associé à votre ressource Communication Services
  • Remplacez <to-phone-number-1> et <to-phone-number-2> par des numéros de téléphone auxquels vous voulez envoyer un message.

Warning

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123. La valeur de <from-phone-number> peut également être un code court, par exemple, 23456 ou un ID d’expéditeur alphanumérique, par exemple CONTOSO.

La méthode setDeliveryReportEnabled est utilisée pour configurer la création de rapports de remise. Cette fonctionnalité s’avère utile pour émettre des événements quand des SMS sont remis. Consultez le guide de démarrage rapide Gérer les événements SMS pour configurer la création de rapports de remise pour vos SMS.

Pour appliquer une balise au rapport de remise, utilisez la setTag méthode.

Exécuter le code

  1. Accédez au répertoire qui contient le fichier pom.xml et compilez le projet à l’aide de la mvn commande.

    
mvn compile

  2. Générez le package.

    
mvn package

  3. Exécutez la commande mvn suivante pour exécuter l’application.

    • Invite de commandes
    
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"

Utilisez le connecteur SMS Azure Communication Services et Azure Logic Apps pour créer des flux de travail automatisés qui peuvent envoyer des sms.

Cet article explique comment envoyer automatiquement des messages texte en réponse à un événement déclencheur, qui est la première étape d’un flux de travail d’application logique. Un événement déclencheur peut être un message électronique entrant, une planification de périodicité, un événement de ressource Azure Event Grid ou tout autre déclencheur pris en charge par Azure Logic Apps.

Capture d’écran montrant le portail Azure ouvert au Concepteur d’application logique. Le portail Azure affiche un exemple d’application logique qui utilise l’action Envoyer SMS pour le connecteur Azure Communication Services.

Bien que cet article se concentre sur l’utilisation du connecteur pour répondre à un déclencheur, vous pouvez également utiliser le connecteur pour répondre à d’autres actions, qui sont les étapes qui suivent le déclencheur dans un flux de travail. Si vous débutez avec Logic Apps, consultez Présentation d’Azure Logic Apps avant de commencer.

Note

Le fait d’effectuer les étapes de cet article entraîne un coût minime de quelques centimes de dollar USD ou moins sur votre compte Azure.

Prerequisites

Important

Les fonctionnalités SMS et RTC dépendent du numéro de téléphone que vous utilisez et du pays/région dans lequel vous opérez, comme déterminé par votre adresse de facturation Azure. Pour plus d’informations, consultez la documentation d’éligibilité de l’abonnement .

Ajouter une action SMS

Pour ajouter l’action Envoyer sms en tant que nouvelle étape de votre flux de travail à l’aide du connecteur SMS Azure Communication Services, suivez ces étapes dans le portail Azure avec votre flux de travail d’application logique ouvert dans le Concepteur d’applications logiques :

  1. Dans le concepteur, sous l’étape à laquelle vous souhaitez ajouter la nouvelle action, sélectionnez Nouvelle étape. Vous pouvez également ajouter la nouvelle action entre des étapes, déplacer votre pointeur sur la flèche située entre ces étapes, sélectionner le signe plus (+), puis sélectionner Ajouter une action.

  2. Dans la zone de recherche Choisir une opération, entrez Azure Communication Services. Dans la liste des actions, sélectionnez Envoyer des SMS.

    Capture d’écran montrant le concepteur d’application logique et le connecteur Azure Communication Services avec l’action Envoyer un SMS sélectionnée.

  3. Créez maintenant une connexion à votre ressource Communication Services.

    1. Au sein du même abonnement :

      1. Entrez un nom pour la connexion.

      2. Sélectionnez votre ressource Azure Communication Services.

      3. Cliquez sur Créer.

      Capture d’écran montrant la configuration de l’action Envoyer un SMS avec des exemples d’informations.

    2. En utilisant la chaîne de connexion de votre ressource Communication Services :

      1. Entrez un nom pour la connexion.

      2. Sélectionnez Authentification par ConnectionString dans les options du menu déroulant.

      3. Entrez la chaîne de connexion de votre ressource Communication Services.

      4. Cliquez sur Créer.

      Capture d’écran montrant la configuration de l’authentification Connection String.

    3. En utilisant le principal de service (Voir la création de principaux de service) :

      1. Entrez un nom pour la connexion.

      2. Sélectionnez Authentification par principal de service (application Microsoft Entra) dans les options du menu déroulant.

      3. Entrez l’ID du locataire, l’ID du client et la clé secrète client de votre principal de service.

      4. Entrez l’URL du point de terminaison Communication Services de votre ressource Communication Services.

      5. Cliquez sur Créer.

      Capture d’écran montrant la configuration d’Authentification par principal de service.

  4. Dans l’action Envoyer un SMS , fournissez les informations suivantes :

    • Numéros de téléphone source et de destination. À des fins de test, vous pouvez utiliser votre propre numéro de téléphone comme numéro de téléphone de destination.

    • Contenu du message que vous souhaitez envoyer, par exemple, « Hello from Logic Apps ! ».

    Voici une action Envoyer un SMS avec des exemples d’informations :

    Capture d’écran montrant l’action Envoyer un SMS avec des exemples d’informations.

  5. Lorsque c’est chose faite, dans la barre d’outils du concepteur, sélectionnez Enregistrer.

Ensuite, exécutez votre flux de travail à des fins de test.

Tester votre workflow

Pour lancer manuellement votre workflow, sélectionnez Exécuter dans la barre d’outils du concepteur. Sinon, vous pouvez attendre que le déclencheur se mette en œuvre. Dans les deux cas, le workflow doit envoyer un SMS au numéro de téléphone de destination que vous avez spécifié. Pour plus d’informations, consultez Exécuter votre workflow.

Nettoyer des ressources de flux de travail

Pour nettoyer le workflow de votre application logique et les ressources associées, consultez les instructions permettant de nettoyer des ressources Logic Apps.

Troubleshooting

Pour résoudre les problèmes liés à la remise de SMS, vous pouvez activer la création de rapports de remise avec Event Grid pour capturer les détails de remise.

Nettoyer les ressources

Si vous voulez nettoyer et supprimer un abonnement Communication Services, vous pouvez supprimer la ressource ou le groupe de ressources. La suppression du groupe de ressources efface également les autres ressources qui y sont associées. Apprenez-en davantage sur le nettoyage des ressources.

Vérification gratuite

Pour utiliser un nouveau numéro gratuit pour l’envoi de SMS, vous devez vous soumettre à un processus de vérification du numéro gratuit. Pour obtenir des conseils sur la façon de vérifier votre numéro gratuit, consultez le guide de démarrage rapide pour demander la vérification d’un numéro gratuit. Seuls les numéros gratuits entièrement vérifiés sont autorisés à envoyer du trafic SMS. Tout trafic SMS provenant de numéros gratuits non vérifiés à destination de numéros de téléphone aux États-Unis et au Canada est bloqué.

Étapes suivantes

Cet article a décrit comment envoyer des sms à l’aide d’Azure Communication Services.

Recevoir et répondre à des SMS

Activer l’analyse SMS

Types de numéros de téléphone

Rechercher des informations sur l'opérateur pour un numéro de téléphone

  • Last updated on