🚀 Feature: Add Semaphore SMS Provider Adapter

Open
#121 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
65/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Quiet
Tech stack
php
Domain
backend

Research direction

Start with the Semaphore API documentation and the proposed endpoint, then inspect the existing SMS adapter conventions around src/Utopia/Messaging/Adapter/SMS/Semaphore.php. Add the adapter and its coverage in tests/Messaging/Adapter/SMS/SemaphoreTest.php, including transactional, OTP, bulk sending, credentials, and API error responses; done means the tests pass and the documented Semaphore behavior is covered.

Written by the indexing model from the issue text.

Description

🔖 Feature description

Semaphore is an SMS API provider based in the Philippines that supports bulk SMS and OTP delivery to local mobile networks including Globe, Smart, and Sun.

Why

Semaphore provides one of the most affordable SMS solutions for startups operating in the Philippines.

Proposed Changes
Add new SMS adapter

Create:

src/Utopia/Messaging/Adapter/SMS/Semaphore.php
Add tests

Create:

tests/Messaging/Adapter/SMS/SemaphoreTest.php
Features
Send transactional SMS
Send OTP messages
Support bulk SMS sending
Handle Semaphore API responses/errors
Semaphore API

Docs:
https://semaphore.co/docs

Endpoint:

POST https://api.semaphore.co/api/v4/messages
Suggested Credentials
apiKey
senderName
Notes

This provider is widely used in the Philippines and would improve regional SMS provider coverage for Appwrite/Utopia Messaging users.

🎤 Pitch

Semaphore is a popular SMS provider in the Philippines that offers affordable pricing for transactional SMS, OTP delivery, and bulk messaging. It supports major Philippine mobile networks such as Globe, Smart, and Sun.

Adding Semaphore as a provider would help developers and startups in the Philippines integrate a low-cost regional SMS solution directly into Utopia Messaging and Appwrite.

This feature would add:

  • Native Semaphore SMS adapter support
  • OTP and transactional SMS delivery
  • Bulk SMS support
  • Better regional provider coverage for Southeast Asia
👀 Have you spent some time to check if this issue has been raised before?
  • I checked and didn't find similar issue
🏢 Have you read the Code of Conduct?
Dominant language
PHP
Stars
24
Forks
70
PR merge metrics
No merged PRs in 30d

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from utopia-php/messaging

All issues in utopia-php/messaging

Similar issues

More PHP issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.