README

This is a simple Laravel Service Provider providing access to the RingCentral API.

Forked from https://github.com/coxlr/laravel-ringcentral, Created by Lee Cox With code from: RingCentral Connect Platform PHP SDK

Installation

This package requires PHP 8.0 and Laravel 8 or higher.

To install the PHP client library using Composer:

composer require sheavescapital/laravel-ringcentral

The package will automatically register the RingCentral provider and facade.

You can publish the config file with:

php artisan vendor:publish --provider="SheavesCapital\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_JWT=my_jwt
RINGCENTRAL_VERIFICATION_TOKEN=my_verification_token

This package uses the JWT autentication method. You can learn more about setting up JWT for your RingCentral account here.

Usage

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

Sending an SMS message

RingCentral::sendMessage([
    'from' => '18042221111',
    '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

Retrieving Extensions

RingCentral::getExtensions();

Or

$ringcentral = app('ringcentral');

$ringcentral->getExtensions();

Get messages sent and received for a given extension

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

Get a messages attachment

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

Or

$ringcentral = app('ringcentral');

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

Parameters

License

The MIT License (MIT). Please see License File for more information.