kpaph/msg4wrdio

SMS网关API

v2024.4.1 2024-04-18 06:44 UTC

This package is not auto-updated.

Last update: 2024-09-25 03:49:59 UTC


README

MSG4wrd是一个短信网关和消息转发API,之前称为PTXT4wrd。

从2005年到2012年,在菲律宾,一些网络只允许在同一网络内发送短信。有些促销活动提供无限量发送同一网络的短信,如SMART到SMART或GLOBE到GLOBE。

为了解决这个问题,发明了PTXT4wrd,它允许用户通过从自己的网络转发短信来向其他网络发送消息。

发送到其他网络的示例命令

PTXT{空格}OtherNetworkNumber{空格}YourMessage,然后发送到网关。

PTXT 09171234567 Hello world! 然后,发送到网关号码。

网关 - SMART / GLOBE / SUN 如果你聪明,你会使用SMART网关,与其他网络相同。

安装

composer require kpaph/msg4wrdio

更新composer后,将ServiceProvider添加到config/app.php中的providers数组中

KPAPH\MSG4wrdIO\MSG4wrdIOServiceProvider::class,

然后,最好发布供应商以生成配置文件config/msg4wrdio.php

php artisan vendor:publish

几乎完成了,你需要在.env中添加你的令牌,以获取令牌MSG4wrd.io

MSG4wrdIO_TOKEN=YOUR-TOKEN-HERE

要检查MSG4wrd.io是否已成功安装,请打开您的浏览器,然后访问此链接

http://your-hostname/msg4wrdhttps://:8000/msg4wrd

要检查MSG4wrd.io是否可以发送短信消息,请执行此操作

https://:8000/msg4wrd/send?number=your-ph-mobile-here

注意:手机号码应包含国家代码。例如,63或1

用法

创建控制器,比如SMSController

<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use KPAPH\MSG4wrdIO\Enums\SenderName;
use KPAPH\MSG4wrdIO\Enums\Country;
use KPAPH\MSG4wrdIO\Services\MSG4wrd;

class SMSController extends Controller
{
    // $options = [
    //     "sendername" => "Default|MSG4wrd|YourBrandID", 
    //     "priority" => 0|1, 
    //     "country" => Country::PH|Country::US
    // ]

    // sendername => Default = Typical Number or Simbased or What is available
    // sendername => MSG4wrd = This will charge you more from your credits
    // sendername => YourBrandID = You can have your own brand id, i.e.: GOOGLESMS, YAHOOMSG

    // priority => 0 = Normal
    // priority => 1 = High - This will charge you more

    // country => 0 = Philippines Only
    // country => 1 = US, Canada, and Philippines Only - This will charge you more

    public function SMSSendNormal() {

        $res = MSG4wrd::Send("US-PH-Number-Here", "Your-Message-Here");

        return $res;
    }

    public function SMSSendWithOptions() {
        
        $options = [
            "sendername" => SenderName::Default, // SenderName::MSG4wrd
            "priority" => 0, 
            "country" => Country::PH // Country::US
        ];

        $res = MSG4wrd::Send("US-PH-Number-Here", "Your-Message-Here", $options);

        return $res;
    }
}