Weave Code
Africastalking Laravel Package
m-shule/africastalking
Laravel package for integrating Africa's Talking services, with wrappers for sending SMS, handling USSD sessions, disbursing airtime and mobile payments. Provides config-based setup and facades, though adoption is minimal and documentation is limited.
AfricasTalking notifications channel for Laravel 5.3+
Frequently asked questions about Africastalking
- How do I install m-shule/africastalking in a Laravel app?
- Install the package with Composer using your normal Laravel package workflow, then publish any package config and add your Africa's Talking credentials to the environment file. Because documentation is limited, check the repository README and config files for the exact publish tag and environment variable names before wiring it into production.
- Which Laravel and PHP versions does m-shule/africastalking support?
- The package is described as an Africa's Talking notifications channel for Laravel 5.3 and later, but the provided context does not include a full compatibility matrix. Version 2.0.3 mainly adds support for Africa's Talking SDK v3.0. Verify the Laravel, PHP, and SDK constraints in composer.json and test against your target versions before adopting.
- Does m-shule/africastalking support Africa's Talking SDK v3.0?
- Yes. Version 2.0.3 is a dependency-compatibility release that adds support for SDK v3.0. The package itself has no stated feature additions, deprecations, or breaking changes, but the underlying SDK major-version change is material. Confirm whether SDK 2.x remains supported and audit any code that calls SDK classes directly.
- How do I configure Africa's Talking credentials in Laravel?
- The package advertises config-based setup, so after publishing the config you should set credentials such as the Africa's Talking username and API key through environment variables. Because documentation is limited, inspect the package config file for the exact keys and expected values. If you run a multi-tenant application, verify whether credentials can be resolved per tenant rather than only from global config.
- Can I send SMS through Laravel notifications with this package?
- Yes, the package is built as an Africa's Talking notifications channel for Laravel, so it is intended for sending SMS through Laravel's notification system. It also mentions facades and wrappers for other Africa's Talking services. Validate the notification channel setup with sandbox credentials and a small contract test before using it for business-critical messages.
- Does this package handle USSD sessions and mobile payments?
- The package overview mentions wrappers for USSD sessions, airtime disbursement, and mobile payments in addition to SMS. These wrappers are likely thin abstractions over the official Africa's Talking PHP SDK. Verify method signatures, response shapes, and error handling in the repository before building core USSD or payment flows on top of them.
- Is m-shule/africastalking suitable for production SMS and OTP flows?
- It can reduce time-to-first-SMS in a Laravel application that already uses notifications, queues, events, and configuration, but it should be treated as an adapter rather than a complete SMS platform. For core OTP or SMS flows, wrap it behind an internal interface and add contract tests, delivery tracking, and a multi-provider failover plan. Also assess maintainer activity, test coverage, and documentation gaps before production use.
- How does the package handle Africa's Talking API errors and insufficient balance?
- The provided context does not document specific error mapping or insufficient-balance handling in the package. Because it likely wraps the official SDK, API errors may surface as SDK exceptions or altered response shapes. Verify exception types and failure behavior against SDK v3.0, and add tests for error and insufficient-balance scenarios.
- Does m-shule/africastalking support queues, retries, and rate limiting?
- Laravel notifications can be queued, but the package's own support for retries, rate limiting, idempotency, and delivery-report webhooks is not established in the provided context. Treat queueing as a Laravel application concern and implement retry and rate-limit logic in your own layer where needed. Confirm delivery-report and webhook handling separately before relying on it for high-volume SMS.
- What are alternatives to m-shule/africastalking for Laravel SMS integration?
- Alternatives include the official africastalking/africastalking PHP SDK, direct HTTP integration with Africa's Talking APIs, or other Laravel SMS notification packages. This package is most compelling for Laravel monoliths or modular Laravel services that want a framework-native adapter. For non-Laravel services or stricter provider abstraction, the official SDK or direct HTTP integration may be a cleaner boundary.
Weaver
How can I help you explore Laravel packages today?