PHPackages                             coxlr/laravel-ringcentral - 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. coxlr/laravel-ringcentral

ActiveLibrary[API Development](/categories/api)

coxlr/laravel-ringcentral
=========================

A Laravel package for the RingCentral SDK for PHP

3.2.1(1y ago)517.2k↓14.3%4MITPHPPHP ^8.2CI passing

Since Oct 16Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/coxlr/laravel-ringcentral)[ Packagist](https://packagist.org/packages/coxlr/laravel-ringcentral)[ Docs](https://github.com/coxlr/laravel-ringcentral)[ RSS](/packages/coxlr-laravel-ringcentral/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (11)Used By (0)

A Laravel package for the RingCentral SDK for PHP
=================================================

[](#a-laravel-package-for-the-ringcentral-sdk-for-php)

[![Latest Version on Packagist](https://camo.githubusercontent.com/1397206eca27e9173db63e6faab6e2fc35331913fa175b5c30605b450bb7240e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636f786c722f6c61726176656c2d72696e6763656e7472616c2e7376673f7374796c653d666c61742d737175617265)](https://img.shields.io/packagist/v/coxlr/laravel-ringcentral.svg?style=flat-squaretps://packagist.org/packages/coxlr/laravel-ringcentral)[![Tests](https://github.com/coxlr/laravel-ringcentral/actions/workflows/run-tests.yml/badge.svg)](https://github.com/coxlr/laravel-ringcentral/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/93c5452c22e9994d4d600a1de9e1be4f0bd0b2ff98802e23411cd8a4d768170c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636f786c722f6c61726176656c2d72696e6763656e7472616c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/coxlr/laravel-ringcentral)

This is a simple Laravel Service Provider providing access to the [RingCentral SDK for PHP](https://github.com/ringcentral/ringcentral-php).

Installation
------------

[](#installation)

This package requires PHP 8.0 and Laravel 8 or higher.

To install the PHP client library using Composer:

```
composer require coxlr/laravel-ringcentral
```

The package will automatically register the `RingCentral` provider and facade.

You can publish the config file with:

```
php artisan vendor:publish --provider="Coxlr\RingCentral\RingCentralServiceProvider" --tag="config"
```

Then update `config/ringcentral.php` with your credentials. Alternatively, you can update your `.env` file with the following:

```
RINGCENTRAL_CLIENT_ID=my_client_id
RINGCENTRAL_CLIENT_SECRET=my_client_secret
RINGCENTRAL_SERVER_URL=my_server_url
RINGCENTRAL_USERNAME=my_username
RINGCENTRAL_OPERATOR_TOKEN=my_operator_jwt

#If admin details are a different extension to the operator
RINGCENTRAL_ADMIN_TOKEN=my_admin_jwt
```

This package uses the JWT autentication method. You can learn more about setting up JWT for your RingCentral account [here](https://developers.ringcentral.com/guide/authentication/jwt/quick-start).

Usage
-----

[](#usage)

To use the RingCentral Client Library you can use the facade, or request the instance from the service container.

### Sending an SMS message (requires login in extension to be company operator)

[](#sending-an-sms-message-requires-login-in-extension-to-be-company-operator)

```
RingCentral::sendMessage([
    'to'   => '18042221111',
    'text' => 'Using the facade to send a message.'
]);
```

Or

```
$ringcentral = app('ringcentral');

$ringcentral->sendMessage([
    'to'   => '18042221111',
    'text' => 'Using the instance to send a message.'
]);
```

#### Properties

[](#properties)

NameRequiredTypeDefaultDescriptiontotrueStringThe number to send the message to, must include country codetexttrueStringThe text of the message to send### Retrieving Extensions (requires admin access)

[](#retrieving-extensions-requires-admin-access)

```
RingCentral::getExtensions();
```

Or

```
$ringcentral = app('ringcentral');

$ringcentral->getExtensions();
```

### Get messages sent and received for the operator

[](#get-messages-sent-and-received-for-the-operator)

```
RingCentral::getOperatorMessages();
```

Or

```
$ringcentral = app('ringcentral');

$ringcentral->getOperatorMessages();
```

The default from date is the previous 24 hours, to specify the date to search from pass the require date as a parameter.

```
RingCentral::getOperatorMessages((new \DateTime())->modify('-1 hours'));
```

#### Parameters

[](#parameters)

NameRequiredTypeDefaultDescriptionfromDatefalseObjectThe date and time to start the search from must be a PHP date objecttoDatefalseObjectThe date and time to end the search must be a PHP date objectperPagefalseInt100The number of records to return per page### Get messages sent and received for a given extension (Needs admin access)

[](#get-messages-sent-and-received-for-a-given-extension-needs-admin-access)

```
RingCentral::getMessagesForExtensionId(12345678);
```

Or

```
$ringcentral = app('ringcentral');

$ringcentral->getMessagesForExtensionId(12345678);
```

The default from date is the previous 24 hours, to specficy the date to search from pass the require date as a parameter.

```
RingCentral::getMessagesForExtensionId(12345678, (new \DateTime())->modify('-1 hours'));
```

#### Parameters

[](#parameters-1)

NameRequiredTypeDefaultDescriptionextensionIdtrueStringThe RingCentral extension Id of the extension to retrieve the messages forfromDatefalseObjectThe date and time to start the search from must be a PHP date objecttoDatefalseObjectThe date and time to end the search must be a PHP date objectperPagefalseInt100The number of records to return per page### Get a messages attachment (requires admin access)

[](#get-a-messages-attachment-requires-admin-access)

```
RingCentral::getMessageAttachmentById(12345678, 910111213, 45678910);
```

Or

```
$ringcentral = app('ringcentral');

$ringcentral->getMessageAttachmentById(12345678, 910111213, 45678910);
```

#### Parameters

[](#parameters-2)

NameRequiredTypeDefaultDescriptionextensionIdtrueStringThe RingCentral extension Id of the extension the messages belongs tomessageIdtrueStringThe id of the message of the the attachment belongs toattachmentIdtrueStringThe id of the attachmentFor more information on using the RingCentral client library, see the [official client library repository](https://github.com/ringcentral/ringcentral-php).

Testing
-------

[](#testing)

```
composer test
```

If using the RingCentral sandbox environment when testing set the following environment variable to true to handle sandbox message prefix.

```
RINGCENTRAL_IS_SANDBOX=true
```

An optional environment value can be set to prevent hitting RingCentral rate limits when testing. This will add a delay for the set seconds before each test.

```
RINGCENTRAL_DELAY_REQUEST_SECONDS=20
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Lee Cox](https://github.com/coxlr)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance53

Moderate activity, may be stable

Popularity33

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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

Every ~177 days

Recently: every ~135 days

Total

10

Last Release

445d ago

Major Versions

1.0.0 → 2.0.02021-06-26

2.2.0 → 3.0.02023-09-08

PHP version history (3 changes)1.0.0PHP ^7.4

2.0.0PHP ^8.0

3.2.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8451762?v=4)[Lee](/maintainers/coxlr)[@coxlr](https://github.com/coxlr)

---

Top Contributors

[![coxlr](https://avatars.githubusercontent.com/u/8451762?v=4)](https://github.com/coxlr "coxlr (30 commits)")

---

Tags

laravelphpringcentrallaravelringcentralcoxlr

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/coxlr-laravel-ringcentral/health.svg)

```
[![Health](https://phpackages.com/badges/coxlr-laravel-ringcentral/health.svg)](https://phpackages.com/packages/coxlr-laravel-ringcentral)
```

###  Alternatives

[rakibdevs/openweather-laravel-api

Laravel package to connect https://openweathermap.org/ to get customized weather data for any location on the globe immediately

7648.2k](/packages/rakibdevs-openweather-laravel-api)

PHPackages © 2026

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