{"id":23854844,"url":"https://github.com/mastersam07/livechat","last_synced_at":"2025-09-08T02:30:58.738Z","repository":{"id":45477175,"uuid":"290501288","full_name":"Mastersam07/livechat","owner":"Mastersam07","description":"A livechat plugin for embedding mobile chat window in your mobile application.","archived":false,"fork":false,"pushed_at":"2024-10-05T10:58:59.000Z","size":387,"stargazers_count":11,"open_issues_count":9,"forks_count":19,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-08-03T06:13:37.020Z","etag":null,"topics":["dart","dartlng","flutter","flutter-plugin","flutter-plugins","package"],"latest_commit_sha":null,"homepage":"","language":"Dart","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/Mastersam07.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-08-26T13:16:40.000Z","updated_at":"2025-06-05T04:29:45.000Z","dependencies_parsed_at":"2024-08-22T23:24:18.786Z","dependency_job_id":null,"html_url":"https://github.com/Mastersam07/livechat","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/Mastersam07/livechat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastersam07%2Flivechat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastersam07%2Flivechat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastersam07%2Flivechat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastersam07%2Flivechat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mastersam07","download_url":"https://codeload.github.com/Mastersam07/livechat/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastersam07%2Flivechat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274122918,"owners_count":25226015,"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-09-08T02:00:09.813Z","response_time":121,"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":["dart","dartlng","flutter","flutter-plugin","flutter-plugins","package"],"created_at":"2025-01-03T00:17:44.563Z","updated_at":"2025-09-08T02:30:58.239Z","avatar_url":"https://github.com/Mastersam07.png","language":"Dart","readme":"# 💬 livechat\n\n[![codecov](https://codecov.io/gh/Mastersam07/livechat/branch/master/graph/badge.svg?token=5J2EA3Q5JJ)](https://codecov.io/gh/Mastersam07/livechat)\n![CI](https://github.com/mastersam07/livechat/workflows/CI/badge.svg?style=flat-square)\n[![license](https://img.shields.io/badge/license-MIT-success.svg?style=flat-square)](https://github.com/Mastersam07/livechat/blob/master/LICENSE)\n[![pub package](https://img.shields.io/pub/v/livechatt.svg?color=success\u0026style=flat-square)](https://pub.dartlang.org/packages/livechatt)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-success.svg?style=flat-square)](https://github.com/Mastersam07/livechat/pulls)\n![GitHub contributors](https://img.shields.io/github/contributors/mastersam07/livechat?color=success\u0026style=flat-square)\n![GitHub last commit](https://img.shields.io/github/last-commit/mastersam07/livechat?style=flat-square)\n\nA livechat package for embedding mobile chat window in your mobile application.\n\n## 🎖 Installing\n\n```yaml\ndependencies:\n  livechatt: ^1.5.1\n```\n\n### ⚡️ Import\n\n```dart\nimport 'package:livechatt/livechatt.dart';\n```\n\n## 🎮 How To Use\n\n\u003e Get the [Crendentials](https://www.livechat.com) for your LiveChat \n\n### Android\n\u003e- Edit AndroidManifest.xml as shown below\n\n#### Internet and Storage Access\n```xml\n\u003cuses-permission android:name=\"android.permission.INTERNET\"/\u003e\n```\n\n#### ChatWindow\n```xml\n\u003cactivity android:name=\"com.livechatinc.inappchat.ChatWindowActivity\" android:configChanges=\"orientation|screenSize\" /\u003e\n```\n\n### iOS - Manifest\n\u003e- Set minimum deployment target of iOS to 11.0\n\n\u003e- Edit info.plist as shown below\n\n#### Sending Files From Device Library\n```plist\n\u003ckey\u003eNSPhotoLibraryUsageDescription\u003c/key\u003e\n\u003cstring\u003eThis app requires access to the photo library.\u003c/string\u003e\n\u003ckey\u003eNSMicrophoneUsageDescription\u003c/key\u003e\n\u003cstring\u003eThis app require access to the microphone.\u003c/string\u003e\n\u003ckey\u003eNSCameraUsageDescription\u003c/key\u003e\n\u003cstring\u003eThis app requires access to the camera.\u003c/string\u003e\n```\n\n#### Having issues running on ios?\nAdd the below to your podfile\n\n```podfile\npost_install do |installer|\n  installer.pods_project.targets.each do |target|\n    flutter_additional_ios_build_settings(target)\n    target.build_configurations.each do |config|\n      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '11.0'\n    end\n  end\nend\n```\n\n### Dart Usage\n\n- Regular usage\n\n```dart\nonPressed: (){\n    Livechat.beginChat(LICENSE_NO);\n},\n```\n\n- Cases where there are custom parameters\n\n```dart\nvar cmap = \u003cString, String\u003e{\n    'org': 'organizationTextController.text',\n    'position': 'positionTextController.text'\n};\n\nonPressed: (){\n    Livechat.beginChat(\n      LICENSE_NO,\n      groupId: GROUP_ID,\n      visitorName: VISITOR_NAME,\n      visitorEmail: VISITOR_EMAIL,\n      customParams: cmap,\n    );\n},\n```\n\nFor more info, please, refer to the `main.dart` in the example.\n\n### Embedded Chat Views\n\nThe package now supports embedded views for custom positioning within your app’s layout:\n\n```dart\n\nvar cmap = \u003cString, String\u003e{\n    'org': 'organizationTextController.text',\n    'position': 'positionTextController.text'\n};\n\nLivechat.embeddedChat(\n  licenseNo: 'your_license',\n  groupId: 'group_id',\n  visitorEmail: 'visitor_email',\n  visitorName: 'visitor_name',\n  customParams: cmap,\n)\n```\n\nFor more info, please refer to `EmbeddedChatWidget` in `main.dart` in the example.\n\n### Events Streaming\n\n\u003e Android only\n\nThe plugin streams various events such as new messages, visibility changes, and errors from the chat window. You can listen to events like this:\n\n```dart\nLivechat.chatEvents.listen((event) {\n  print(event);\n});\n```\n\nFor specific events, you can stream:\n\n##### New Messages:\n\n```dart\nLivechat.newMessages.listen((message) {\n  print(message); \n});\n```\n\n##### Visibility Changes:\n\n```dart\nLivechat.visibilityChanges.listen((isVisible) {\n  print(\"Chat Window is visible: $isVisible\");\n});\n```\n\n##### Errors:\n\n```dart\nLivechat.errors.listen((error) {\n  print(\"Error: ${error['errorDescription']}\");\n});\n```\n\n##### Uri handling:\n\n```dart\nLivechat.uriHandlers.listen((message) {\n  print(message); \n});\n```\n\n##### File picker activity:\n\n```dart\nLivechat.filePickerActivity.listen((message) {\n  print(message); \n});\n```\n\n##### Window initialization:\n\n```dart\nLivechat.windowInitialized.listen((message) {\n  print(message); \n});\n```\n\nFor more info, please refer to `EmbeddedChatWidget` in `main.dart` in the example.\n\n### Views\n\n\u003cimg src=\"https://github.com/Mastersam07/livechat/raw/master/assets/1.png\" width=\"250\"\u003e\u003cimg src=\"https://github.com/Mastersam07/livechat/raw/master/assets/2.png\" width=\"250\"\u003e\n\n## 🐛 Bugs/Requests\n\nIf you encounter any problems feel free to open an issue. If you feel the library is\nmissing a feature, please raise a ticket on Github and I'll look into it.\nPull request are also welcome.\n\n### ❗️ Note\n\nThis project is a starting point for a Flutter\n[plug-in package](https://flutter.dev/developing-packages/),\na specialized package that includes platform-specific implementation code for\nAndroid and/or iOS.\n\nFor help getting started with Flutter, view our \n[online documentation](https://flutter.dev/docs), which offers tutorials, \nsamples, guidance on mobile development, and a full API reference.\n\n## 🤓 Developer(s)\n\n[\u003cimg src=\"https://avatars3.githubusercontent.com/u/31275429?s=460\u0026u=b935d608a06c1604bae1d971e69a731480a27d46\u0026v=4\" width=\"180\" /\u003e](https://mastersam.tech)\n#### **Abada Samuel Oghenero**\n\u003cp\u003e\n\u003ca href=\"https://twitter.com/mastersam_\"\u003e\u003cimg src=\"https://github.com/aritraroy/social-icons/blob/master/twitter-icon.png?raw=true\" width=\"60\"\u003e\u003c/a\u003e\n\u003ca href=\"https://linkedin.com/in/abada-samuel/\"\u003e\u003cimg src=\"https://github.com/aritraroy/social-icons/blob/master/linkedin-icon.png?raw=true\" width=\"60\"\u003e\u003c/a\u003e\n\u003ca href=\"https://medium.com/@sammytech\"\u003e\u003cimg src=\"https://github.com/aritraroy/social-icons/blob/master/medium-icon.png?raw=true\" width=\"60\"\u003e\u003c/a\u003e\n\u003ca href=\"https://facebook.com/abada.samueloghenero\"\u003e\u003cimg src=\"https://github.com/aritraroy/social-icons/blob/master/facebook-icon.png?raw=true\" width=\"60\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## ⭐️ License\n\n#### \u003ca href=\"https://github.com/Mastersam07/livechat/blob/master/LICENSE\"\u003eMIT LICENSE\u003c/a\u003e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastersam07%2Flivechat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmastersam07%2Flivechat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastersam07%2Flivechat/lists"}