Download the PHP package cmtelecom/messaging-php without Composer

CM Messaging SDK

Note: This project is not maintained anymore. Please use https://github.com/cmdotcom/text-sdk-php instead.

PHP SDK for easy use of CM messaging services. Built with an easy syntax your SMS, Push and/or Voice messages and send them directly with the CM services.

Simple example

Requirements

• CM account with credits, you can register here https://register.cmtelecom.com.
• Composer installed, or load manually

• PHP >= 7.2

  Installation

  Run the following command in the root of your project to add the CM Messaging SDK to your project dependencies:

composer require cmtelecom/messaging-php

And

composer require php-http/guzzle6-adapter

*When using an alternative HttpClient you don't have to add the Guzzle adapter dependency but it is recommended to use Guzzle. For advanced usage and other http clients you can look at http://docs.php-http.org/en/latest/clients.html.

Usage

Instantiate client with your product token, which can be found on the Gateway app when you login to https://gateway.cmtelecom.com.

Building a messages

To create a message you can use an easy one-liner. The required properties are from, to and body. All others can be set optional.

Sending a message

After building a message you can send it as following.

Sending a batch of messages

When you send a batch of messages, this is when you have multiple messages with different body's. You can send all of them in one request by making an array of messages. If the body is the same for all recipients you can simply add the array with the recipients phone numbers in the setTo(), you won't have to make multiple messages is this case (as shown in the simple example).

Handle response

After sending a message you get a response back that contains the accepted and failed messages. This way you can validate if the messages are processed as expected. You can do this for all messages or optionally add a phone number or an array of phone numbers to check those specific messages.

For more detailed error handling you can optionally catch RequestException, HttpException and/or NetworkException which are child's of the more generic TransferException exception.

It is also possible to retrieve the PSR-7 response, this can be done with getResponse(). The response body content can be retrieved with getResponse()->getBody()->getContents().

Advanced usage

Default properties

If you call multiple times the $client->send() method and you want certain properties for all messages send in your application you can set these properties on the $client. Properties set in the Message will still overwrite the properties set in $client.

Strategies

By default this SDK will remove duplicate phone numbers within the same message because it is assumed you don't wan't to send the exact same message twice to the same phone number at the same time. If you wan't to disable this strategy/behaviour you can add the following to you send() method.

Configuration Exceptions

Http Exceptions

Methods

Client

Message

Response

Todo

• Custom grouping support