Skip to content
message-circle

GitHub Action

Africastalking SMS Action

v2.0.1 Latest version

Africastalking SMS Action

message-circle

Africastalking SMS Action

Send an SMS from GitHub Actions using Africastalking Programmable SMS

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Africastalking SMS Action

uses: alphaolomi/[email protected]

Learn more about this action in alphaolomi/actions-africastalking

Choose a version

📨 Africastalking SMS Action

A GitHub Action to send a text message to mobile number of choice using Africastalking Programmable SMS

Usage

  1. Create a .github/workflows/sms.yml file in your repository.
  2. Add the following content to the sms.yml file:
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 }}
  1. Add the following secrets to your repository:
  • AT_API_KEY - Your Africastalking API Key
  • AT_USERNAME - Your Africastalking Username

Inputs

  • AT_API_KEY Required. You can get this from the Africastalking's Dashboard.
  • AT_USERNAME Required. Use 'sandbox' as the value for development in the test environment
  • fromPhoneNumber Required. The name or number the message will appear to be sent from. This can be a valid phone number or an alphanumeric string. For example, INFO or +255711XXXYYY.
  • toPhoneNumber Required. The mobile number the message will be sent to. This should include the country code, without any leading zeros. For example, 255711XXXYYY for a Tanzanian number.
  • message Required. The text content of the message. The maximum characters allowed is 160 per message. If you exceed this limit, the message will be split into multiple messages, each of which will be charged separately.

Outputs

  • messageId - The ID of the message sent

Authors

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

If you like this project

Give a ⭐️ if this project helped you!

📝 License

This project is MIT licensed.