البدء السريع: إرسال رسالة SMS

مقالة
04/27/2022
قراءة خلال 15 دقائق

هام

تعتمد الإمكانات المتوفرة (PSTN/SMS، الوارد/الصادر) على البلد الذي تعمل فيه (موقع عنوان فوترة Azure) وحالة الاستخدام ونوع رقم الهاتف الذي حددته. وتختلف هذه الإمكانات باختلاف البلد بسبب المتطلبات التنظيمية. لمزيد من المعلومات، قم بزيارة وثائق Phone number types.

هام

يمكن إرسال رسائل SMS، واستلامها من أرقام هواتف الولايات المتحدة. أرقام الهواتف الموجودة في مناطق جغرافية أخرى غير مدعومة حتى الآن بواسطة خدمة الرسائل القصيرة لخدمات الاتصالات Communication Services SMS. لمزيد من المعلومات، راجع ⁧⁩⁧⁩أنواع أرقام الهواتف⁩⁧.

ابدأ العمل مع Azure Communication Services باستخدام Communication Services C# SMS SDK لإرسال رسائل نصية قصيرة.

يتطلب إكمال هذا التشغيل السريع تكلفة صغيرة تبلغ بضعة سنتات أمريكية أو أقل في حساب Azure الخاص بك.

ملاحظة

العثور على التعليمات البرمجية النهائية الخاصة بالتشغيل السريع على GitHub

المتطلبات الأساسية

حساب Azure باشتراك نشط. إنشاء حساب مجاناً.
أحدث إصدار .NET Core SDK لنظام التشغيل الخاص بك.
مورد Communication Services نشط وسلسلة اتصال. إنشاء مورد خدمات الاتصال.
رقم هاتف ممكن لرسائل SMS. احصل على رقم هاتف.

التحقق من المتطلبات الأساسية

في النافذة الطرفية أو نافذة الأوامر، قم بتشغيل الأمر dotnet للتحقق من تثبيت NET SDK..
لعرض أرقام الهواتف المقترنة بمورد Communication Services، سجل الدخول إلى مدخل Azure، وحدد موقع مورد Communication Services وافتح علامة التبويب أرقام الهواتف من جزء التنقل الأيسر.

الإعداد

إنشاء تطبيق C# جديد

في نافذة وحدة تحكم (مثل cmd أو PowerShell أو Bash)، استخدم الأمر ⁧dotnet new⁩ لإنشاء تطبيق وحدة تحكم جديد بالاسم ⁧SmsQuickstart⁩. هذا الأمر ينشئ مشروع "Hello World" بسيطًا بلغة #C باستخدام ملف مصدر واحد: Program.cs.

dotnet new console -o SmsQuickstart

قم بتغيير الدليل الخاص بك إلى مجلد التطبيق الذي تم إنشاؤه حديثًا، واستخدم الأمر dotnet build للتحويل البرمجي لتطبيقك.

cd SmsQuickstart
dotnet build

تثبيت الحزمة

أثناء الاستمرار في دليل التطبيق، ثبّت Azure Communication Services SMS SDK لحزمة ‎.NET باستخدام الأمر dotnet add package.

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

أضف توجيه using إلى أعلى Program.cs لتضمين مساحة اسم Azure.Communication.


using System;
using System.Collections.Generic;

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

نموذج الكائن

تتعامل الفئات والواجهات التالية مع بعض الميزات الرئيسية لـ Azure Communication Services SMS SDK for C#‎.

الاسم	الوصف
SmsClient	هذه الفئة مطلوبة لجميع وظائف الرسائل النصية القصيرة. إنشاء مثيل مع معلومات الاشتراك الخاص بك، واستخدامها لإرسال الرسائل النصية القصيرة.
SmsSendOptions	توفر هذه الواجهة خيارات لتكوين تقارير التسليم. إذا تم تعيين enable_delivery_report على True، فسيتم إرسال حدث عند نجاح التسليم
SmsSendResult	تحتوي هذه الفئة على النتيجة من خدمة الرسائل النصية القصيرة.

مصادقة العميل

افتح Program.cs في محرر النصوص، واستبدل نص الأسلوب Main مع التعليمات البرمجية لتهيئة SmsClient مع سلسلة الاتصال. يسترد الرمز أدناه سلسلة الاتصال للمورد من متغير بيئة يسمى COMMUNICATION_SERVICES_CONNECTION_STRING. تعرف على كيفية إدارة سلسلة اتصال المورد.

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

SmsClient smsClient = new SmsClient(connectionString);

إرسال رسالة نصية قصيرة 1:1

لإرسال رسالة نصية قصيرة إلى مستلم واحد، استدع الدالة Send أو SendAsync من SmsClient. أضف هذه التعليمات البرمجية إلى نهاية الأسلوب Main في Program.cs:

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

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

يجب أن تستبدل <from-phone-number> برقم هاتف يدعم الرسائل النصية القصيرة ومرتبط بمورد Communication Services و<to-phone-number> مع رقم الهاتف الذي ترغب في إرسال رسالة إليه.

تحذير

لاحظ أنه ينبغي تقديم أرقام الهواتف بتنسيق E.164 القياسي الدولي (على سبيل المثال: +14255550123). قد يكون رقم الهاتف من رمز قصير أيضا (على سبيل المثال: 23456).

إرسال رسالة نصية قصيرة 1:N مع خيارات

لإرسال رسالة نصية قصيرة إلى قائمة المستلمين، استدعِ الدالة Send أو SendAsync من SmsClient مع قائمة بأرقام هواتف المستلمين. يمكنك أيضًا تمرير معلمات اختيارية لتحديد ما إذا كان يجب تمكين تقرير التسليم، وتعيين علامات مخصصة.

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

يجب استبدال <from-phone-number> مع رقم هاتف ممكَّن عليه خدمة الرسائل النصية القصيرة ومرتبط بمورد Communication Services، و<to-phone-number-1> و<to-phone-number-2> مع أرقام الهاتف التي ترغب في إرسال رسالة إليها.

تحذير

المعلمة enableDeliveryReport هي معلمة اختيارية يمكنك استخدامها لتكوين تقارير التسليم. هذا مفيد للسيناريوهات حيث تريد إرسال الأحداث عند تسليم رسائل نصية قصيرة. راجع التشغيل السريع معالجة أحداث الرسائل النصية القصيرة لتكوين "تقارير التسليم" للرسائل النصية القصيرة.

يستخدم Tag لتطبيق علامة على تقرير التسليم

تشغيل التعليمات البرمجية

شغل التطبيق من دليل تطبيقك باستخدام الأمر dotnet run.

dotnet run

نموذج التعليمات البرمجية

يمكنك تنزيل نموذج التطبيق من GitHub

ابدأ مع Azure Communication Services باستخدام Communication Services JavaScript SMS SDK لإرسال رسائل نصية قصيرة.

يتطلب إكمال هذا التشغيل السريع تكلفة صغيرة تبلغ بضعة سنتات أمريكية أو أقل في حساب Azure الخاص بك.

ملاحظة

العثور على التعليمات البرمجية النهائية الخاصة بالتشغيل السريع على GitHub

المتطلبات الأساسية

حساب Azure باشتراك نشط. إنشاء حساب مجاناً.
Node.js إصدارات Active LTS و Maintenance LTS (يوصى باستخدام 8.11.1 و 10.14.1).
مورد "خدمات الاتصال" النشطة وسلسلة الاتصال. إنشاء مورد خدمات الاتصال.
رقم هاتف ممكن لرسائل SMS. احصل على رقم هاتف.

التحقق من المتطلبات الأساسية

في نافذة طرفية أو نافذة أوامر، قم بتشغيل node --version للتحقق من تثبيت Node.js.
لعرض أرقام الهواتف المقترنة بمورد Communication Services، سجل الدخول إلى مدخل Azure، وحدد موقع مورد Communication Services وافتح علامة التبويب أرقام الهواتف من جزء التنقل الأيسر.

الإعداد

إنشاء تطبيق Node.js جديد

أولًا، افتح نافذة طرفية أو نافذة الأوامر الخاصة بك، وأنشئ دليلًا جديدًا لتطبيقك، وانتقل إليه.

mkdir sms-quickstart && cd sms-quickstart

قم بتشغيل npm init -y لإنشاء ملف package.json بالإعدادات الافتراضية.

npm init -y

استخدم محرر نص لإنشاء ملف يُسمى send-sms.js في الدليل الجذر للمشروع. ستقوم بإضافة كافة التعليمات البرمجية المصدر لهذا التشغيل السريع إلى هذا الملف في المقاطع التالية.

تثبيت الحِزَم

استخدم الأمر npm install لتثبيت Azure Communication Services Calling SDK لـ JavaScript.

npm install @azure/communication-sms --save

يسرد خيار --save المكتبة كتبعية في ملفك package.json.

نموذج الكائن

تتعامل الفئات والواجهات التالية مع بعض الميزات الرئيسية لـ Azure Communication Services SMS SDK لـ Node.js.

الاسم	الوصف
SmsClient	هذه الفئة مطلوبة لجميع وظائف الرسائل النصية القصيرة. إنشاء مثيل مع معلومات الاشتراك الخاص بك، واستخدامها لإرسال رسائل SMS.
SmsSendRequest	هذه الواجهة هي نموذج لبناء طلب الرسائل القصيرة (على سبيل المثال ، تكوين أرقام الهواتف من وإلى ومحتوى الرسائل القصيرة).
SmsSendOptions	توفر هذه الواجهة خيارات لتكوين تقارير التسليم. في حالة تعيين `enableDeliveryReport` على `true`، فسيتم إصدار حدث عندما يكون التسليم ناجحًا.
الرسائل القصيرة التي تم إرسالها	تحتوي هذه الفئة على النتيجة من خدمة الرسائل النصية القصيرة.

مصادقة العميل

قم باستيراد SmsClient من SDK، ثم أنشئ مثيلاً مع سلسلة الاتصال. يسترد الرمز أدناه سلسلة الاتصال للمورد من متغير بيئة يسمى COMMUNICATION_SERVICES_CONNECTION_STRING. تعرف على كيفية إدارة سلسلة اتصال المورد.

أنشئ وافتح ملفًا باسم send-sms.js، وأضف التعليمات البرمجية التالية:

const { SmsClient } = require('@azure/communication-sms');

// This code demonstrates how to fetch your connection string
// from an environment variable.
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the SMS client
const smsClient = new SmsClient(connectionString);

إرسال رسالة SMS 1:N

لإرسال رسالة SMS إلى قائمة المستلمين، قم باستدعاء الدالة send من SmsClient مع قائمة بأرقام هواتف المستلمين (إذا كنت ترغب في إرسال رسالة إلى مستلم واحد، قم بتضمين رقم واحد فقط في القائمة). أضف هذه التعليمة البرمجية إلى نهاية 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
  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();

يجب استبدال <from-phone-number> مع رقم هاتف ممكن بواسطة رسالة نصية قصيرة مرتبطة بمورد Communication Services خاصتك <to-phone-number-1> و<to-phone-number-2> ورقم الهاتف الذي ترغب في إرسال رسالة إليه.

تحذير

إرسال رسالة نصية قصيرة 1:N مع خيارات

يمكنك أيضًا تمرير عناصر خيارات لتحديد ما إذا كان يجب تمكين تقرير التسليم، وتعيين علامات مخصصة.


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

تحذير

تشغيل التعليمات البرمجية

استخدم الأمر node لتشغيل التعليمات البرمجية التي قمت بإضافتها إلى ملف send-sms.js.


node ./send-sms.js

ابدأ باستخدام خدمات الاتصال Azure باستخدام SDK PYTHON SMS خدمات الاتصالات لإرسال رسائل SMS.

يتطلب إكمال هذه البداية السريعة تكلفة صغيرة تبلغ بضعة سنتات أمريكية أو أقل في حساب Azure الخاص بك.

ملاحظة

العثور على التعليمات البرمجية النهائية الخاصة بالتشغيل السريع على GitHub

المتطلبات الأساسية

حساب Azure باشتراك نشط. أنشئ حساباً مجانياً.
Python 2.7 أو 3.6 أو أعلى.
مورد "خدمات الاتصال" النشطة وسلسلة الاتصال. إنشاء مورد خدمات الاتصال.
رقم هاتف ممكن لرسائل SMS. احصل على رقم هاتف.

التحقق من المتطلبات الأساسية

في النافذة الطرفية أو الأمر، قم بتشغيل ⁧python --version⁩ الأمر للتحقق من تثبيت NET SDK.
لعرض أرقام الهواتف المقترنة بمورد خدمات الاتصالات، سجل الدخول إلى ⁧⁩مدخل Azure⁧⁩، وحدد موقع مورد خدمات الاتصالات، وافتح علامة التبويب ⁧⁩أرقام الهواتف⁧⁩ من جزء التنقل الأيسر.

الإعداد

إنشاء تطبيق Python جديد

افتح نافذة الأوامر أو المحطة الطرفية، ثم أنشئ دليلاً جديدًا لتطبيقك وانتقل إليه.

mkdir sms-quickstart && cd sms-quickstart

استخدم محرر نص لإنشاء ملف يسمى ⁧⁩application-insights-quickstart.py⁧⁩ في الدليل الرئيسي للمشروع، وإضافة بنية البرنامج، بما في ذلك معالجة الاستثناء الأساسية. ستقوم بإضافة كافة التعليمات البرمجية المصدر لهذا التشغيل السريع إلى هذا الملف في المقاطع التالية.

import os
from azure.communication.sms import SmsClient

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

قم بتثبيت الحِزَم

أثناء الاستمرار في دليل التطبيق، ثبّت مكتبة عميل Azure Blob Storage لحزمة Python باستخدام الأمر ⁧pip install⁩.

pip install azure-communication-sms

طراز العنصر

تتعامل الفئات والواجهات التالية مع بعض الميزات الرئيسية لـ Azure Communication Services Calling SDK:

الاسم	الوصف
SmsClient	هذه الفئة مطلوبة لجميع وظائف الرسائل النصية القصيرة. إنشاء مثيل مع معلومات الاشتراك الخاص بك، واستخدامها لإرسال رسائل SMS.
الرسائل القصيرة التي تم إرسالها	تحتوي هذه الفئة على النتيجة من خدمة الرسائل النصية القصيرة.

مصادقة العميل

إنشاء مثيل ⁧⁩SmsClient⁧⁩ مع سلسلة الاتصال. تعرف على كيفية ⁧⁩إدارة سلسلة اتصال المورد⁧⁩.

# Create the SmsClient object which will be used to send SMS messages
sms_client = SmsClient.from_connection_string(<connection_string>)

للبساطة نحن نستخدم سلاسل الاتصال في هذه البداية السريعة؛ ولكن في بيئات الإنتاج نوصي باستخدام ⁧⁩مبادئ الخدمة⁧⁩.

إرسال رسالة SMS 1:1

لإرسال رسالة SMS إلى مستلم واحد، اتصل ⁧send⁩ الأسلوب من ⁧⁩SmsClient⁧⁩ مع رقم هاتف مستلم واحد. يمكنك أيضًا تمرير المعلمات الاختيارية لتحديد ما إذا كان يجب تمكين تقرير التسليم، وتعيين علامات مخصصة. إضافة هذا الرمز إلى نهاية ⁧try⁩ الكتلة في ⁧⁩send-sms.py⁧⁩:


# calling 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

يجب استبدال رقم هاتف ممكن ⁧<from-phone-number>⁩ برسائل نصية قصيرة مرتبط بخدمة الاتصال الخاصة بك ⁧<to-phone-number>⁩ ورقم الهاتف الذي ترغب في إرسال رسالة إليه.

تحذير

إرسال رسالة SMS 1:N


# calling 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

يجب عليك استبداله <from-phone-number> برقم هاتف ممكن بالرسائل القصيرة مرتبط بخدمة الاتصال الخاصة بك وبرقم <to-phone-number-1><to-phone-number-2> (أرقام) الهاتف الذي ترغب في إرسال رسالة إليه.

تحذير

معلمات اختيارية

⁧enable_delivery_report⁩المعلمة هي معلمة اختيارية يمكنك استخدامها لتكوين تقارير التسليم. هذا مفيد للسيناريوهات حيث تريد إرسال الأحداث عند تسليم رسائل نصية قصيرة. راجع بدء تشغيل ⁧⁩"معالجة أحداث SMS"⁧⁩ لتكوين "تقارير التسليم" لرسائل SMS الخاصة بك.

⁧tag⁩المعلمة هي معلمة اختيارية يمكنك استخدامها لتكوين تقارير التسليم.

تشغيل التعليمات البرمجية

شغل التطبيق من دليل تطبيقك باستخدام ⁧python⁩ الأمر.

python send-sms.py

يجب أن يبدو نص Python الكامل شيئًا مثل:


import os
from azure.communication.sms import SmsClient

try:
    # Create the SmsClient object which will be used to send SMS messages
    sms_client = SmsClient.from_connection_string("<connection string>")
    # calling 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)

ابدأ مع Azure Communication Services باستخدام Communication Services Java SMS SDK لإرسال رسائل نصية قصيرة.

يتطلب إكمال هذه البداية السريعة تكلفة صغيرة تبلغ بضعة سنتات أمريكية أو أقل في حساب Azure خاصتك.

ملاحظة

العثور على التعليمات البرمجية النهائية الخاصة بالتشغيل السريع على GitHub

المتطلبات الأساسية

حساب Azure باشتراك نشط. أنشئ حساباً مجانياً.
Java Development Kit (JDK) الإصدار 8 أو أعلى.
Apache Maven.
مورد Communication Services الفعالة وسلسلة الاتصال. إنشاء مورد خدمات الاتصال.
رقم هاتف ممكن لرسائل SMS. احصل على رقم هاتف.

التحقق من المتطلبات الأساسية

في نافذة الأوامر أو terminal، بادر بتشغيل mvn -v للتحقق من تثبيت maven.
لعرض أرقام الهواتف المقترنة بمورد Communication Services، سجل الدخول إلى مدخل Azure، وحدد موقع مورد Communication Services خاصتك وافتح علامة التبويب phone numbers من جزء التنقل الأيسر.

الإعداد

إنشاء تطبيق Java جديد

افتح نافذة الأوامر أو terminal وانتقل إلى الدليل حيث ترغب في إنشاء تطبيق Java خاصتك. بادر بتشغيل الأمر أدناه لإنشاء مشروع Java من قالب maven-archetype-quickstart.

mvn archetype:generate -DgroupId=com.communication.quickstart -DartifactId=communication-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

سينشئ الهدف 'generate' دليلاً بنفس اسم artifactId. ضمن هذا الدليل، يحتوي الدليل src/main/javaعلى التعليمة البرمجية مصدر المشروع، بينما يحتوي دليل src/test/javaعلى مصدر الاختبار وملف pom.xml هو نموذج عنصر المشروع أو POM.

تثبيت الحِزَمة

افتح ملف pom.xml في محرر النص. أضف عنصر التبعية التالي إلى مجموعة التبعيات.

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

اضبط إطار عمل التطبيق

افتح /src/main/java/com/communication/quickstart/App.java في محرر النصوص، وأضف توجيهات الاستيراد وأزِل البيان 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
    }
}

نموذج العنصر

تتعامل الفئات والواجهات التالية مع بعض الميزات الرئيسية لـ Azure Communication Services SMS SDK for Java.

الاسم	الوصف
SmsClientBuilder	تنشئ هذه الفئة SmsClient. يمكنك تزويدها بنقطة النهاية وبيانات الاعتماد وعميل http.
SmsClient	هذه الفئة مطلوبة لجميع وظائف الرسائل النصية القصيرة. يمكنك استخدامه لإرسال رسائل نصية قصيرة.
SmsSendOptions	توفر هذه الفئة خيارات لإضافة علامات مخصصة وتكوين تقارير التسليم. في حالة عدم تعيين deliveryReportEnabled إلى true، سيجري حذف حدث عند نجاح التسليم
SmsSendResult	تحتوي هذه الفئة على النتيجة من خدمة الرسائل النصية القصيرة.

مصادقة العميل

إنشاء مثيل SmsClient باستخدام سلسلة اتصالك. (بيانات الاعتماد هي Key من مدخل Azure. تعرف على كيفية إدارة سلسلة اتصال الموارد خاصتك. بالإضافة إلى ذلك، يمكنك تهيئة العميل باستخدام أي عميل HTTP مخصص ينفذ الواجهة com.azure.core.http.HttpClient.

قم بإضافة التعليمات البرمجية التالية إلى ⁧main⁩الأسلوب.

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

يمكنك أيضًا توفير سلسلة الاتصال بالكامل باستخدام دالة connectionString () بدلاً من توفير نقطة النهاية ومفتاح الوصول.

// You can find your connection string from your resource in the Azure portal
String connectionString = "endpoint=https://<resource-name>.communication.azure.com/;accesskey=<access-key>";

SmsClient smsClient = new SmsClientBuilder()
            .connectionString(connectionString)
            .buildClient();

إرسال رسالة نصية قصيرة 1:1

لإرسال رسالة نصية قصيرة إلى مستلم واحد، استدعِ الأسلوب send من SmsClient مع رقم هاتف مستلم واحد. يمكنك أيضًا تمرير معلمات اختيارية لتحديد ما إذا كان يجب تمكين تقرير التسليم، وتعيين علامات مخصصة.

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

يجب استبدال <from-phone-number> مع رقم هاتف ممكن بواسطة رسالة نصية قصيرة مرتبطة بمورد Communication Services خاصتك <to-phone-number> ورقم الهاتف الذي ترغب في إرسال رسالة إليه.

تحذير

إرسال رسالة نصية قصيرة 1:N مع خيارات

لإرسال رسالة نصية قصيرة إلى قائمة من المستلمين، استدعِ الأسلوب send مع قائمة بأرقام هواتف المستلمين. يمكنك أيضًا تمرير معلمات اختيارية لتحديد ما إذا كان يجب تمكين تقرير التسليم، وتعيين علامات مخصصة.

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

يجب استبدال <from-phone-number> مع رقم هاتف ممكن بواسطة رسالة نصية قصيرة مرتبطة بمورد Communication Services خاصتك <to-phone-number-1> و <to-phone-number-2> ورقم الهاتف الذي ترغب في إرسال رسالة إليه.

تحذير

الأسلوب setDeliveryReportEnabled مُستخدَّم لتكوين تقارير التسليم. هذا مفيد للسيناريوهات حيث تريد إرسال الأحداث عند تسليم رسائل نصية قصيرة. راجع التشغيل السريع معالجة أحداث الرسائل النصية القصيرة لتكوين "تقارير التسليم" للرسائل النصية القصيرة خاصتك.

الأسلوب setTag مُستخدَّم لتطبيق علامة على تقرير التسليم.

تشغيل التعليمات البرمجية

انتقل إلى الدليل الذي يحتوي على ملف pom.xml وبادر بتحويل المشروع برمجياً باستخدام الأمر mvn.


mvn compile

ثم بادر ببناء الحزمة.


mvn package

استخدم الأمر التاليmvn لتشغيل التطبيق.


mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false

استكشاف الأخطاء وإصلاحها

لاستكشاف المشكلات المتعلقة باستلام رسائل SMS، ⁧⁩يمكنك تمكين إعداد تقارير الاستلام باستخدام Event Grid⁧⁩ للحصول على تفاصيل الاستلام.

تنظيف الموارد

إذا كنت ترغب في تنظيف وإزالة اشتراك Communication Services، يمكنك حذف المورد أو مجموعة الموارد. يؤدي حذف مجموعة الموارد إلى حذف أية موارد أخرى مقترنة بها أيضًا. تعرف على المزيد بشأن تنظيف الموارد.

الخطوات التالية

في هذه البداية السريعة، تعلمت كيفية إرسال رسائل SMS باستخدام Azure Communication Services.

⁧⁩تلقَ أحداث تقرير رسائل SMS القصيرة والاستلام⁧⁩

⁧⁩أنواع أرقام الهواتف⁩

⁧⁩تعرّف على المزيد حول رسائل SMS⁧⁩

البدء السريع: إرسال رسالة SMS

هل هذه الصفحة مفيدة؟

المتطلبات الأساسية

التحقق من المتطلبات الأساسية

الإعداد

إنشاء تطبيق C# جديد

تثبيت الحزمة

نموذج الكائن

مصادقة العميل

إرسال رسالة نصية قصيرة 1:1

إرسال رسالة نصية قصيرة 1:N مع خيارات

تشغيل التعليمات البرمجية

نموذج التعليمات البرمجية

المتطلبات الأساسية

التحقق من المتطلبات الأساسية

الإعداد

إنشاء تطبيق Node.js جديد

تثبيت الحِزَم

نموذج الكائن

مصادقة العميل

إرسال رسالة SMS 1:N

إرسال رسالة نصية قصيرة 1:N مع خيارات

تشغيل التعليمات البرمجية

المتطلبات الأساسية

التحقق من المتطلبات الأساسية

الإعداد

إنشاء تطبيق Python جديد

قم بتثبيت الحِزَم

طراز العنصر

مصادقة العميل

إرسال رسالة SMS 1:1

إرسال رسالة SMS 1:N

معلمات اختيارية

تشغيل التعليمات البرمجية

المتطلبات الأساسية

التحقق من المتطلبات الأساسية

الإعداد

إنشاء تطبيق Java جديد

تثبيت الحِزَمة

اضبط إطار عمل التطبيق

نموذج العنصر

مصادقة العميل

إرسال رسالة نصية قصيرة 1:1

إرسال رسالة نصية قصيرة 1:N مع خيارات

تشغيل التعليمات البرمجية

استكشاف الأخطاء وإصلاحها

تنظيف الموارد

الخطوات التالية