{"id":37410013,"url":"https://github.com/coxlr/laravel-ringcentral","last_synced_at":"2026-01-16T05:55:02.779Z","repository":{"id":37349820,"uuid":"294562112","full_name":"coxlr/laravel-ringcentral","owner":"coxlr","description":"A Laravel package for the RingCentral SDK for PHP","archived":false,"fork":false,"pushed_at":"2025-09-03T17:28:37.000Z","size":39,"stargazers_count":5,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-03T04:24:21.154Z","etag":null,"topics":["laravel","php","ringcentral"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coxlr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-09-11T01:25:13.000Z","updated_at":"2025-09-03T17:28:41.000Z","dependencies_parsed_at":"2024-03-12T21:25:50.331Z","dependency_job_id":"12db3c19-f981-4bcc-b3dd-051d9eafe5a7","html_url":"https://github.com/coxlr/laravel-ringcentral","commit_stats":{"total_commits":8,"total_committers":2,"mean_commits":4.0,"dds":0.375,"last_synced_commit":"ead6635e14c11a6266bb005fce3782aff8a6c1be"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/coxlr/laravel-ringcentral","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coxlr%2Flaravel-ringcentral","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coxlr%2Flaravel-ringcentral/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coxlr%2Flaravel-ringcentral/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coxlr%2Flaravel-ringcentral/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coxlr","download_url":"https://codeload.github.com/coxlr/laravel-ringcentral/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coxlr%2Flaravel-ringcentral/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28477481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T03:13:13.607Z","status":"ssl_error","status_checked_at":"2026-01-16T03:11:47.863Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","php","ringcentral"],"created_at":"2026-01-16T05:55:02.667Z","updated_at":"2026-01-16T05:55:02.752Z","avatar_url":"https://github.com/coxlr.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A Laravel package for the RingCentral SDK for PHP\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/coxlr/laravel-ringcentral.svg?style=flat-square)](https://img.shields.io/packagist/v/coxlr/laravel-ringcentral.svg?style=flat-squaretps://packagist.org/packages/coxlr/laravel-ringcentral)\n[![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)\n[![Total Downloads](https://img.shields.io/packagist/dt/coxlr/laravel-ringcentral.svg?style=flat-square)](https://packagist.org/packages/coxlr/laravel-ringcentral)\n\n\nThis is a simple Laravel Service Provider providing access to the [RingCentral SDK for PHP][client-library].\n\n## Installation\n\nThis package requires PHP 8.0 and Laravel 8 or higher.\n\nTo install the PHP client library using Composer:\n\n```bash\ncomposer require coxlr/laravel-ringcentral\n```\n\nThe package will automatically register the `RingCentral` provider and facade.\n\n\nYou can publish the config file with:\n```bash\nphp artisan vendor:publish --provider=\"Coxlr\\RingCentral\\RingCentralServiceProvider\" --tag=\"config\"\n```\n\n\nThen update `config/ringcentral.php` with your credentials. Alternatively, you can update your `.env` file with the following:\n\n```dotenv\nRINGCENTRAL_CLIENT_ID=my_client_id\nRINGCENTRAL_CLIENT_SECRET=my_client_secret\nRINGCENTRAL_SERVER_URL=my_server_url\nRINGCENTRAL_USERNAME=my_username\nRINGCENTRAL_OPERATOR_TOKEN=my_operator_jwt\n\n#If admin details are a different extension to the operator\nRINGCENTRAL_ADMIN_TOKEN=my_admin_jwt\n```\nThis 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).\n\n## Usage\n\nTo use the RingCentral Client Library you can use the facade, or request the instance from the service container.\n\n### Sending an SMS message (requires login in extension to be company operator)\n\n```php\nRingCentral::sendMessage([\n    'to'   =\u003e '18042221111',\n    'text' =\u003e 'Using the facade to send a message.'\n]);\n```\n\nOr\n\n```php\n$ringcentral = app('ringcentral');\n\n$ringcentral-\u003esendMessage([\n    'to'   =\u003e '18042221111',\n    'text' =\u003e 'Using the instance to send a message.'\n]);\n```\n\n\n#### Properties\n\n| Name      | Required | Type          | Default     | Description |\n| ---       | ---      | ---           | ---         | ---         |\n| to        | true      | String     |             | The number to send the message to, must include country code |\n| text        | true      | String   |             | The text of the message to send |\n\n### Retrieving Extensions (requires admin access)\n\n```php\nRingCentral::getExtensions();\n```\n\nOr\n\n```php\n$ringcentral = app('ringcentral');\n\n$ringcentral-\u003egetExtensions();\n```\n\n### Get messages sent and received for the operator\n\n```php\nRingCentral::getOperatorMessages();\n```\n\nOr\n\n```php\n$ringcentral = app('ringcentral');\n\n$ringcentral-\u003egetOperatorMessages();\n```\n\nThe default from date is the previous 24 hours, to specify the date to search from pass the require date as a parameter.\n\n```php\nRingCentral::getOperatorMessages((new \\DateTime())-\u003emodify('-1 hours'));\n```\n\n#### Parameters\n\n| Name      | Required | Type          | Default     | Description |\n| ---       | ---      | ---           | ---         | ---         |\n| fromDate  | false    | Object      |             | The date and time to start the search from must be a PHP date object |\n| toDate  | false    | Object      |             | The date and time to end the search must be a PHP date object |\n| perPage  | false    | Int      |  100           | The number of records to return per page |\n\n### Get messages sent and received for a given extension (Needs admin access)\n\n```php\nRingCentral::getMessagesForExtensionId(12345678);\n```\n\nOr\n\n```php\n$ringcentral = app('ringcentral');\n\n$ringcentral-\u003egetMessagesForExtensionId(12345678);\n```\n\nThe default from date is the previous 24 hours, to specficy the date to search from pass the require date as a parameter.\n\n```php\nRingCentral::getMessagesForExtensionId(12345678, (new \\DateTime())-\u003emodify('-1 hours'));\n```\n\n#### Parameters\n\n| Name      | Required | Type          | Default     | Description |\n| ---       | ---      | ---           | ---         | ---         |\n| extensionId  | true    | String      |             | The RingCentral extension Id of the extension to retrieve the messages for |\n| fromDate  | false    | Object      |             | The date and time to start the search from must be a PHP date object|\n| toDate  | false    | Object      |             | The date and time to end the search must be a PHP date object |\n| perPage  | false    | Int      |  100           | The number of records to return per page |\n\n\n### Get a messages attachment (requires admin access)\n\n```php\nRingCentral::getMessageAttachmentById(12345678, 910111213, 45678910);\n```\n\nOr\n\n```php\n$ringcentral = app('ringcentral');\n\n$ringcentral-\u003egetMessageAttachmentById(12345678, 910111213, 45678910);\n```\n\n\n#### Parameters\n\n| Name      | Required | Type          | Default     | Description |\n| ---       | ---      | ---           | ---         | ---         |\n| extensionId  | true    | String      |             | The RingCentral extension Id of the extension the messages belongs to |\n| messageId  | true    | String      |             | The id of the message of the the attachment belongs to |\n| attachmentId  | true    | String      |             | The id of the attachment |\n\n\n\nFor more information on using the RingCentral client library, see the [official client library repository][client-library].\n\n[client-library]: https://github.com/ringcentral/ringcentral-php\n\n\n## Testing\n\n``` bash\ncomposer test\n```\nIf using the RingCentral sandbox environment when testing set the following environment variable to true to handle sandbox message prefix.\n\n```dotenv\nRINGCENTRAL_IS_SANDBOX=true\n```\nAn 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.\n\n```dotenv\nRINGCENTRAL_DELAY_REQUEST_SECONDS=20\n```\n\n\n## Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.\n\n## Contributing\n\nPlease see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.\n\n## Security\n\nIf you discover any security related issues, please email hello@leecox.dev instead of using the issue tracker.\n\n## Credits\n\n- [Lee Cox](https://github.com/coxlr)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoxlr%2Flaravel-ringcentral","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoxlr%2Flaravel-ringcentral","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoxlr%2Flaravel-ringcentral/lists"}