{"id":13990322,"url":"https://github.com/intercom/intercom-ios","last_synced_at":"2025-05-15T04:04:36.488Z","repository":{"id":6428854,"uuid":"7667479","full_name":"intercom/intercom-ios","owner":"intercom","description":":iphone: Intercom for iOS, for integrating Intercom into your iOS application.","archived":false,"fork":false,"pushed_at":"2025-05-06T15:21:17.000Z","size":2765862,"stargazers_count":374,"open_issues_count":0,"forks_count":125,"subscribers_count":138,"default_branch":"master","last_synced_at":"2025-05-06T15:49:12.534Z","etag":null,"topics":["intercom","ios-messsenger","ios-sdk","mobile-messenger","objective-c","swift"],"latest_commit_sha":null,"homepage":"http://www.intercom.com","language":"Objective-C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/intercom.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,"zenodo":null}},"created_at":"2013-01-17T14:23:27.000Z","updated_at":"2025-05-06T15:19:34.000Z","dependencies_parsed_at":"2023-02-18T08:46:02.952Z","dependency_job_id":"d9ea72b2-87ca-423a-8d88-a61b546fe526","html_url":"https://github.com/intercom/intercom-ios","commit_stats":{"total_commits":473,"total_committers":33,"mean_commits":"14.333333333333334","dds":0.6934460887949261,"last_synced_commit":"17c2c9d4941552863599bb067530b36d5297042d"},"previous_names":[],"tags_count":272,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intercom%2Fintercom-ios","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intercom%2Fintercom-ios/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intercom%2Fintercom-ios/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intercom%2Fintercom-ios/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/intercom","download_url":"https://codeload.github.com/intercom/intercom-ios/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254270641,"owners_count":22042858,"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":["intercom","ios-messsenger","ios-sdk","mobile-messenger","objective-c","swift"],"created_at":"2024-08-09T13:02:32.998Z","updated_at":"2025-05-15T04:04:36.455Z","avatar_url":"https://github.com/intercom.png","language":"Objective-C","funding_links":[],"categories":["Objective-C"],"sub_categories":[],"readme":"\n[![CocoaPods](https://img.shields.io/badge/platforms-iOS-orange.svg?maxAge=2592000)](https://cocoapods.org/pods/Intercom)\n[![Languages](https://img.shields.io/badge/languages-OjbC%20%7C%20%20Swift-orange.svg?maxAge=2592000)](https://github.com/intercom/intercom-ios)\n[![CocoaPods](https://img.shields.io/cocoapods/v/Intercom.svg?maxAge=2592000)](https://cocoapods.org/pods/Intercom)\n[![carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)\n[![Apache License](http://img.shields.io/badge/license-APACHE2-blue.svg?style=flat)](https://www.apache.org/licenses/LICENSE-2.0.html)\n\n\u003cimg src=\"https://user-images.githubusercontent.com/6392766/92717163-af7b0200-f357-11ea-9dc3-6f86d0c21d96.png\" width=\"297\" height=\"76\"/\u003e\n\n\n## ⚠️ April 5th Codesigning issue\nIf you are running iOS SDK v16+ and are experiecing a codesigning issue, [please follow these steps](https://github.com/intercom/intercom-ios/wiki/Codesigning-Issue) to resolve it.\n\n## Onboard, retain and support mobile users at scale\nEngage customers with email, push, and in‑app messages and support them with an integrated knowledge base and help desk.\n\n### The Intercom Messenger\nThe [Intercom Messenger](https://www.intercom.com/help/en/articles/316-the-intercom-messenger-in-your-product-and-on-your-website) is the home for the conversations your customers have with you via Intercom, and the place where they can self-serve for support or to learn more about your product.\n\nThe Messenger works for both logged in and logged out users. It’s worth reading the detailed instructions in our [developer docs](https://developers.intercom.com/installing-intercom/docs/intercom-for-ios) on user management before you get started.\n\nYou can open the Intercom Messenger from a button in your app, programmatically when someone does something, or from a persistent button that sits over your app’s UI.\n\nWhen you trigger the Intercom Messenger, your customer is presented with a home screen. This is configurable inside Intercom to change how it looks and what’s presented.\n\nFrom there, your customer can search for help articles or start a conversation. A conversation goes to your inbox inside Intercom, and replies in both directions happen in real time. You can also send push notifications to your customers to let them know they have a reply after they’ve left your app.\n\n### [Outbound messaging features](https://www.intercom.com/mobile-carousels)\nYou can send messages to your customers from Intercom, and the mobile SDK will present them in your app. Messages can be targeted at specific users or groups of users, and can be scheduled to be sent during specific time windows.\n\nCompanies use this for many use cases, including onboarding new users, announcing features, proactive support, important notices etc.\n\nThe mobile SDK supports many different message formats, all of which can be created and configured inside Intercom. These include:\n\n* **Push notifications** - these can open your app or follow a deep link.\n* **Chats** - messages from someone in your team to your customer.\n* **Mobile Carousels** - highly customizable, multi-screen messages with calls to action and device permissions.\n* **Small posts** - a short announcement.\n* **Large posts** - a full screen announcement.\n\nWe check for new messages when your app opens and whenever your customer or your app interacts with Intercom.\n\n## Installation\n\nIntercom for iOS supports iOS 15+. \nXcode 15 is required to build Intercom iOS SDK.\n\n### CocoaPods\nCocoapods 1.11.0 is required to install Intercom.\nAdd the Intercom pod into your Podfile and run `pod install`.\n```ruby\n    target :YourTargetName do\n      pod 'Intercom'\n    end\n```\n\n### Swift Package Manager\nAdd `https://github.com/intercom/intercom-ios-sp` as a Swift Package Repository in Xcode and follow the instructions to add `Intercom` as a Swift Package.\n\n### Manual Installation\n\n1. [Download Intercom for iOS](https://github.com/intercom/intercom-ios/archive/master.zip) and extract the zip.\n2. Drag `Intercom.xcframework` into your project. \n\u003cimg width=\"258\" alt=\"xcframework_drag\" src=\"https://user-images.githubusercontent.com/3185423/102403528-4ce07480-3fde-11eb-9147-bf3f6a7fbf2c.png\"\u003e\n\nMake sure \"Copy items if needed\" is selected and click Finish.\n\n\u003cimg width=\"451\" alt=\"copy_items\" src=\"https://user-images.githubusercontent.com/3185423/102404075-19521a00-3fdf-11eb-9ddd-2cf8d2efa657.png\"\u003e\n\n3. In the target settings for your app, set the Intercom.xcframework to “Embed \u0026 Sign”. This can be found in the “Frameworks, Libraries, and Embedded Content” section of the “General” tab.\n\n\u003cimg width=\"613\" alt=\"embed_sign\" src=\"https://user-images.githubusercontent.com/3185423/102403646-7e594000-3fde-11eb-89e6-0dc280bf24b2.png\"\u003e\n\n## Example app\nThere are example apps provided [here](https://github.com/intercom/intercom-ios/tree/master/Examples) for Objective-C and Swift, as well as an example built with SwiftUI. We also have some sample code for handling Intercom push notifications manually.\n\n## Setup and Configuration\n\n* Our [installation guide](https://developers.intercom.com/installing-intercom/ios/installation/) contains full setup and initialisation instructions.\n* Read [\"Data Hosting Region Configuration for iOS\"](https://developers.intercom.com/installing-intercom/ios/data-hosting-region-configuration/).\n* Read our guide on [Push Notifications](https://developers.intercom.com/installing-intercom/ios/push-notifications/).\n* Please contact us on [Intercom](https://intercom.com) with any questions you may have, we're only a message away!\n\n## Customer Support\n\n👋  Contact us with any issues at our [Intercom Developer Hub available here](https://developers.intercom.com/installing-intercom/) by clicking on the Messenger in the bottom right. If you bump into any problems or need more support, just start a conversation using Intercom there and it will be immediately routed to our Customer Support Engineers.\n\nYou can also check out the [Mobile SDKs section of the Intercom Community](https://community.intercom.com/mobile-sdks-24) to ask a question or find an answer.\n\n## React Native Support\nLooking for React Native support? We have a [React Native Plugin](https://github.com/intercom/intercom-react-native) for Intercom 🎉\n\n## What about events, push notifications, company and user data?\n\nIntercom for iOS has support for all these things. For full details please read our [documentation](https://developers.intercom.com/installing-intercom/ios/about-the-sdk/).\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintercom%2Fintercom-ios","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fintercom%2Fintercom-ios","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintercom%2Fintercom-ios/lists"}