Connexion à la messagerie

Introduction

Bienvenue dans Messaging Connect, une nouvelle façon de fournir un service sms (Short Message Service) à l’échelle mondiale avec Azure Communication Services. Il intègre des partenaires approuvés afin de pouvoir louer des numéros et répondre aux exigences réglementaires locales tout en continuant à utiliser les services Azure Communication Services familiers : point de terminaison d’API unique, observabilité forte et intégration approfondie entre les services Microsoft. Que vous envoyiez des rappels de rendez-vous, des confirmations de réservation ou des invites Copilot intelligentes, Messaging Connect vous aide à atteindre les utilisateurs globalement avec moins de complexité.

Au lieu de créer et de gérer des intégrations distinctes avec plusieurs fournisseurs, vous vous connectez une fois par le biais d’Azure Communication Services et routez le trafic vers des partenaires globaux. Le partenaire gère la location de numéros et la conformité. Les workflows de messagerie, d’observabilité et d’IA restent dans votre environnement Azure où vous créez, surveillez et mettez à l’échelle.

Valeur en un clin d’œil :

• Portée mondiale dans 190 pays

• Conformité locale et approvisionnement plus rapide via des partenaires

• Accessibilité simple des API/SDK Azure Communication Services, des diagnostics et de l'observabilité Event Grid

• Séparation des tâches : Microsoft fournit la plateforme de développement ; partenaires fournissent et approvisionnent des numéros

Vue d’ensemble conceptuelle

Les SMS globaux sont intrinsèquement complexes : les réglementations diffèrent selon le pays, les types d’expéditeurs varient et les itinéraires de livraison sont fragmentés. Messaging Connect intègre des partenaires pré-approuvés pour vous permettre d’acquérir des identités d’expéditeur conformes et de router le trafic sans quitter l’expérience des développeurs Azure Communication Services.

Flux d’approvisionnement (haut niveau) :

1. Dans le portail Azure, ouvrez le blade Messaging Connect

2. Sélectionnez votre partenaire Messaging Connect.

3. Vous êtes redirigé vers le portail du partenaire pour acheter/configurer des numéros de téléphone compatibles SMS, effectuer toutes les inscriptions requises et attendre l’approbation.

4. Le partenaire synchronise les numéros approuvés vers votre ressource Azure Communication Services.

5. Le nombre apparaît dans le portail Azure et est prêt à être utilisé avec les API SMS Azure Communication Services.

Vous pouvez envoyer et recevoir des SMS à l’aide des API SMS Azure Communication Services standard. Lorsque vous envoyez des messages, vous vous authentifiez auprès d’Azure comme d’habitude et incluez une clé de votre partenaire Messaging Connect au moment de l’exécution afin que nous puissions acheminer votre trafic de manière appropriée. Le partenaire gère la remise des messages, tandis que l’observabilité, comme les reçus de remise, les diagnostics et la journalisation, reste dans Azure avec vos autres services.

Ce modèle fonctionne bien dans les scénarios réels. Vous pouvez utiliser Messaging Connect pour atteindre les utilisateurs dans le monde entier, que vous construisiez un assistant alimenté par l’IA avec Copilot Studio, gère la logistique qui nécessite des ID d’expéditeurs locaux au Brésil et en Inde, ou que vous coordonnez des campagnes dans des dizaines de pays. Azure Communication Services, via Messaging Connect, vous permet d’acquérir les identités d’expéditeur appropriées par le biais d’un partenaire approuvé et de les utiliser avec votre SDK SMS Azure Communication Services préféré, tout en conservant un contrôle total et une observabilité dans Azure.

Capabilities

Le tableau suivant récapitule les fonctionnalités disponibles lors de l’utilisation de Messaging Connect pendant la préversion publique. Certaines fonctionnalités sont fournies directement par Azure, d’autres par les partenaires Messaging Connect.

🌐 Disponibilité du pays

Messaging Connect étend considérablement le nombre de pays auxquels vous pouvez accéder avec Azure Communication Services, qui prend en charge plus de 190 pays par le biais de notre réseau partenaire mondial. Pendant la préversion publique, vous pouvez acquérir et utiliser deux types d’identités d’expéditeur à partir du partenaire Messaging Connect :

• Codes longs : numéros de téléphone locaux standard ou numéros mobiles qui prennent en charge les SMS bidirectionnels. Souvent appelés codes longs virtuels.
• ID d’expéditeur alphanumérique dynamique – Expéditeurs unidirectionnels et de marque (par exemple, « CONTOSO »), quand cela est permis. Vous pouvez activer DASID uniquement dans les pays non pris en charge par Azure Communication Services.

Lorsque vous recherchez un pays et un type de numéro dans le portail Azure, vous disposez de Messaging Connect en tant qu’option si Azure Communication Services ne prend pas en charge cette configuration directement. Vous terminez ensuite le processus d’approvisionnement via le portail du partenaire.

Le partenaire Messaging Connect détermine la disponibilité du pays. Le partenaire Messaging Connect (par exemple, Infobip) gère les types de nombres, les exigences de conformité et les étapes d’intégration, qui varient selon le pays.

Authentification : Accès sécurisé avec l’identité Azure

Pour envoyer des messages via Messaging Connect, votre application doit s’authentifier auprès d’Azure Communication Services à l’aide de l’un des modèles d’identité pris en charge. Cette étape vérifie que votre application dispose de l’autorisation d’envoyer des messages via votre ressource Azure Communication Services et garantit que vos messages sont associés à l’abonnement Azure approprié.

Azure Communication Services prend en charge les méthodes d’authentification suivantes :

• Authentification par clé d’accès (chaînes de connexion)
• Authentification Microsoft Entra ID

Vous vous authentifiez auprès d’Azure Communication Services de la même façon que pour toute autre demande SMS. Messaging Connect ne modifie pas le fonctionnement de l’authentification au niveau de la plateforme. Il ajoute simplement une étape de routage basée sur les partenaires une fois votre message validé.

En savoir plus : S’authentifier auprès d’Azure Communication Services

Une fois authentifiée, votre application inclut également une clé API partenaire au moment de l’exécution pour acheminer le message via le partenaire Messaging Connect approprié. Cette clé API partenaire fait partie de la charge utile du message et est expliquée plus loin dans la section suivante.

Comment Messaging Connect valide vos demandes

Avant qu’un message puisse être envoyé à l’aide de Messaging Connect, Azure vérifie que votre demande contient les informations de routage nécessaires et est correctement authentifiée. Pour effectuer cette étape, votre charge utile doit inclure des métadonnées spécifiques qui identifient le partenaire Messaging Connect et permettent à Azure Communication Services d’acheminer le message via leur infrastructure.

Format de charge utile obligatoire

Lorsque vous envoyez un message à l’aide d’un numéro de connexion de messagerie, votre demande doit inclure un messagingConnect objet. Cet objet contient la clé API fournie par le partenaire Messaging Connect (par exemple, Infobip) et le nom du partenaire. Azure utilise ces informations pour autoriser la demande et déterminer comment acheminer le message.

{
  "from": "+447700900123",
  "to": ["+447700900456"],
  "message": "Hello from Messaging Connect!",
  "options": {
    "messagingConnect": {
      "apiKey": "your-partner-api-key",
      "partner": "[PARTNER NAME]"
    }
  }
}

L’objet messagingConnect est requis chaque fois que vous utilisez un nombre approvisionné via Messaging Connect. S’il est manquant ou mal configuré, Azure Communication Services rejette le message. Une fois ces métadonnées incluses, Azure Communication Services effectue des vérifications de validation en deux étapes : tout d’abord, Azure Communication Services valide votre demande dès qu’elle est reçue, puis à nouveau après l’avoir envoyée au partenaire.

Validation synchrone

Cette première couche de validation se produit dès qu’Azure Communication Services reçoit votre demande de message. Si un élément est manquant ou non valide, tel que le nom du partenaire, la clé API ou l’association entre le numéro et votre ressource Azure Communication Services, vous recevez une réponse d’erreur immédiate. Cette vérification empêche l’envoi de messages incorrects ou routés vers le partenaire incorrect.

Résultats de validation courants :

Ces erreurs retournent de manière synchrone dans votre réponse d’API et apparaissent également dans les journaux et diagnostics Azure.

Erreurs de remise asynchrones

Même si votre demande passe la validation synchrone, Azure Communication Services peut toujours ne pas le transmettre au partenaire Messaging Connect. Dans certains cas, Azure Communication Services arrête le message avant la remise, par exemple, si le destinataire a précédemment refusé ou s’il existe un blocage de livraison connu de la part du partenaire. Ces situations entraînent toujours un rapport de remise, de sorte que vous êtes toujours informé du résultat du message. Une fois qu’un message est transmis au partenaire, tous les échecs de remise en aval( comme le nombre inaccessible, la période de validité expirée ou le rejet au niveau du transporteur) sont également retournés de façon asynchrone via les rapports de remise. Vous pouvez afficher les états de remise dans vos rapports de remise à partir d’événements Azure Event Grid (s’ils sont configurés).

En savoir plus : Rapports de transmission sur les événements Azure Event Grid

Accès global avec messagerie sécurisée et conforme

Messaging Connect est conçu pour une utilisation mondiale, que vous utilisiez à partir de l’Asie, de l’Afrique, de l’Amérique du Sud ou de l’Union européenne. Cette section explique comment les données circulent entre les régions, comment la confidentialité est conservée et comment Azure garantit la conformité aux exigences de résidence.

Routage des messages et flux de données

Messaging Connect sépare la remise des messages (gérée par le partenaire) du traitement et de l’observabilité (gérée par Azure). Fonctionnement :

• Messages sortants : vous envoyez un SMS à l’aide de l’API Azure Communication Services et incluez les informations de routage des partenaires via messagingConnect l’objet. Azure enregistre le message, effectue la validation, puis l’achemine vers le partenaire Messaging Connect sélectionné.
• Messages entrants : le partenaire reçoit le SMS et le transfère à l’infrastructure d’Azure. À partir de là, Azure Communication Services gère le message comme tout message envoyé à des numéros natifs Azure Communication Services, ce qui déclenche des événements via Event Grid.

Bien que le partenaire gère la livraison, Azure fournit :

• Reçus de livraison et observabilité
• API et Kits de développement logiciel (SDK) Azure Communication Services standard
• Traitement temporaire des messages uniquement : aucun contenu de message n’est stocké

Azure Communication Services ne conserve pas le contenu du message SMS après la remise ou l’échec. Les messages et les métadonnées sont traités temporairement en mémoire uniquement si nécessaire pour le routage et les diagnostics.

En savoir plus : Résidence des données et confidentialité des utilisateurs

Limite de données de l’UE (EUDB)

Azure Communication Services garantit que les données SMS dans le cadre de l’EUDB sont stockées dans les régions EUDB. À compter d’aujourd’hui, nous traitons et stockons des données aux Pays-Bas, en Irlande ou en Suisse, en s’assurant qu’aucun transfert de données non autorisé n’est en dehors de l’EEE (Espace économique européen). En outre, Azure Communication Services utilise des mesures de sécurité avancées, notamment le chiffrement, pour protéger les données SMS au repos et en transit. Les clients peuvent sélectionner leur résidence de données préférée au sein de la BASE de données de l’UE, en vous assurant que les données restent dans les régions de l’UE désignées.

En savoir plus : Limite de données de l’Union européenne (EUDB)

Utilisation de Messaging Connect à partir de n’importe où

Messaging Connect est conçu pour une utilisation globale. Une fois que vous avez acquis un numéro via un partenaire Messaging Connect, vous l’intégrez à votre application à l’aide d’API Azure Communication Services, quel que soit l’emplacement où il est hébergé. Toutefois, certains pays appliquent des règles de télécommunication locales sur l’utilisation des numéros, les types de contenu autorisés ou les exigences d’origine du trafic. Le partenaire Messaging Connect gère ces exigences pendant le processus d’approvisionnement de numéros. Le partenaire, et non Azure Communication Services, optimise les itinéraires de livraison. Selon le type de nombre, les règles locales et la configuration du partenaire, les messages peuvent être acheminés via une infrastructure locale ou régionale.

Gestion des refus

La conformité de l’opt-out et de l’opt-in est une partie essentielle de la messagerie SMS, en particulier sur les marchés réglementés. Avec Messaging Connect, cette responsabilité est partagée entre vous (le client), le partenaire (par exemple, Infobip) et Microsoft, chacun jouant un rôle distinct.

Responsabilités clés

• Le partenaire (par exemple, Infobip) prend en charge la détection des mots clés d’opt-out et d’opt-in tels que « STOP » ou « START », mais le comportement n’est pas automatique.

• Les messages de confirmation tels que « vous êtes désinscrit » ne sont pas envoyés par défaut. Si vous le souhaitez, vous devez les configurer explicitement avec le partenaire ou les implémenter dans votre propre application.
• Vous, le client, sont responsables de la conformité de votre expérience de messagerie aux réglementations locales, notamment la gestion des refus, la configuration des mots clés et la gestion du consentement de l’utilisateur final.
• Azure Communication Services ne traite pas les mots clés d’exclusion ou n’envoie aucune réponse automatisée. Toutefois, Microsoft gère un ensemble de mots-clés d'exclusion prédéfinis pour l’observabilité.

Qu’est-ce qu’Azure Communication Services fait ?

Par défaut, Azure Communication Services détecte les mots clés d’annulation/sortie standard : START et UNSTOP sont reconnus comme des déclencheurs Opt-In, tandis que STOP, ARRET, QUIT, END, REVOKE, OPT OUT, CANCEL et UNSUBSCRIBE sont reconnus comme des commandes d’annulation. Lorsqu’un message entrant correspond exactement à l’un de ces mots clés, Azure Communication Services traite automatiquement la demande et met à jour l’état d’adhésion de l’utilisateur dans notre base de données en conséquence.

Tarification et facturation

Messaging Connect utilise un modèle à double frais pour séparer l’utilisation de la plateforme Microsoft par rapport aux services de livraison et de location du partenaire.

Ce que vous payez Microsoft

Vous payez des frais de plateforme pour utiliser les API et l’infrastructure Azure Communication Services pour Messaging Connect. Cela couvre le traitement des messages, les diagnostics, le suivi de la distribution et l’observabilité au niveau de l’API.

• Azure facture un tarif de plateforme de 0,0025 $ pour chaque demande d’envoi SMS envoyée, que le message soit remis en fin de compte par le partenaire. Microsoft ne facture pas la livraison.
• Ces frais correspondent au prépaiement Azure (ou engagement monétaire) et sont éligibles au MACC (Microsoft Azure Consumption Commitment) et apparaissent dans le cadre de votre facture Azure normale.

Le partenaire Messaging Connect, et non Microsoft, gère la remise des messages.

Ce que vous payez le partenaire

Vous payez directement le partenaire Messaging Connect pour :

• Location de numéros de téléphone (mensuel ou annuel)
• Frais de remise par message, qui varient selon le pays et l’itinéraire

Le partenaire définit les conditions commerciales et les niveaux de support. Par défaut, le partenaire Messaging Connect (par exemple, Infobip) vous facture directement les frais de livraison et de location de numéros. Ces frais n’apparaissent pas sur votre facture Azure, sauf si vous configurez explicitement la facturation de la Place de marché. Il n’existe aucune restriction d’abonnement. Vous pouvez utiliser Messaging Connect avec n’importe quel type d’abonnement Azure, y compris les contrats de paiement à l’utilisation et d’entreprise. Contrairement aux offres SMS directes de Microsoft, Messaging Connect n’est pas un service de télécommunications, il s’agit d’un modèle de plateforme de développement.

Facultatif : Facturation consolidée via la Place de marché Azure

Si vous préférez consolider les frais dans votre facture Azure, vous pouvez demander que le partenaire offre Messaging Connect via la Place de marché Azure. Voici comment fonctionne le flux de la Place de marché :

1. Vous demandez au partenaire (Infobip) de soumettre une offre privée via la Place de marché Azure.
2. Votre administrateur Azure accepte l’offre dans le portail Azure.
3. Chaque mois, le partenaire envoie des données d’utilisation à Microsoft.
4. Microsoft vous facture au nom du partenaire (frais directes).

Cette configuration simplifie l’approvisionnement et autorise l’utilisation de Messaging Connect à compter pour votre engagement Azure MACC.

En savoir plus : Place de marché Azure

Expérience développeur

Obtenir un numéro de téléphone avec Messaging Connect

Messaging Connect introduit un nouveau modèle d’approvisionnement : au lieu d’obtenir des numéros directement à partir de Microsoft, vous les achetez via un partenaire approuvé, en commençant par Infobip, puis connectez-les à votre ressource Azure Communication Services. Ce processus vous permet d’accéder aux numéros SMS dans plus de 190 pays, tandis que le partenaire gère les flux de conformité, de documentation et d’approbation locaux.

Pas à pas :

1. Choisir votre partenaire Messaging Connect

   Dans le portail Azure, dans votre ressource Communication Services, accédez au panneau Messaging Connect et choisissez un partenaire dans la liste. Acceptez les conditions. Vous êtes redirigé vers le site partenaire pour obtenir le numéro.

2. Acquérir le numéro sur le portail du partenaire

   Pour acheter le numéro, suivez les invites fournies par le partenaire Messaging Connect. Selon le pays, vous devrez peut-être charger des documents de prise en charge ou effectuer la vérification complète de l’identité. Une fois approuvé, le numéro est attribué à votre compte partenaire.

   

3. Revenir au portail Azure

   Une fois que le partenaire confirme que vos numéros sont provisionnés, ils déclenchent la synchronisation avec Azure Communication Services. Une fois la synchronisation terminée, les nombres apparaissent automatiquement dans votre ressource ACS, prêts à être utilisés avec l’API SMS ACS, comme n’importe quel nombre approvisionné directement via Azure Communication Services. Aucune configuration supplémentaire n’est nécessaire de votre côté.

   

   Note

   Le partenaire Messaging Connect définit la chronologie d’approbation et d’activation, qui varie selon le type de pays et de nombre. Messaging Connect ne prend actuellement pas en charge l’approvisionnement instantané et Microsoft n’est pas impliqué dans le processus de vérification ou d’approbation.

Remarques importantes :

• Microsoft ne gère pas la conformité ni la vérification des numéros de Messaging Connect. Le partenaire gère entièrement ce processus.
• Chaque partenaire dispose de différents flux d’approvisionnement et contrats de niveau de service (SLA) en fonction de la région et des réglementations locales en matière de télécommunications.
• Les numéros acquis via Messaging Connect s’affichent dans le portail Azure avec une étiquette « Nom de l’opérateur » afin de pouvoir les distinguer des numéros gérés par Azure Communication Services.
• Pour envoyer des messages avec ces numéros, n’oubliez pas d’inclure l’objet MessagingConnect dans votre demande d’API.

Tutoriel sur le Kit de développement logiciel (SDK) SMS

Messaging Connect s’appuie sur les fonctionnalités SMS existantes d’Azure Communication Services. Il utilise les mêmes API SMS et sdk. Par conséquent, si vous êtes déjà familiarisé avec l’envoi de messages à l’aide d’ACS, en particulier si vous avez terminé le guide de démarrage rapide Envoyer des SMS, vous êtes presque là. Veillez simplement à utiliser la Send SMS with options méthode et à inclure l’objet MessagingConnect dans le champ Options.

Si vous débutez avec Azure Communication Services, commencez par suivre le guide de démarrage rapide Envoyer un SMS pour configurer l’authentification, créer votre SmsClientet comprendre la structure de base d’une demande d’envoi. Veillez à inclure l’objet MessagingConnect dans votre demande.

Cet objet contient :

• Nom du partenaire (par exemple, « infobip »)
• Clé API partenaire que vous avez reçue après l’acquisition du numéro

Votre jeton Azure Communication Services continue d’autoriser la demande auprès d’Azure, et la clé partenaire indique à Azure Communication Services comment acheminer le message.

Les exemples suivants montrent comment envoyer un message avec Messaging Connect à l’aide de C# et JavaScript.

Exemple C#

smsClient.Send(
    from: "<YOUR-ACS-NUMBER>",
    to: ["<RECIPIENT-NUMBER>"],
    message: $"Hello from Azure Communication Services!",
    options: new SmsSendOptions(true)
    {
        MessagingConnect = new MessagingConnectOptions("<YOUR-INFOBIP-API-KEY>", "infobip")
    });

Exemple JavaScript

await smsClient.send(
    {
      from: "<YOUR-ACS-NUMBER>",
      to: ["<RECIPIENT-NUMBER>"],
      message: "Hello from Azure Communication Services! JS SDK is working!",
    },
    {
        enableDeliveryReport: true, // Optional: Enable delivery reports
        messagingConnect: {
          apiKey: "<YOUR-INFOBIP-API-KEY>",
          partner: "infobip"
      }
  });

Codes d’erreur SMS

Lorsque vous envoyez des sms via Messaging Connect, vous pouvez rencontrer des codes d’erreur, soit dans le cadre de la validation synchrone (réponse de l’API immédiate) ou dans des rapports de remise asynchrones. Azure Communication Services utilise le même modèle d’erreur sur tout le trafic SMS, y compris Messaging Connect.

En savoir plus : Voir la liste complète des codes d’erreur SMS

Répertoire du partenaire Messaging Connect

Messaging Connect fonctionne via des intégrations directes avec des fournisseurs SMS globaux approuvés. Ces partenaires gèrent l’attribution de numéros, la conformité, la remise et l’application des refus, tandis qu’Azure fournit la plateforme de développement, l’observabilité et l’orchestration des messages. Le tableau suivant répertorie les partenaires actuellement pris en charge. D’autres partenaires seront ajoutés au fil du temps pour offrir une couverture et une redondance plus larges.

Étapes suivantes