کاربران از طریق یک برنامه پیام‌رسانی دارای قابلیت RCS، مانند Google Messages ، در دستگاه‌های خود با نمایندگان تعامل دارند. در این شروع سریع، شما یک عامل اصلی RBM ایجاد می کنید که می تواند یک پیام ساده به یک دستگاه آزمایشی ارسال کند و پاسخ دریافت کند.
پیش نیازها
قبل از شروع کار با نماینده خود، به موارد زیر نیاز دارید:
- نام برندی که نماینده شما نمایندگی می کند
- مال نماینده شما
- دستگاه اندرویدی با شماره تلفن فعال
- یک ماشین توسعه که می تواند کد نمونه را اجرا کند
دستگاه تست خود را راه اندازی کنید
برای برقراری ارتباط با یک عامل RBM راه‌اندازی نشده، یک دستگاه آزمایشی باید RCS را فعال کند، اما همه دستگاه‌های Android به‌طور پیش‌فرض نمی‌توانند پیام‌های RCS را دریافت کنند. می توانید وضعیت RCS دستگاه خود را بررسی کنید و در صورت لزوم، RCS را با پیکربندی دستگاه خود با نسخه های پیش از انتشار برنامه های پیام ها و خدمات حامل فعال کنید .
وضعیت RCS دستگاه خود را بررسی کنید
- در برنامه پیام‌ها، روی دکمه ضربه بزنید، سپس روی تنظیمات ضربه بزنید.
روی ویژگی‌های گپ ضربه بزنید و مقدار وضعیت را پیدا کنید.
اگر وضعیت متصل است، RCS در دستگاه شما فعال است.
مراحل بعدی
اگر RCS در دستگاه شما فعال است، آماده راه اندازی نماینده خود هستید. اگر RCS در دستگاه شما غیرفعال است، قبل از اینکه بتوانید عامل RBM خود را آزمایش کنید، باید RCS را در دستگاه خود فعال کنید .
نماینده خود را تنظیم کنید
عوامل RBM از RBM API برای ارسال پیام‌ها ، رویدادها و سایر درخواست‌ها به کاربران استفاده می‌کنند. هنگامی که یک عامل ایجاد می کنید، دسترسی به API RBM را فعال می کنید و اطلاعات اصلی نماینده خود را تعریف می کنید.
منطقه عامل را شناسایی کنید
عوامل RBM می توانند در یکی از سه منطقه وجود داشته باشند: آمریکای شمالی، اروپا و آسیا و اقیانوسیه. RBM API از سه نقطه پایانی منطقه ای پشتیبانی می کند تا به کسب و کارها کمک کند تا با الزامات منطقه ای و تجاری مطابقت داشته باشند.
هنگامی که نماینده خود را ایجاد می کنید، منطقه نماینده خود را بر اساس مقررات، الزامات و نزدیکی به کاربران نهایی قابل اجرا انتخاب کنید. این منطقه تعیین می کند که نماینده شما از کجا فعالیت می کند و داده های خود را در کجا ذخیره می کند.
اگر شما یا کاربران مورد نظرتان در آن مناطق قرار ندارید، منطقه ای را انتخاب کنید که به شما نزدیک است تا تاخیر را به حداقل برسانید. به عنوان مثال:
- اگر در آمریکای لاتین هستید، منطقه آمریکای شمالی را انتخاب کنید.
- اگر در آفریقا هستید، منطقه اروپا را انتخاب کنید.
- اگر در استرالیا هستید، منطقه آسیا و اقیانوسیه را انتخاب کنید.
منطقه نماینده خود را بر اساس حامل های هدف خود تعیین نکنید. همه مناطق دسترسی برابر به اپراتورها در سراسر جهان دارند.
دسته صورتحساب نماینده را تعیین کنید
هنگام ایجاد یک عامل RBM، باید دسته صورتحساب آن را بر اساس نحوه تعامل نماینده با کاربران مشخص کنید. دسته ای را انتخاب کنید که بیشتر با رفتار مورد نظر نماینده شما مطابقت دارد:
- مکالمه : برای عواملی که در مکالمات چند نوبتی با کاربران شرکت می کنند.
- پیام اصلی یا پیام واحد : برای نمایندگانی که بدون انتظار پاسخ های مکرر پیام ارسال می کنند.
فقط می‌توانید دسته صورتحساب نماینده خود را قبل از راه‌اندازی تغییر دهید. اگر پس از راه‌اندازی نیاز به تغییر دسته صورتحساب دارید، به rbm-support@google.com ایمیل بزنید.
برای اطلاعات بیشتر در مورد مدل صورتحساب RBM، به پرسش‌های متداول صورتحساب RBM مراجعه کنید.
مورد استفاده عامل را شناسایی کنید
هر عامل RBM باید یک مورد استفاده از پیش تعریف شده داشته باشد. این به دسته بندی نماینده خود و اعمال قوانین تجاری مناسب برای تجربه کاربری خوب کمک می کند. RBM از چهار مورد استفاده پشتیبانی می کند:
- OTP : گذرواژه های یکبار مصرف برای احراز هویت ایمن یک حساب یا تأیید تراکنش مورد نیاز است.
- تراکنشی : اعلان‌ها، به‌روزرسانی‌ها یا هشدارهایی که اطلاعاتی را به اشتراک می‌گذارند که مستقیماً مربوط به خدمات یا محصولات موجود مشتری است، مانند هشدارهای مربوط به فعالیت‌های مشکوک حساب، تأییدیه‌های خرید و اعلان‌های ارسال.
- تبلیغاتی : فروش، بازاریابی و پیام های تبلیغاتی به مشتریان جدید یا موجود، با هدف افزایش آگاهی، تعامل و فروش.
- چند منظوره : مکالماتی که پیام‌های تراکنشی و تبلیغاتی را با هم ترکیب می‌کنند، مانند ارسال اعلان حساب و به دنبال آن پیشنهاد تخفیف یا ارتقا به محصول یا خدمات جدید.
هر مورد استفاده قوانین متفاوتی در مورد آنچه می توانید ارسال کنید دارد. برای کسب اطلاعات بیشتر در مورد هر مورد و یافتن بهترین مناسب برای نماینده خود، به انتخاب مورد استفاده مناسب برای نماینده خود مراجعه کنید.
هنگامی که نماینده خود را برای راه اندازی ارسال کردید، نمی توانید مورد استفاده را تغییر دهید. قبل از ارسال نماینده ، موارد استفاده و قوانین تجاری کشورتان را بررسی کنید.
عامل ایجاد کنید
برای ایجاد نماینده خود در Business Communications Developer Console این دستورالعمل ها را دنبال کنید.
برای ایجاد یک عامل:
- به کنسول توسعه دهنده ارتباطات تجاری بروید و با حساب Google شریک RBM خود وارد شوید.
- در صفحه اصلی، روی + ایجاد عامل کلیک کنید.
- در پنجره New RCS Business Messaging 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 را مرور کنید و یاد بگیرید که چگونه نماینده ها پیام ها را ارسال و دریافت می کنند .