Download the PHP package ringcentral/glip-botman without Composer
On this page you can find all versions of the php package ringcentral/glip-botman. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ringcentral/glip-botman
More information about ringcentral/glip-botman
Files in ringcentral/glip-botman
Package glip-botman
Short Description Independent adaptor for Glip to support Botman
License MIT
Homepage http://developers.ringcentral.com
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package glip-botman
Glip - Botman
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
- 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
Via Github Repo
Via Composer
Require this package with composer using the following command:
Require Composer's autoloader in your PHP script ( index.php ) assuming it is in the same directory where you installed Composer :
Configure your Bot
Provide Bot User details in .env file:
Edit the .env file and copy the below and edit app details and user details.
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.
- Login to the Developer Portal https://developer.ringcentral.com/login.html#/ 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 to Listen to conversations posted on Glip
For more information on Webhooks, refer to our QuickStart Guide on Webhooks
Usage
Note: The demo assumes that you are not using a Live server instead the PHP's Built-In Web server and the tunneling service from ngrok.
Start the PHP built-in Web Server locally
Start ngrok ( Optional )
For demo purposes we are using ngrok.
Open another terminal and:
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:
Add this to the .env parameter GLIP_WEBHOOK_URL created above.
Start the Bot
In the terminal, just run this command:
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
- Assign a Name and Unique Email Address to the Bot
https://service.devtest.ringcentral.com
Note: The above user refers to the same user whose credentials was used in the .env file to configure the bot.
- Invite the bot into a group using the email ID
https://glip.devtest.ringcentral.com/
Note: Create a group on Glip and invite the Bot using Add Member button on the top extreme right.
- Start chatting with the Bot
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
For more details, please take a look at Botman's official guide on Hearing Messages
Dependencies
Currently used RingCentral-PHP SDK version for this demo:
"ringcentral/ringcentral-php": "^2.0.0"
"mpociot/botman":"latest"
- Make sure to change the SDK version in the composer.json before you chose to use a different SDK Version.
Links
Project Repo
RingCentral SDK for PHP
RingCentral API Docs
RingCentral API Explorer
Contributions
Any reports of problems, comments or suggestions are most welcome.
Please report these on glip-botman's Issue Tracker in Github.
License
RingCentral SDK is available under an MIT-style license. See LICENSE.txt for details.
RingCentral SDK © 2017 by RingCentral
FAQ
- What if I do not have a RingCentral account? Don't have an account, no worries: Become a RingCentral Customer
- 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
All versions of glip-botman with dependencies
ringcentral/ringcentral-php Version ^2.0.0
vlucas/phpdotenv Version ^2.2
ext-curl Version *
php Version >=5.6.0
guzzlehttp/psr7 Version ^1.4.2
symfony/event-dispatcher Version ^2.7|^3.3.2
guzzlehttp/guzzle Version ^6.2.3