PHPackages ringcentral/glip-botman - 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. ringcentral/glip-botman ActiveLibrary[API Development](/categories/api) ringcentral/glip-botman ======================= Independent adaptor for Glip to support Botman 2.0.0(8y ago)8101[2 issues](https://github.com/ringcentral/glip-botman/issues)[2 PRs](https://github.com/ringcentral/glip-botman/pulls)MITPHPPHP >=5.6.0 Since Jul 28Pushed 4y ago7 watchersCompare [ Source](https://github.com/ringcentral/glip-botman)[ Packagist](https://packagist.org/packages/ringcentral/glip-botman)[ Docs](http://developers.ringcentral.com)[ RSS](/packages/ringcentral-glip-botman/feed)WikiDiscussions master Synced 3d ago READMEChangelog (1)Dependencies (8)Versions (5)Used By (0) [![Build Status](https://camo.githubusercontent.com/40bb4aac46bfc346b3c85d0cab7268c6aaa0a6eec173c0749b76afa13fd61685/68747470733a2f2f7472617669732d63692e6f72672f72696e6763656e7472616c2f676c69702d626f746d616e2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/ringcentral/glip-botman)[![Code Climate](https://camo.githubusercontent.com/e38e663d2c868fc99b8049782b16231baa2d36c76ff0ebec4a5e5c4194b6bb88/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636c696d6174652f6769746875622f72696e6763656e7472616c2f676c69702d626f746d616e2e737667)](https://codeclimate.com/github/ringcentral/glip-botman)[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)[![Chat](https://camo.githubusercontent.com/572ef22fed1667383a3ac49636bad4f637efe81ec2f1335b5188638b48aebba6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636861742d6f6e253230676c69702d6f72616e67652e737667)](https://glipped.herokuapp.com/)[![Coverage Status](https://camo.githubusercontent.com/c1c61b813744d03b3967ac968e32b316b5764201dbd6bf5ff509422342ae1349/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f72696e6763656e7472616c2f676c69702d626f746d616e2f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/ringcentral/glip-botman?branch=master)[![Codacy Badge](https://camo.githubusercontent.com/5aa89065a1d9d641a3a7275549bb71b804860de81274d0c6eba9138060ecec9a/68747470733a2f2f6170692e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f3330643538643265306633633430653638336236306636316537323764303839)](https://www.codacy.com/app/anilkumarbp/glip-botman?utm_source=github.com&utm_medium=referral&utm_content=ringcentral/glip-botman&utm_campaign=Badge_Grade)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/daf8bcb6d0496f7403be3972237dd5040abd308cd9dcab85e184e3ef5cce1c28/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f72696e6763656e7472616c2f676c69702d626f746d616e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ringcentral/glip-botman/?branch=master) Glip - Botman ============= [](#glip---botman) [Glip](https://glip.com/) Adaptor for [Botman](https://botman.io/1.5/installation). [![APP screenshots](assets/botman_glip.png)](assets/botman_glip.png) This is a simple Botman Adaptor for Glip which is ready to use and fairly simple to install. Before we install, lets look at the requirements below : Requirement ----------- [](#requirement) - PHP 5.5+ - CURL extension - MCrypt extension Note: for PHP v 5.6 you would need to comment the below line in the `php.ini` file. "always\_populate\_raw\_post\_data = -1" Installation & Setup ------------------------ [](#installation--setup) ### Via Github Repo [](#via-github-repo) ``` $ git clone https://github.com/anilkumarbp/glip-botman.git $ cd glip-botman $ curl -sS https://getcomposer.org/installer | php $ composer install ``` ### Via Composer [](#via-composer) Require this package with composer using the following command: ``` $ composer require anilkumarbp/glip-botman ``` Require Composer's autoloader in your PHP script ( index.php ) assuming it is in the same directory where you installed Composer : ``` require('vendor/autoload.php'); ``` Configure your Bot ------------------ [](#configure-your-bot) ### Provide Bot User details in `.env` file: [](#provide-bot-user-details-in-env-file) ``` $ vi .env ``` Edit the .env file and copy the below and edit app details and user details. ``` GLIP_SERVER=https://platform.devtest.ringcentral.com // Server Url ( Production: https://platform.ringcentral.com || Sandbox: https://platform.devtest.ringcentral.com ) GLIP_APPKEY=appKey GLIP_APPSECRET=appSecret GLIP_USERNAME=Username GLIP_PASSWORD=Password GLIP_EXTENSION=Extension ``` ### Define an Application in RingCentral [](#define-an-application-in-ringcentral) In order to communicate with the RingCentral API, you will need to have RingCentral API Keys for the appropriate environment, either **Sandbox** or **Production**. 1. Login to the Developer Portal if you haven't already. 2. Click on 'Create App' to define a new application - **Application Name:** Your choice, but something easy to identify and associate with purpose is good - **Description:** Your suitable description for the application. - **Application Type:** Private - **Platform Type:** **Server-only (No UI)** - **Permissions Needed:** - Glip - Webhook Subscriptions Note : This bot uses [Webhook Based Subscriptions](https://developer.ringcentral.com/api-docs/latest/index.html#!#RefCreateSubscription) to Listen to conversations posted on Glip For more information on Webhooks, refer to our [QuickStart Guide on Webhooks](http://ringcentral-quickstart.readthedocs.io/en/latest/webhooks/) Usage ----- [](#usage) Note: The demo assumes that you are not using a Live server instead the PHP's [Built-In Web server](http://php.net/manual/en/features.commandline.webserver.php) and the tunneling service from [ngrok](https://ngrok.com/). ### Start the PHP built-in Web Server locally [](#start-the-php-built-in-web-server-locally) ``` $ cd glip-botman ``` ``` $ php -S localhost:8080 ``` ### Start ngrok ( Optional ) [](#start-ngrok--optional-) For demo purposes we are using ngrok. Open another terminal and: ``` $ ngrok http 8080 ``` ### Setup Webhook URL for the Bot [](#setup-webhook-url-for-the-bot) Just point the webhook subscription URL to: ( you must start ngrok if using it ) lets say the above step gives you an endpoint for the server as below: ``` https://f0aad057.ngrok.io/index.php ``` Add this to the .env parameter `GLIP_WEBHOOK_URL` created above. Start the Bot ------------- [](#start-the-bot) In the terminal, just run this command: ``` $ cd glip-botman ``` ``` $ php index.php ``` If its successful, you will get a message as below : **Wohooo, your Bot is Registered. Please follow the instructions on on-boarding the bot into Glip** On-Boarding Bot into Glip ------------------------- [](#on-boarding-bot-into-glip) 1. **Assign a Name and Unique Email Address to the Bot** [![Bot user screenshots](assets/service_web.png)](assets/service_web.png) **Note:** The above user refers to the same user whose credentials was used in the `.env` file to configure the bot. 2. **Invite the bot into a group using the email ID** [![Glip group screenshots](assets/glip_group.png)](assets/glip_group.png) **Note:** Create a group on `Glip` and invite the Bot using `Add Member` button on the top extreme right. 3. **Start chatting with the Bot**[![Glip group screenshots](assets/chat_bot.png)](assets/chat_bot.png) Extending the Botman-Glip Adapter --------------------------------- [](#extending-the-botman-glip-adapter) You can set the `Bot` to listen to any specific commands/instructions . You can include the commands in the php file whihc is used to setup the Webhook. In our case, it is `webhook.php` ``` // Give the bot something to listen for. $botman->hears('hello', function (BotMan $bot) { $bot->reply('Hello yourself.'); }); $botman->hears('how are you doing', function (BotMan $bot) { $bot->reply('I am fine how are you doing today ?'); }); ``` For more details, please take a look at Botman's official guide on [Hearing Messages](https://botman.io/1.5/receiving) Dependencies ------------ [](#dependencies) Currently used RingCentral-PHP SDK version for this demo: [ "ringcentral/ringcentral-php": "^2.0.0"](https://github.com/ringcentral/ringcentral-php) ["mpociot/botman":"latest"](https://github.com/mpociot/botman) - Make sure to change the SDK version in the composer.json before you chose to use a different SDK Version. Links ----- [](#links) Project Repo - RingCentral SDK for PHP - RingCentral API Docs - RingCentral API Explorer - Contributions ------------- [](#contributions) Any reports of problems, comments or suggestions are most welcome. Please report these on [glip-botman's Issue Tracker in Github](https://github.com/anilkumarbp/glip-botman/issues). License ------- [](#license) RingCentral SDK is available under an MIT-style license. See [LICENSE.txt](LICENSE.txt) for details. RingCentral SDK © 2017 by RingCentral FAQ --- [](#faq) - What if I do not have a RingCentral account? Don't have an account, no worries: [Become a RingCentral Customer](https://www.ringcentral.com/office/plansandpricing.html) - I/My company is an Independent Software Vendor (ISV) who would like to integrate with RingCentral, how do I do that? You can apply to [Join the RingCentral Partner Program](http://www.ringcentral.com/partner/isvreseller.html) ### Health Score 28 — LowBetter than 54% of packages Maintenance15 Infrequent updates — may be unmaintained Popularity12 Limited adoption so far Community14 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 50% 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 ~82 days Total 2 Last Release 3130d ago Major Versions 1.0.0 → 2.0.02017-10-19 ### Community Maintainers ![](https://www.gravatar.com/avatar/2ac226fc2e4c5d1b37908e1ae52415615f3378e47238fbdc12caeccae60f32f9?d=identicon)[kirill-konshin](/maintainers/kirill-konshin) ![](https://www.gravatar.com/avatar/7431dbfe7b3dea2743898f536769135e56650e4622131a75c3dd1a2a679ecccf?d=identicon)[anilkumarbp](/maintainers/anilkumarbp) --- Top Contributors [![anilkumarbp](https://avatars.githubusercontent.com/u/5293126?v=4)](https://github.com/anilkumarbp "anilkumarbp (1 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (1 commits)") --- Tags botmanbotman-driverglipphpphpapisdkplatformconnectBotmanringcentral ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/ringcentral-glip-botman/health.svg) ``` [![Health](https://phpackages.com/badges/ringcentral-glip-botman/health.svg)](https://phpackages.com/packages/ringcentral-glip-botman) ``` ### Alternatives [ringcentral/ringcentral-php RingCentral Platform PHP SDK 541.2M5](/packages/ringcentral-ringcentral-php)[openai-php/laravel OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API 3.7k7.6M74](/packages/openai-php-laravel)[hubspot/api-client Hubspot API client 23414.2M16](/packages/hubspot-api-client)[php-opencloud/openstack PHP SDK for OpenStack APIs. Supports BlockStorage, Compute, Identity, Images, Networking and Metric Gnocchi 2292.2M24](/packages/php-opencloud-openstack)[theodo-group/llphant LLPhant is a library to help you build Generative AI applications. 1.5k311.5k5](/packages/theodo-group-llphant)[resend/resend-php Resend PHP library. 564.7M21](/packages/resend-resend-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)