README

Messente API 版本：2.0.0
PHP 艺术品版本：3.2.0

Messente 是一家全球性的消息和用户验证服务提供商。* 发送和接收 SMS、Viber、WhatsApp 和 Telegram 消息。* 管理联系人和群组。* 获取有关电话号码的详细信息。* 将电话号码列入黑名单，以确保您不会发送任何不想要的短信。Messente 开发了工具，帮助组织将他们的服务与世界各地的人连接起来。

安装

使用 composer require messente/messente-api-php 安装 Messente API 库。

功能

Messente API 具有以下功能

全渠道 (外部文档)
电话簿 (外部文档)

Messente API 库提供了以下操作，以访问这些功能。

BlacklistApi

将电话号码添加到黑名单 addToBlacklist
从黑名单中删除电话号码 deleteFromBlacklist
返回所有黑名单电话号码 fetchBlacklist
检查电话号码是否被列入黑名单 isBlacklisted

BulkMessagingApi

发送批量 Omnimessage sendBulkOmnimessage

ContactsApi

将联系人添加到群组 addContactToGroup
创建新的联系人 createContact
删除联系人 deleteContact
列出联系人 fetchContact
列出联系人的群组 fetchContactGroups
返回所有联系人 fetchContacts
从群组中删除联系人 removeContactFromGroup
更新联系人 updateContact

DeliveryReportApi

获取Omnimessage的投递报告 retrieveDeliveryReport

GroupsApi

使用提供的名称创建新的组 createGroup
删除组 deleteGroup
列出组 fetchGroup
返回所有组 fetchGroups
使用提供的名称更新组 updateGroup

NumberLookupApi

请求有关电话号码的信息 fetchInfo

OmnimessageApi

取消计划中的Omnimessage cancelScheduledMessage
发送Omnimessage sendOmnimessage

StatisticsApi

请求每个国家的统计数据报告 createStatisticsReport

Auth

类型: HTTP基本认证

阅读外部入门文章，其中解释了API密钥和发送者ID逻辑。

入门：发送Omnimessage

<?php
require_once(__DIR__ . '/../vendor/autoload.php');

use Messente\Api\Api\OmnimessageApi;
use Messente\Api\Model\Omnimessage;
use Messente\Api\Configuration;
use Messente\Api\Model\WhatsApp;
use Messente\Api\Model\WhatsAppParameter;
use Messente\Api\Model\WhatsAppComponent;
use Messente\Api\Model\WhatsAppLanguage;
use Messente\Api\Model\WhatsAppTemplate;


// Configure HTTP basic authorization: basicAuth
$config = Configuration::getDefaultConfiguration()
    ->setUsername('<MESSENTE_API_USERNAME>')
    ->setPassword('<MESSENTE_API_PASSWORD>');

$apiInstance = new OmnimessageApi(
    new GuzzleHttp\Client(),
    $config
);

$omnimessage = new Omnimessage([
    "to" => "<phone number in e.164 format>"
]);

$viber = new Viber(
    ["text" => "Hello Viber!", "sender" => "MyViberSender"]
);

$sms = new SMS(
    ["text" => "Hello SMS!", "sender" => "MySmsSender"]
);

$whatsAppParameters = [new WhatsAppParameter(['type' => 'text', 'text' => 'hello whatsapp'])];
$whatsAppComponent = new WhatsAppComponent(['type' => 'body', 'parameters' => $whatsAppParameters]);
$whatsAppLanguage = new WhatsAppLanguage(['code' => '<language_code>']);
$whatsAppTemplate = new WhatsAppTemplate(
    [
        'name'=> '<template_name>',
        'language'=> $whatsAppLanguage,
        'components' => [$whatsAppComponent]
    ]
);

$whatsapp = new WhatsApp(
    [
        'sender' => '<sender name (optional)>',
        'template' => $whatsAppTemplate,
    ]
);

$omnimessage->setMessages([$whatsapp, $viber, $sms]);


try {
    $result = $apiInstance->sendOmnimessage($omnimessage);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling sendOmnimessage: ', $e->getMessage(), PHP_EOL;
}
?>

许可证

Apache-2.0

条款

https://messente.com/terms-and-conditions

messente / messente-api-php

维护者

详细信息