{"id":21882398,"url":"https://github.com/essent/nativescript-iadvize","last_synced_at":"2026-05-10T05:05:08.362Z","repository":{"id":42980269,"uuid":"383745361","full_name":"Essent/nativescript-iadvize","owner":"Essent","description":"A NativeScript plugin for integration of iAdvize chat into Android/iOS app.","archived":false,"fork":false,"pushed_at":"2022-11-23T07:35:57.000Z","size":18321,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-22T01:15:15.890Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Essent.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":"2021-07-07T09:34:26.000Z","updated_at":"2021-10-26T14:57:18.000Z","dependencies_parsed_at":"2023-01-22T15:15:12.997Z","dependency_job_id":null,"html_url":"https://github.com/Essent/nativescript-iadvize","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Essent/nativescript-iadvize","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Essent%2Fnativescript-iadvize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Essent%2Fnativescript-iadvize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Essent%2Fnativescript-iadvize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Essent%2Fnativescript-iadvize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Essent","download_url":"https://codeload.github.com/Essent/nativescript-iadvize/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Essent%2Fnativescript-iadvize/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264734573,"owners_count":23655695,"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","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":[],"created_at":"2024-11-28T09:28:58.939Z","updated_at":"2026-05-10T05:05:03.290Z","avatar_url":"https://github.com/Essent.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nativescript-iadvize\nA NativeScript plugin for integration of iAdvize chat into Android/iOS app.\n\n# NativeScript plugin for iAdvize SDK\n\n[![npm version](https://badge.fury.io/js/nativescript-iadvize.svg)](https://www.npmjs.com/package/nativescript-iadvize)\n\nThis is a plugin to show the conversation from a iAdvize chat, using the iAdvize SDK ([Android](https://github.com/iadvize/iadvize-android-sdk) v2.2.2, [iOS](https://github.com/iadvize/iadvize-ios-sdk) v2.2.5).\n\n## Requirements\n* iOS 12.0 or higher, and Xcode 12.5\n* Minimum Android Version API 19, and Kotlin 1.5.10\n* NativeScript CLI 7.x\n* [iAdvize account](https://www.iadvize.com/)\n\n## Installation\nRun the following command from the root of your project:\n\n```console\nnpm install nativescript-iadvize\n```\n\n### Activation\nWhen the user logs in to the your app call `activate` with your credentials (our example [home.component.ts](./demo/src/app/home/home.component.ts)):\n```ts\nIAdvize.activate(XXXX, 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', 'userId', () =\u003e {\n  console.log('IAdvize conversation activated.');\n});\n```\n\n### Chatting\nTo open the chat window call `presentChat()`:\n```ts\nIAdvize.presentChat();\n```\n\n### Optional functions\n\n#### Hide default chat button\nTo hide default chat button call `hideDefaultChatButton()`:\n```ts\nIAdvize.hideDefaultChatButton();\n```\n\n#### UI customization\nTo customize the chatbox UI call `customize()`:\n```ts\nconst configuration: ChatConfiguration = {\n  automaticMessage: 'Any question? Say Hello to Smart and we will answer you as soon as possible! 😊',\n  font: 'fontPath',\n  incomingMessageAvatar: 'avatar-icon',\n  mainColor: '#4103fc',\n  navigationBarBackgroundColor: '#4103fc',\n  navigationBarMainColor: '#ffffff',\n  navigationBarTitle: 'Chat Title'\n};\nIAdvize.customize(configuration);\n```\n\n#### Logging Out\nTo preserve the confidentiality of user conversation call `logout()`.\n\n```ts\nIAdvize.logout();\n```\n\n#### Conversation events\nTo add a listener to be informed in real time about conversation events call `registerConversationListener()`.\n\n```ts\nIAdvize.registerConversationListener((url: string) =\u003e {\n  console.log('Handle clicked url - ' + url);\n  return false;\n}, (hasOngoingConversation: boolean) =\u003e {\n    console.log('Ongoing conversation status changed - ' + hasOngoingConversation);\n});\n```\n\n\n#### Push Notifications\nTo be informed of chat messages received when your app is not running call `registerPushToken()`\n```ts\nIAdvize.registerPushToken('your-token', isProduction);\n```\n\n### Development setup\n\nFor easier development and debugging purposes continue with the following steps:\n\nOpen a command prompt/terminal, navigate to src folder and run `npm run demo.ios` or `npm run demo.android` to run the demo.\n\nNow go and make a change to your plugin. It will be automatically applied to the demo project.\n\n#### Clean plugin and demo files\n\nSometimes you may need to wipe away all generated folders to reinstall them fresh.\nRun `npm run clean` to wipe those clean then you can can run `plugin.prepare` to install fresh dependencies.\n\nSometimes you just need to wipe out the demo's platforms, node_modules and hooks directory only.\nRun ```npm run demo.reset``` to delete those.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fessent%2Fnativescript-iadvize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fessent%2Fnativescript-iadvize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fessent%2Fnativescript-iadvize/lists"}