PHPackages                             messagemedia/conversations - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. messagemedia/conversations

ActiveLibrary[API Development](/categories/api)

messagemedia/conversations
==========================

The Conversations API allows users to communicate by sending and receiving messages via Over-The-Top (OTT) messaging services. OTT application is an app or service that provides a product over the Internet and bypasses traditional distribution. Here's an in-depth explanation of what the term means.This feature is disabled by default. To enable it, you don't need to make any changes to your application, just an account configuration change by MessageMedia's support team support@messagemedia.com.For our initial release, we're releasing Facebook Messenger which allows you to send messages as a Facebook page owner and receive messages from other Facebook users.

1.0.0(7y ago)25MITPHPPHP >=5.4.0

Since Jun 28Pushed 7y ago4 watchersCompare

[ Source](https://github.com/messagemedia/conversations-php-sdk)[ Packagist](https://packagist.org/packages/messagemedia/conversations)[ Docs](https://messagemedia.com.au)[ RSS](/packages/messagemedia-conversations/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

MessageMedia Conversations PHP SDK
==================================

[](#messagemedia-conversations-php-sdk)

[![PHP version](https://camo.githubusercontent.com/e8348f7180f33bc727f76011aed22a610bc653c62bf4366c25a0df17d54d6fdc/68747470733a2f2f62616467652e667572792e696f2f70682f6d6573736167656d65646961253246636f6e766572736174696f6e732e737667)](https://badge.fury.io/ph/messagemedia%2Fconversations)

⚠️ **Please note the API documented is in beta and is subject to breaking changes in the short term.** ⚠️

The MessageMedia Conversations API allows users to communicate by sending and receiving messages via OTT messaging services. This feature is disabled by default. To enable it, you don't need to make any changes to your application, just an account configuration change by MessageMedia's support team ().

⭐️ Installing via Composer
--------------------------

[](#️-installing-via-composer)

Run the Composer command to install the latest stable version of the Messages SDK:

```
composer require messagemedia/conversations-sdk

```

🎬 Get Started
-------------

[](#-get-started)

It's easy to get started. Simply enter the API Key and secret you obtained from the [MessageMedia Developers Portal](https://developers.messagemedia.com) into the code snippet below.

### 🚀 Provision an account

[](#-provision-an-account)

```
require_once('vendor/autoload.php');

$basicAuthUserName = 'basicAuthUserName'; // The username to use with basic authentication
$basicAuthPassword = 'basicAuthPassword'; // The password to use with basic authentication

$client = new MessageMediaConversationsLib\MessageMediaConversationsClient($basicAuthUserName, $basicAuthPassword);

$provisioning = $client->getConfiguration();
$bodyValue = "{    \"name\": \"Rainbow Serpent Festival\",    \"callback_url\": \"https://callback.url.com\"}";
$body = MessageMediaConversationsLib\APIHelper::deserialize($bodyValue);
$configuration->createConfigureAccount($body);
```

### 🔐 Facebook Authorization

[](#-facebook-authorization)

```
require_once('vendor/autoload.php');

$basicAuthUserName = 'basicAuthUserName'; // The username to use with basic authentication
$basicAuthPassword = 'basicAuthPassword'; // The password to use with basic authentication

$client = new MessageMediaConversationsLib\MessageMediaConversationsClient($basicAuthUserName, $basicAuthPassword);

$facebook = $client->getFacebook();
$result = $facebook->getFacebookAuthorisationURL();
```

### ⬇️ Get Facebook pages

[](#️-get-facebook-pages)

```
require_once('vendor/autoload.php');

$basicAuthUserName = 'basicAuthUserName'; // The username to use with basic authentication
$basicAuthPassword = 'basicAuthPassword'; // The password to use with basic authentication

$client = new MessageMediaConversationsLib\MessageMediaConversationsClient($basicAuthUserName, $basicAuthPassword);
$facebook = $client->getFacebook();
$result = $facebook->getFacebookPages();
```

### ♻️ Integrate Facebook page

[](#️-integrate-facebook-page)

You can get the facebookPageId by looking at the response of the Get Facebook pages example.

```
require_once('vendor/autoload.php');

$basicAuthUserName = 'basicAuthUserName'; // The username to use with basic authentication
$basicAuthPassword = 'basicAuthPassword'; // The password to use with basic authentication

$client = new MessageMediaConversationsLib\MessageMediaConversationsClient($basicAuthUserName, $basicAuthPassword);
$facebook = $client->getFacebook();

$facebookPageId = 'facebookPageId';

$facebook->createIntegrateFacebookPage($facebookPageId);
```

### 👤 Get users

[](#-get-users)

```
require_once('vendor/autoload.php');

$basicAuthUserName = 'basicAuthUserName'; // The username to use with basic authentication
$basicAuthPassword = 'basicAuthPassword'; // The password to use with basic authentication

$client = new MessageMediaConversationsLib\MessageMediaConversationsClient($basicAuthUserName, $basicAuthPassword);
$appUsers = $client->getAppUsers();

$result = $appUsers->getAppUsers();
```

### 💬 Get user messages

[](#-get-user-messages)

You can get the appUserId from the response of the Get users example.

```
require_once('vendor/autoload.php');

$basicAuthUserName = 'basicAuthUserName'; // The username to use with basic authentication
$basicAuthPassword = 'basicAuthPassword'; // The password to use with basic authentication

$client = new MessageMediaConversationsLib\MessageMediaConversationsClient($basicAuthUserName, $basicAuthPassword);
$appUsers = $client->getAppUsers();
$appUserId = 'appUserId';

$result = $appUsers->getAppUserMessages($appUserId);
```

### ✉️ Send message to user

[](#️-send-message-to-user)

You can get the appUserId from the response of the Get users example.

```
require_once('vendor/autoload.php');

$basicAuthUserName = 'basicAuthUserName'; // The username to use with basic authentication
$basicAuthPassword = 'basicAuthPassword'; // The password to use with basic authentication

$client = new MessageMediaConversationsLib\MessageMediaConversationsClient($basicAuthUserName, $basicAuthPassword);
$appUsers = $client->getAppUsers();
$appUserId = 'appUserId';
$body = new BaseMessageDto({"key":"value"});

$appUsers->createSendMessage($appUserId, $body);
```

📕 Documentation
---------------

[](#-documentation)

Check out the [full API documentation](DOCUMENTATION.md) for more detailed information.

😕 Need help?
------------

[](#-need-help)

Please contact developer support at  or check out the developer portal at [developers.messagemedia.com](https://developers.messagemedia.com/)

📃 License
---------

[](#-license)

Apache License. See the [LICENSE](LICENSE) file.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 94.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2873d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/154d8755fbdd69e7e0297356c815fe61a5d9983a302b26455d96219659061655?d=identicon)[messagemedia](/maintainers/messagemedia)

---

Top Contributors

[![IbrahimTareq](https://avatars.githubusercontent.com/u/12100715?v=4)](https://github.com/IbrahimTareq "IbrahimTareq (17 commits)")[![JamesDale](https://avatars.githubusercontent.com/u/10896308?v=4)](https://github.com/JamesDale "JamesDale (1 commits)")

---

Tags

apiconversationsmessagingottphpapisdk

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/messagemedia-conversations/health.svg)

```
[![Health](https://phpackages.com/badges/messagemedia-conversations/health.svg)](https://phpackages.com/packages/messagemedia-conversations)
```

###  Alternatives

[bandwidth/sdk

Bandwidth's set of APIs

16948.8k1](/packages/bandwidth-sdk)[messagemedia/messages-sdk

The MessageMedia Messages API provides a number of endpoints for building powerful two-way messaging applications.

13390.6k](/packages/messagemedia-messages-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)