camoo/sms

CAMOO API 包

4.1.0 2023-11-01 17:06 UTC

README

CamooSms

PHP SMS API 通过 CAMOO SMS 网关发送短信

Build Status camoo-badge

需求

此库运行良好的最低要求。

通过 Composer 安装

该包可在 Packagist 上找到,您可以使用 Composer 安装它。

composer require camoo/sms

或者前往

Camoo-SMS-API 最新版本

下载完整版本

如果您想安装与 PHP7.4 兼容的旧版本,请使用以下命令运行 composer

composer require camoo/sms "3.2.*"

或者从 Camoo-SMS-API 旧版本 下载

快速示例

发送短信
	$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET');
	$oMessage->from ='YourCompany';
	$oMessage->to = '+237612345678';
	$oMessage->message ='Hello Kmer World! Déjà vu!';
	var_dump($oMessage->send());
向多个收件人发送相同的短信
- Per request, a max of 50 recipients can be entered.
	$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET');
	$oMessage->from ='YourCompany';
	$oMessage->to =['+237612345678', '+237612345679', '+237612345610', '+33689764530'];
	//OR from version 3.3.0
	$collection = new RecipientCollection();
        $collection->add('237612345678');
        $collection->add('237612345679');
        $collection->add('237612345610');
        $collection->add('33689764530');
        $oMessage->to = $collection;
        
	$oMessage->message ='Hello Kmer World! Déjà vu!';
	var_dump($oMessage->send());
发送非定制的发送者短信。
    $oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET');
    $oMessage->from ='WhatEver'; // will be overridden
    $oMessage->to = '+237612345678';
    // This parameter tells our system to use the classic route to send your message.
    $oMessage->route ='classic';
    $oMessage->message ='Hello Kmer World! Déjà vu!';
    var_dump($oMessage->send());
发送加密短信
Encrypt message using GPG before sending, ensure an end to end ecryption between your server and ours
	$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET');
	$oMessage->from ='YourCompany';
	$oMessage->to = '+237612345678';
	$oMessage->message ='Hello Kmer World! Déjà vu!';
	$oMessage->encrypt = true;
	var_dump($oMessage->send());
发送批量短信

在后台发送批量短信。此调用需要启用 shell_exec

	$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET');
	$oMessage->from ='YourCompany';
	$oMessage->to = ['+237612345678', '+237612345679', '+237612345610', '+33689764530', '+4917612345671'];
	$oMessage->message ='Hello Kmer World! Déjà vu!';
	var_dump($oMessage->sendBulk());
发送个性化批量短信

在后台发送批量短信。此调用需要启用 shell_exec。您应在消息中使用占位符 %NAME%,并且 to 属性应包含每个元素的 namemobile 的关联数组。请参阅以下示例

	$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET');
	$oMessage->from ='YourCompany';
	$oMessage->to = [['name' => 'John Doe', 'mobile' => '+237612345678'], ['name' => 'Jeanne Doe', 'mobile' => '+237612345679'], ['...']];
	$oMessage->message ='Hello %NAME% Kmer World! Déjà vu!';
	var_dump($oMessage->sendBulk());
通过 API 充值短信账户

自版本 >=3.3.3 起可用。

您可以直接从自己的应用程序中使用 MTN 或 Orange Mobile Money Cameroon 通过 API 充值您的 Camoo SMS 账户,无需额外费用。

// Step 1: create Top up instance
/** @var TopUp&\Camoo\Sms\Objects\TopUp $topup */
$topup = TopUp::create('YOUR_API_KEY', 'YOUR_API_SECRET');

// Step 2 Assign phone number and amount
$topup->amount = 3000;
$topup->phonenumber = '612345678';

// Step 3 Call add to top up your account. You will then receive a notification to complete the process.
$response = $topup->add();

var_dump($response);
从脚本发送批量短信

向任何系统发送大量数据显然是一个问题!因此,您应该查看我们的最佳实践建议

WordPress 插件

如果您正在寻找一个强大的 WordPress 插件来发送短信,请下载我们的 wp-camoo-sms

资源