هرگز اعلان‌ها را با استفاده از SMS Github Action از دست ندهید

به عنوان یک مهندس نرم‌افزار و علاقه‌مند به منبع باز از تانزانیا، من از نزدیک با چالش‌های دسترسی به اینترنت آشنا هستم. از دست دادن اعلان‌های مهم در حالت آفلاین یک مشکل رایج در چنین سناریوهایی است. برای رفع این مشکل، یک اکشن Github ایجاد کردم که اعلان‌های پیامکی را با استفاده از AfricasTalking Programmable SMS API به یک شماره تلفن ارسال می‌کند. این عمل تضمین می‌کند که حتی زمانی که آنلاین نیستم اعلان‌ها را دریافت می‌کنم. در این پست وبلاگ شما را با این عمل آشنا می کنم و نحوه استفاده از آن را به شما نشان می دهم.

این ایده زمانی مطرح شد که یک پروژه نیاز به یک تعمیر داغ داشت، اما من به موقع آنلاین نبودم و بنابراین می‌توانستم به موقع اقدام کنم. سپس من نمی توانم یک گردش کار راه اندازی کنم که هر زمان که درخواست/مشکل کشش ایجاد می شود، اعلان های پیامکی را به شماره تلفن ارسال کند. من توانستم با استفاده از AfricasTalking Programmable SMS API به این هدف برسم. سپس تصمیم گرفتم یک Github Action ایجاد کنم که تنظیم اعلان‌های پیامکی را برای سایر توسعه‌دهندگان آسان‌تر کند.

در سال 2020 در هکاتون GitHub Actions شرکت کردم. من اولین نسخه اکشن را در هکاتون ساختم. من توانستم با اضافه کردن پشتیبانی برای ارسال اعلان‌های پیامکی به چندین شماره تلفن، عملکرد را بهبود بخشم و قوی‌تر کنم. خوشحالم که اعلام کنم نسخه 2 اکشن اکنون در Github در دسترس است.

مراحل زیر برای استفاده از اعلان پیامک Github Action آمده است:

مرحله 1: ایجاد یک .github/workflows/sms.yml فایل در مخزن خود

مرحله 2: محتوای زیر را به آن اضافه کنید sms.yml فایل:

name: SMS Notifications
on:
  pull_request:

jobs:
  smsNotification:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: alphaolomi/actions-africastalking@main
        with:
          fromPhoneNumber: 'INFO' # or secrets.fromPhoneNumber
          toPhoneNumber: ${{ secrets.toPhoneNumber }}
          message: 'Hello World'
        env:
          AT_API_KEY: ${{ secrets.AT_API_KEY }}
          AT_USERNAME: ${{ secrets.AT_USERNAME }}`

می‌توانید پیام را طوری سفارشی کنید که رویدادی را که جریان کار را آغاز کرده است، منعکس کند. برای مثال می توانید پیامی بفرستید که می گوید A new pull request has been created هنگامی که یک درخواست کشش ایجاد می شود. شما همچنین می توانید یک پیام ارسال کنید که می گوید A pull request has been merged هنگامی که یک درخواست کشش ادغام می شود. شما همچنین می توانید یک پیام ارسال کنید که می گوید A pull request has been closed هنگامی که یک درخواست کشش بسته می شود.

یا موارد استفاده پیشرفته تر، به عنوان مثال

message: PR \#${{ github.event.pull_request.number }} has been ${{ github.event.action }}' on ${{ github.repository }} by ${{ github.actor }}

مرحله 3: اسرار زیر را به مخزن خود اضافه کنید:

• AT_API_KEY – کلید API Africastalking شما
• AT_USERNAME – نام کاربری Africastalking شما

برای دریافت کلید API، دستورالعمل‌های موجود در وب‌سایت AfricasTalking را دنبال کنید.

اعلان پیامک Github Action یک پیام اعلان به شماره تلفن مشخص شده در آن ارسال می کند toPhoneNumber فیلد با پیام مشخص شده در message رشته. همچنین می توانید a را مشخص کنید fromPhoneNumber فیلد برای تنظیم شماره تلفنی که پیام از آن ارسال خواهد شد. اگر نمی خواهید شماره تلفن خود را فاش کنید، می توانید از آن استفاده کنید secrets.fromPhoneNumber فیلد برای مشخص کردن یک راز

در پایان، با این Github Actions، می‌توانید موارد استفاده زیادی را سیم‌کشی کنید و این تنها یکی از آنهاست. این می تواند به ویژه برای توسعه دهندگان و رهبران جامعه در مناطقی که دسترسی به اینترنت چالش برانگیز است مفید باشد. با استفاده از AfricasTalking SMS API، می توانید به راحتی اعلان های پیامکی را در گردش کار خود تنظیم کنید. اعلان پیامک Github Action در Github موجود است، و من شما را تشویق می کنم آن را امتحان کنید.

name: SMS Notification
on:
  pull_request:

jobs:
  smsNotification:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: alphaolomi/actions-africastalking@main
        with:
          fromPhoneNumber: 'INFO' # or secrets.fromPhoneNumber
          toPhoneNumber: ${{ secrets.toPhoneNumber }}
          message: 'Hello World'
        env:
          AT_API_KEY: ${{ secrets.AT_API_KEY }}
          AT_USERNAME: ${{ secrets.AT_USERNAME }}