php-rest-api
php-rest-api copied to clipboard
This repository contains the open source PHP client for MessageBird's REST API.
MessageBird's REST API for PHP
This repository contains the open source PHP client for MessageBird's REST API. Documentation can be found at: https://developers.messagebird.com/
Requirements
- Sign up for a free MessageBird account
- Create a new access_key in the developers sections
- MessageBird API client for PHP requires PHP >= 7.3.
Installation
Composer installation
- Download composer
- Run
composer require messagebird/php-rest-api.
Manual installation
When you do not use Composer. You can git checkout or download this repository and include the MessageBird API client manually.
Usage
We have put some self-explanatory examples in the examples directory, but here is a quick breakdown on how it works. First, you need to set up a MessageBird\Client. Be sure to replace YOUR_ACCESS_KEY with something real.
require 'autoload.php';
$messageBird = new \MessageBird\Client('YOUR_ACCESS_KEY');
That's easy enough. Now we can query the server for information. Lets use getting your balance overview as an example:
// Get your balance
$balance = $messageBird->balance->read();
Conversations WhatsApp Sandbox
To use the WhatsApp sandbox you need to add \MessageBird\Client::ENABLE_CONVERSATIONSAPI_WHATSAPP_SANDBOX to the list of features you want enabled. Don't forget to replace YOUR_ACCESS_KEY with your actual access key.
$messageBird = new \MessageBird\Client('YOUR_ACCESS_KEY', null, [\MessageBird\Client::ENABLE_CONVERSATIONSAPI_WHATSAPP_SANDBOX]);
If you use a custom HttpClient you will have to manually direct Conversation API request to the WhatsApp sandbox endpoint.
Documentation
Complete documentation, instructions, and examples are available at: https://developers.messagebird.com/
License
The MessageBird REST Client for PHP is licensed under The BSD 2-Clause License. Copyright (c) 2014, MessageBird