به‌روزرسانی‌ها : یادداشت‌های انتشار را برای ویژگی‌های جدید و به‌روزرسانی‌های محصول بررسی کنید. ، روز رسانی : یادداشت های انتشار را برای ویژگی های جدید و به روز رسانی محصول بررسی کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

اولین نماینده خود را بسازید

کاربران از طریق یک برنامه پیام‌رسانی دارای قابلیت RCS، مانند Google Messages ، در دستگاه‌های خود با نمایندگان تعامل دارند. در این شروع سریع، شما یک عامل اصلی RBM ایجاد می کنید که می تواند یک پیام ساده به یک دستگاه آزمایشی ارسال کند و پاسخ دریافت کند.

جریان یک پیام از طریق یک مکالمه با RBM فعال

پیش نیازها

قبل از شروع کار با نماینده خود، به موارد زیر نیاز دارید:

نام برندی که نماینده شما نمایندگی می کند
مال نماینده شما
دستگاه اندرویدی با شماره تلفن فعال
یک ماشین توسعه که می تواند کد نمونه را اجرا کند

دستگاه تست خود را راه اندازی کنید

برای برقراری ارتباط با یک عامل RBM راه‌اندازی نشده، یک دستگاه آزمایشی باید RCS را فعال کند، اما همه دستگاه‌های Android به‌طور پیش‌فرض نمی‌توانند پیام‌های RCS را دریافت کنند. می توانید وضعیت RCS دستگاه خود را بررسی کنید و در صورت لزوم، RCS را با پیکربندی دستگاه خود با نسخه های پیش از انتشار برنامه های پیام ها و خدمات حامل فعال کنید .

وضعیت RCS دستگاه خود را بررسی کنید

در برنامه پیام‌ها، روی دکمه ضربه بزنید، سپس روی تنظیمات ضربه بزنید.
روی ویژگی‌های گپ ضربه بزنید و مقدار وضعیت را پیدا کنید.
اگر وضعیت متصل است، RCS در دستگاه شما فعال است.

مراحل بعدی

اگر RCS در دستگاه شما فعال است، آماده راه اندازی نماینده خود هستید. اگر RCS در دستگاه شما غیرفعال است، قبل از اینکه بتوانید عامل RBM خود را آزمایش کنید، باید RCS را در دستگاه خود فعال کنید .

نماینده خود را تنظیم کنید

عوامل RBM از RBM API برای ارسال پیام‌ها ، رویدادها و سایر درخواست‌ها به کاربران استفاده می‌کنند. هنگامی که یک عامل ایجاد می کنید، دسترسی به API RBM را فعال می کنید و اطلاعات اصلی نماینده خود را تعریف می کنید.

منطقه عامل را شناسایی کنید

RBM API از سه نقطه پایانی منطقه ای پشتیبانی می کند تا به کسب و کارها کمک کند تا با الزامات منطقه ای و تجاری مطابقت داشته باشند. عوامل RBM می توانند در یکی از سه منطقه وجود داشته باشند:

آمریکای شمالی
اروپا
آسیا و اقیانوسیه

هنگامی که نماینده خود را ایجاد می کنید، منطقه آن را بر اساس مقررات، الزامات، و نزدیکی به کاربران نهایی انتخاب کنید. توجه داشته باشید که منطقه خاص کشور نیست. منطقه ای را که نماینده شما در آن فعالیت می کند مشخص می کند. Google از این اطلاعات برای تعیین مکان ذخیره داده های پیام و نحوه مسیریابی مناسب ترافیک پیام استفاده می کند.

دسته صورتحساب نماینده را تعیین کنید

شرکت‌های مخابراتی که محتوای RBM را در شبکه‌های خود تأیید می‌کنند، با استفاده از این چارچوب صورت‌حساب، پیام‌های RBM را به مشترکین خود ارسال می‌کنند:

مکالمه - هزینه مکالمه ای که شامل چندین پیام A2P و P2A در یک دوره زمانی معین است.
Single Message - هزینه یک پیام حاوی محتوای غنی RBM (مانند پیام حاوی کارت غنی یا چرخ فلک).
پیام اصلی - هزینه برای یک پیام متنی ساده تا 160 کاراکتر.

هنگامی که نماینده خود را ایجاد می کنید، دسته صورتحساب را انتخاب کنید که بیشتر با رفتار منطق نماینده شما مطابقت دارد:

مکالمه - این عامل درگیر تعاملات پیچیده با کاربر است که در آن پیام ها در هر دو جهت رد و بدل می شوند.

دو دسته زیر هرگز رویدادهای صورت‌حساب مکالمه را ایجاد نمی‌کنند. شرکت‌های مخابراتی برای هر پیام، بسته به محتوایی که تحویل داده می‌شود، قیمت پیام اصلی یا تک پیام را دریافت می‌کنند.

پیام واحد - این نماینده به طور کلی پیام های غنی ارسال می کند و به ندرت انتظار دریافت پاسخ را دارد.
پیام اصلی - این عامل ارتقاء SMS را به RBM اجرا می کند و به ندرت انتظار دریافت پاسخ را دارد. به طور کلی انتظار می رود که نماینده پیام های متنی ساده تا 160 کاراکتر ارسال کند. اما عامل محدود نیست. اگر برای این کار برنامه ریزی شده باشد، می تواند محتوای غنی تری ارسال کند و بر اساس آن صورتحساب دریافت می شود.

قبل از راه‌اندازی نماینده، می‌توانید دسته صورت‌حساب نماینده خود را تغییر دهید. برای بحث در مورد تغییر به دسته دیگری از صورتحساب با ما تماس بگیرید .

مورد استفاده عامل را شناسایی کنید

هر عامل RBM باید یک مورد استفاده از پیش تعریف شده داشته باشد که منعکس کننده ماهیت مکالماتی است که قرار است با کاربران نهایی داشته باشد و به کسب و کارها کمک کند تا قوانین تجاری را رعایت کنند. RBM از چهار مورد استفاده پشتیبانی می کند:

OTP : گذرواژه های یکبار مصرف برای احراز هویت ایمن یک حساب یا تأیید تراکنش مورد نیاز است
تراکنشی : اعلان‌ها، به‌روزرسانی‌ها یا هشدارها برای به اشتراک گذاشتن اطلاعاتی که مستقیماً با خدمات یا محصولات موجود مشتری مرتبط است، مانند هشدارهای مربوط به فعالیت‌های مشکوک حساب، تأییدیه‌های خرید و اعلان‌های حمل و نقل.
تبلیغاتی : فروش، بازاریابی و پیام های تبلیغاتی به مشتریان جدید یا موجود، با هدف افزایش آگاهی، تعامل و فروش.
چند منظوره : جریان‌های مکالمه‌ای که موارد استفاده تجاری و تبلیغاتی را ترکیب می‌کند، مانند ارسال اعلان حساب و سپس ارائه تخفیف یا ارتقا برای محصول و خدمات جدید.

برای توضیح کامل تر در مورد زمان استفاده از هر مورد استفاده، به انتخاب مورد استفاده مناسب مراجعه کنید.

پس از ارسال نماینده خود برای راه اندازی، نمی توانید مورد استفاده را تغییر دهید. حتماً موارد استفاده و قوانین تجاری کشور خود را قبل از ارسال نماینده خود مرور کنید.

عامل ایجاد کنید

برای ایجاد نماینده خود در Business Communications Developer Console این دستورالعمل ها را دنبال کنید.

کنسول توسعه‌دهنده Business Communications را باز کنید و با حساب Google شریک RBM خود وارد شوید.
روی ایجاد عامل کلیک کنید.
برای نوع نماینده ، RCS Business Messaging را انتخاب کنید.
برای نام تجاری ، نام تجاری را که نماینده شما نمایندگی می کند انتخاب کنید یا روی افزودن نام تجاری جدید کلیک کنید و نام آن را وارد کنید.
نام نماینده خود را وارد کنید و منطقه، دسته صورتحساب و مورد استفاده نماینده خود را انتخاب کنید. سپس روی Create agent کلیک کنید.
وقتی نماینده شما در دسترس است، روی نام نماینده خود کلیک کنید.

هنگامی که نماینده شما در دسترس است، می توانید اطلاعات کسب و کار و نام تجاری را اضافه کنید. نمایندگی ها را ببینید.

دستگاه آزمایشی خود را دعوت کنید

اکنون که یک نماینده دارید و دستگاه آزمایشی شما دارای RCS فعال است، می توانید دستگاه خود را برای آزمایش نماینده خود دعوت کنید.

در پیمایش سمت چپ، روی دستگاه‌ها کلیک کنید.
برای افزودن دستگاه‌های آزمایشی ، شماره تلفن دستگاه خود را وارد کرده و روی افزودن کلیک کنید.
در دستگاه آزمایشی خود، درخواست آزمایشگر را برای نماینده خود بپذیرید.

اگر در دستگاه آزمایشی خود دعوت نامه ای دریافت نکردید، بررسی کنید که RCS در دستگاه شما فعال باشد .

ارسال پیام

با یک دستگاه تست ثبت شده، نماینده شما اکنون می تواند پیام ارسال کند .

برای احراز هویت ایمن تماس‌های API به یک کلید حساب سرویس نیاز دارید. اگر قبلاً یک کلید حساب سرویس برای حساب شریک خود ایجاد نکرده‌اید، اکنون زمان انجام آن است.

در ترمینال در ماشین توسعه خود، دستور زیر را اجرا کنید:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!'
  }
}"

بسته به منطقه نماینده خود، REGION با asia ، europe یا us جایگزین کنید.
شماره تلفن دستگاه آزمایشی خود را جایگزین PHONE_NUMBER کنید. کد کشور، کد منطقه و علامت + را وارد کنید، اما جداکننده‌ها را درج نکنید. به عنوان مثال، +14155555555 .
AGENT ID نماینده خود را که در صفحه اطلاعات نماینده در کنسول توسعه دهنده ارتباطات تجاری قرار دارد، جایگزین کنید.
PATH_TO_SERVICE_ACCOUNT_KEY با مسیر کلیدی که قبلا ایجاد کردید جایگزین کنید.

شما باید یک "سلام، دنیا!" پیامی از نماینده شما در دستگاه آزمایشی شما. اگر در دستگاه آزمایشی خود پیامی دریافت نکردید، بررسی کنید که شماره تلفن و مسیر کلید حساب سرویس خود را در دستور به درستی وارد کرده و قالب بندی کرده اید.

برای ارسال انواع مختلف پیام‌ها، مانند پاسخ‌های پیشنهادی و کارت‌های غنی، به ارسال پیام‌ها مراجعه کنید.

مراحل بعدی

اکنون که نماینده شما می‌تواند پیام‌هایی را به یک دستگاه آزمایشی ارسال کند، وقت آن است که چیزی را بسازید که مطابق با نیازهای تجاری شما باشد. یک نماینده نمونه به زبان دلخواه خود دریافت کنید و دستورالعمل‌های موجود در README نمونه را دنبال کنید.

هنگامی که نماینده نمونه را پیکربندی کردید، بهترین روش های RBM را مرور کنید و یاد بگیرید که چگونه نماینده ها پیام ها را ارسال و دریافت می کنند .

جریان یک پیام از طریق یک مکالمه با RBM فعال

پیش نیازها

قبل از شروع کار با نماینده خود، به موارد زیر نیاز دارید:

نام برندی که نماینده شما نمایندگی می کند
مال نماینده شما
دستگاه اندرویدی با شماره تلفن فعال
یک ماشین توسعه که می تواند کد نمونه را اجرا کند

دستگاه تست خود را راه اندازی کنید

وضعیت RCS دستگاه خود را بررسی کنید

در برنامه پیام‌ها، روی دکمه ضربه بزنید، سپس روی تنظیمات ضربه بزنید.
روی ویژگی‌های گپ ضربه بزنید و مقدار وضعیت را پیدا کنید.
اگر وضعیت متصل است، RCS در دستگاه شما فعال است.

مراحل بعدی

نماینده خود را تنظیم کنید

منطقه عامل را شناسایی کنید

آمریکای شمالی
اروپا
آسیا و اقیانوسیه

دسته صورتحساب نماینده را تعیین کنید

مکالمه - هزینه مکالمه ای که شامل چندین پیام A2P و P2A در یک دوره زمانی معین است.
Single Message - هزینه یک پیام حاوی محتوای غنی RBM (مانند پیام حاوی کارت غنی یا چرخ فلک).
پیام اصلی - هزینه برای یک پیام متنی ساده تا 160 کاراکتر.

مکالمه - این عامل درگیر تعاملات پیچیده با کاربر است که در آن پیام ها در هر دو جهت رد و بدل می شوند.

پیام واحد - این نماینده به طور کلی پیام های غنی ارسال می کند و به ندرت انتظار دریافت پاسخ را دارد.
پیام اصلی - این عامل ارتقاء SMS را به RBM اجرا می کند و به ندرت انتظار دریافت پاسخ را دارد. به طور کلی انتظار می رود که نماینده پیام های متنی ساده تا 160 کاراکتر ارسال کند. اما عامل محدود نیست. اگر برای این کار برنامه ریزی شده باشد، می تواند محتوای غنی تری ارسال کند و بر اساس آن صورتحساب دریافت می شود.

مورد استفاده عامل را شناسایی کنید

OTP : گذرواژه های یکبار مصرف برای احراز هویت ایمن یک حساب یا تأیید تراکنش مورد نیاز است
تراکنشی : اعلان‌ها، به‌روزرسانی‌ها یا هشدارها برای به اشتراک گذاشتن اطلاعاتی که مستقیماً با خدمات یا محصولات موجود مشتری مرتبط است، مانند هشدارهای مربوط به فعالیت‌های مشکوک حساب، تأییدیه‌های خرید و اعلان‌های حمل و نقل.
تبلیغاتی : فروش، بازاریابی و پیام های تبلیغاتی به مشتریان جدید یا موجود، با هدف افزایش آگاهی، تعامل و فروش.
چند منظوره : جریان‌های مکالمه‌ای که موارد استفاده تجاری و تبلیغاتی را ترکیب می‌کند، مانند ارسال اعلان حساب و سپس ارائه تخفیف یا ارتقا برای محصول و خدمات جدید.

برای توضیح کامل تر در مورد زمان استفاده از هر مورد استفاده، به انتخاب مورد استفاده مناسب مراجعه کنید.

عامل ایجاد کنید

برای ایجاد نماینده خود در Business Communications Developer Console این دستورالعمل ها را دنبال کنید.

کنسول توسعه‌دهنده Business Communications را باز کنید و با حساب Google شریک RBM خود وارد شوید.
روی ایجاد عامل کلیک کنید.
برای نوع نماینده ، RCS Business Messaging را انتخاب کنید.
برای نام تجاری ، نام تجاری را که نماینده شما نمایندگی می کند انتخاب کنید یا روی افزودن نام تجاری جدید کلیک کنید و نام آن را وارد کنید.
نام نماینده خود را وارد کنید و منطقه، دسته صورتحساب و مورد استفاده نماینده خود را انتخاب کنید. سپس روی Create agent کلیک کنید.
وقتی نماینده شما در دسترس است، روی نام نماینده خود کلیک کنید.

دستگاه آزمایشی خود را دعوت کنید

در پیمایش سمت چپ، روی دستگاه‌ها کلیک کنید.
برای افزودن دستگاه‌های آزمایشی ، شماره تلفن دستگاه خود را وارد کرده و روی افزودن کلیک کنید.
در دستگاه آزمایشی خود، درخواست آزمایشگر را برای نماینده خود بپذیرید.

اگر در دستگاه آزمایشی خود دعوت نامه ای دریافت نکردید، بررسی کنید که RCS در دستگاه شما فعال باشد .

ارسال پیام

با یک دستگاه تست ثبت شده، نماینده شما اکنون می تواند پیام ارسال کند .

در ترمینال در ماشین توسعه خود، دستور زیر را اجرا کنید:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!'
  }
}"

بسته به منطقه نماینده خود، REGION با asia ، europe یا us جایگزین کنید.
شماره تلفن دستگاه آزمایشی خود را جایگزین PHONE_NUMBER کنید. کد کشور، کد منطقه و علامت + را وارد کنید، اما جداکننده‌ها را درج نکنید. به عنوان مثال، +14155555555 .
AGENT ID نماینده خود را که در صفحه اطلاعات نماینده در کنسول توسعه دهنده ارتباطات تجاری قرار دارد، جایگزین کنید.
PATH_TO_SERVICE_ACCOUNT_KEY با مسیر کلیدی که قبلا ایجاد کردید جایگزین کنید.

برای ارسال انواع مختلف پیام‌ها، مانند پاسخ‌های پیشنهادی و کارت‌های غنی، به ارسال پیام‌ها مراجعه کنید.

مراحل بعدی

قبلی

حساب شریک خود را تنظیم کنید، حساب شریک خود را تنظیم کنید