فینوتکست — ارسال پیامک گروهی

کاربرد کسب‌وکاری (نسخه Client Credential بدون رضایت پیامکی): سرویس ارسال پیامک؛ هنگامی به کار می‌رود که قصد دارید با یک سرشماره، پیامک گروهی ارسال کنید.

مستندات فنی

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

فینوتکست — ارسال پیامک گروهی چه مشکلی را حل می‌کند؟

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

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

کاربردهای فینوتکست — ارسال پیامک گروهی

  • بانکداری و پرداخت — اعلام نتیجه تراکنش، تأیید واریز و یادآوری سقف‌های مصرف برای فهرستی از مشتریان در یک فراخوانی ارسال می‌شود.
  • لیزینگ، اقساط و خرید اعتباری — یادآوری سررسید قسط با مبلغ و تاریخ شخصی‌سازی‌شده برای هر بدهکار، بدون نیاز به ارسال تک‌تک.
  • بیمه — اطلاع‌رسانی پایان اعتبار بیمه‌نامه و مراحل تمدید به گروهی از بیمه‌گزاران در یک زمان‌بندی مشخص.
  • فروشگاه‌های اینترنتی و مارکت‌پلیس — اعلام تغییر وضعیت سفارش و ارسال مرسوله برای فهرست خریداران یک بازه زمانی.
  • پلتفرم‌های چندفروشندگی — اطلاع‌رسانی دوره تسویه و مبلغ واریزی به فروشندگان، با متنی که برای هر فروشنده متفاوت است.
  • سامانه‌های اداری و منابع انسانی — ارسال اطلاعیه‌های سازمانی و یادآوری‌های دوره‌ای به فهرست کارکنان یا اعضا.

مزایای فینوتکست — ارسال پیامک گروهی

  • متن شخصی‌سازی‌شده در ارسال گروهی — چون فهرست شماره‌ها و فهرست متن‌ها تناظر یک‌به‌یک دارند، هر مخاطب متن مخصوص خودش را می‌گیرد و لازم نیست برای هر نفر یک درخواست جدا بفرستید.
  • ارسال با سرشماره اختصاصی کلاینت — پیام‌ها از سرشماره‌ای که به کلاینت شما اختصاص یافته است ارسال می‌شود و برای مخاطب شناخته‌شده می‌ماند.
  • بازخورد کمی برای کنترل ارسال — تعداد شماره‌هایی که پیام برایشان ارسال شده و مجموع تعداد پیامک‌ها در پاسخ می‌آید و می‌توانید آن را با فهرست ورودی خود مقایسه کنید.
  • پاک‌سازی خودکار شماره‌های نامعتبر — شماره‌های نامعتبر از فهرست حذف می‌شوند و کل ارسال به‌خاطر چند رکورد اشتباه متوقف نمی‌شود.
  • قابلیت پیگیری پس از ارسال — با نگه‌داشتن شناسه پیگیری فراخوانی، وضعیت تحویل همان دسته را بعداً می‌توانید استعلام کنید.

چه چیزی از فینوتکست — ارسال پیامک گروهی دریافت می‌کنید؟

جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.

جریان کار فینوتکست — ارسال پیامک گروهی

  • ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ facility:finnotext:post توکن Client Credential بگیرید.
  • ۲. آماده‌سازی فهرست ارسال — سرشماره اختصاصی، فهرست شماره‌های مقصد و فهرست متن‌های متناظر را با طول برابر بسازید.
  • ۳. ارسال درخواست — درخواست را همراه یک trackId یکتا بفرستید و آن شناسه را در سمت خود ذخیره کنید.
  • ۴. خواندن پاسخ — تعداد شماره‌های ارسال‌شده و مجموع پیامک‌ها را با فهرست ورودی مقایسه کنید تا اختلاف‌ها را تشخیص دهید.
  • ۵. پیگیری وضعیت تحویل — با همان شناسه پیگیری، وضعیت هر پیام را از استعلام فینوتکست بگیرید یا از وب‌هوک دریافت وضعیت پیامک استفاده کنید.

نحوه شروع فینوتکست — ارسال پیامک گروهی

این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی می‌شود. اسکوپ مورد نیاز: facility:finnotext:post. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیاده‌سازی استفاده کنید.

محدودیت‌ها و نکات فینوتکست — ارسال پیامک گروهی

  • فهرست شماره‌های مقصد و فهرست متن پیام‌ها باید تناظر یک‌به‌یک و طول برابر داشته باشند؛ در غیر این صورت ارسال با ورودی نامعتبر روبه‌رو می‌شود.
  • شماره‌های نامعتبر از فهرست حذف می‌شوند، بنابراین تعداد ارسال‌های موفق در پاسخ می‌تواند کمتر از تعداد رکوردهای ورودی شما باشد؛ این اختلاف را در گزارش‌های خود ثبت کنید.
  • سرشماره ارسال باید همان سرشماره اختصاص‌یافته به کلاینت شما باشد.
  • شناسه پیگیری هر فراخوانی حداکثر ۴۰ کاراکتر حرف و عدد است و استفاده از UUID توصیه می‌شود؛ آن را یکتا نگه دارید، چون کلید استعلام وضعیت همان دسته است.
  • پاسخ موفق این فراخوانی به معنای پذیرش ارسال است، نه تضمین تحویل به مخاطب؛ برای وضعیت تحویل از سرویس استعلام یا وب‌هوک وضعیت استفاده کنید.
  • متن پیام را کمینه نگه دارید و داده حساس مشتری را در آن قرار ندهید؛ متن پیامک روی گوشی مخاطب و در سوابق سامانه شما باقی می‌ماند.

سوالات متداول فینوتکست — ارسال پیامک گروهی

«فینوتکست — ارسال پیامک گروهی» چیست؟

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

تفاوت این سرویس با ارسال پیامک کد تأیید چیست؟

این سرویس برای ارسال گروهی و اطلاع‌رسانی به فهرستی از مخاطبان است؛ اگر می‌خواهید یک کد تأیید را به یک شماره بفرستید، ارسال پیامک کد تأیید (OTP) مناسب‌تر است.

چطور بفهمم پیامک به دست مخاطب رسیده است؟

پاسخ این فراخوانی فقط پذیرش ارسال را نشان می‌دهد؛ وضعیت تحویل هر پیام را با استعلام فینوتکست بگیرید یا آن را از طریق وب‌هوک دریافت وضعیت پیامک دریافت کنید.

آیا می‌توانم برای هر مخاطب متن متفاوتی بفرستم؟

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

مستندات فنی این سرویس کجاست؟

صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.

چه نوع احراز هویتی لازم است؟

Grant type: client_credentials. جزئیات در راهنمای توکن.

آیا رضایت پیامکی کاربر لازم است؟

خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.

مستندات فنی فینوتکست — ارسال پیامک گروهی

مشاهده مستندات فنی «فینوتکست — ارسال پیامک گروهی» — endpoint، پارامترها، نمونه درخواست و پاسخ.

سرویس‌های مرتبط با فینوتکست — ارسال پیامک گروهی