{"id":21406752,"url":"https://github.com/ringcentral/ringcentral-engage-voice-embeddable-mobile","last_synced_at":"2025-10-08T23:58:55.904Z","repository":{"id":52884178,"uuid":"319800733","full_name":"ringcentral/ringcentral-engage-voice-embeddable-mobile","owner":"ringcentral","description":"[Experimental] Android/IOS apps based on ringcentral-engage-voice-embeddable and cordova","archived":false,"fork":false,"pushed_at":"2021-04-15T06:41:43.000Z","size":3080,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-07-14T00:46:55.730Z","etag":null,"topics":["android","cordova","experimental","ios","ringcentral-engage-voice","ringcentral-engage-voice-embeddable"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/ringcentral.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-09T00:51:26.000Z","updated_at":"2024-06-12T02:33:39.000Z","dependencies_parsed_at":"2022-08-23T10:20:29.399Z","dependency_job_id":null,"html_url":"https://github.com/ringcentral/ringcentral-engage-voice-embeddable-mobile","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ringcentral/ringcentral-engage-voice-embeddable-mobile","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ringcentral%2Fringcentral-engage-voice-embeddable-mobile","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ringcentral%2Fringcentral-engage-voice-embeddable-mobile/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ringcentral%2Fringcentral-engage-voice-embeddable-mobile/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ringcentral%2Fringcentral-engage-voice-embeddable-mobile/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ringcentral","download_url":"https://codeload.github.com/ringcentral/ringcentral-engage-voice-embeddable-mobile/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ringcentral%2Fringcentral-engage-voice-embeddable-mobile/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267117305,"owners_count":24038645,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-26T02:00:08.937Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["android","cordova","experimental","ios","ringcentral-engage-voice","ringcentral-engage-voice-embeddable"],"created_at":"2024-11-22T16:42:33.465Z","updated_at":"2025-10-08T23:58:50.863Z","avatar_url":"https://github.com/ringcentral.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Engage Voice Embeddable for Mobile\n\n**Experimental** Develop Android/IOS apps based on [ringcentral-engage-voice-embeddable](https://github.com/ringcentral/engage-voice-embeddable) and Cordova\n\n## Demo video\n\n- Android: https://youtu.be/rPoOqpVa5as\n\n## Download apps\n\n[https://github.com/ringcentral/ringcentral-engage-voice-embeddable-mobile/releases](https://github.com/ringcentral/ringcentral-engage-voice-embeddable-mobile/releases)\n\n## todos\n\n- [x] Running in Android\n- [x] Running in IOS\n- [ ] Use web worker\n- [x] Deploy to github pages\n\n## Dev\n\n### Prerequisites\n\n- Install Nodejs and npm(recommend using [nvm](https://github.com/nvm-sh/nvm)).\n- Install cordova: `npm i -g cordova`\n- Android: Follow the cordova guide to prepare for Android development: https://cordova.apache.org/docs/en/latest/guide/platforms/android/index.html\n- iOS: Follow the cordova guide to prepare for iOS development: https://cordova.apache.org/docs/en/latest/guide/platforms/ios/index.html, also requires paid Apple developer account.\n- ImageMagick installed (Mac: `brew install imagemagick`, Debian/Ubuntu: `sudo apt-get install imagemagick`, Windows: [See here, install \"Legacy tools\"](http://www.imagemagick.org/script/binary-releases.php#windows))\n- cordova-splash: `npm install cordova-splash -g`\n- cordova-icon: `npm install cordova-icon -g`\n- If you using emulator, you may need open the emulator first\n- A developer account in developer.ringcentral.com(free to register)\n- Create an app in developer.ringcentral.com, Create a RingCentral app with platform type - \"Browser Based\", and add permissions `Edit Message`, `Edit Presence`, `Internal Messages`, `Read Accounts`, `Read Call Log`, `Read Contacts`, `Read Messages`, `Read Presence`, `RingOut`, `SMS`, `Call Control` and `VoIP Calling` to your app.\n\n```bash\n# clone project\ngit clone git@github.com:ringcentral/ringcentral-engage-voice-embeddable-mobile.git\ncd ringcentral-engage-voice-embeddable-mobile\n\n# install dependencies\nnpm run pre \u0026\u0026 npm i\n\n# start proxy server\nnpm run proxy\n\n# will get https://xxxx.ngrok.io -\u003e localhost:6066\n# Remember https://xxxx.ngrok.io as serverUrl\n\n# create env file, then fill .env with serverUrl as RINGCENTRAL_APP_SERVER and RINGCENTRAL_CLIENT_ID and RINGCENTRAL_CLIENT_SECRET with your own app in developer.ringcentral.com, must be production app and web based with account permission.\n# Set https://xxxx.ngrok.io/rc-auth as callback url in app setting\ncp sample.env .env\n\n# start server\nnpm start\n\n# start client\nnpm run c\n\n# prepare cordova\nnpm run prepare\n\n# run Android app, make sure you have simulator or real android device ready\nnpm run a\n\n# run IOS app, make sure you have real IOS device and paid developer ID ready,\n# and open platforms/ios with xcode and config build an debug env\nnpm run i\n```\n\n## Build for Github pages\n\n```bash\n\n# build for github pages, remember to push to github\nnpm run gh\n\n# build for android\nnpm run build-android\n\n# check platforms/android/app/build/outputs/apk/debug/app-debug.apk\n\n# Build with online resources for IOS App\nnpm run build-ios\n\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fringcentral%2Fringcentral-engage-voice-embeddable-mobile","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fringcentral%2Fringcentral-engage-voice-embeddable-mobile","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fringcentral%2Fringcentral-engage-voice-embeddable-mobile/lists"}