To install Beacon, see the documentation.
- Include privacy manifest describing use of required reason API
- Beacon for iOS/iPadOS now supports Xcode 15.
- iOS/iPadOS 11 is no longer supported because Xcode 15 requires iOS 12 or greater. For more info, see the Xcode 15 Release Notes.
- Resolved
NSInternalInconsistencyExceptionlinked toUIGraphicsBeginImageContextby transitioning to usingUIGraphicsImageRendererinstead.
- Fixes edge case issue when opening Beacon from a push notification in certain configurations.
- Opening Beacon from a push notification when Beacon is already open no longer crashes the host app.
- Presenting Beacon from one of the overloads of
open(e.g.openArticle,search, etc.) now works when done so from a SwiftUI sheet.
Not a new release, per se, but we have migrated support from GitHub Issues in this repository to our customer support team. Links in earlier changelog entries that pointed to an issue will no longer work, you will get a 404 when following them. For additional information on a previous release, github issue, or any other request for support please reach out to us via [email protected]
- We now correctly configure the navigation bar when replying to a conversation, allowing the close button to be visible in all configurations. Issue 168
- Fixed a namespace collision when integrating more recent versions of PusherSwift. Issue 167
- We now correctly respect safe areas in all Beacon configurations. Issue 142
- We've removed our icon font that led to crashes on some devices running older iOS versions. Issue 146
- Addressed some crashes related to modifying UI from a background thread. Issue 157
- Improved GIF rendering to be much less resource and memory-intensive. Issue 158
- Resolved an issue where the chat send button could appear hidden in Beacons with white or near-white colors. Issue 160
- Fixed a rare case where restored chats could lead to chats having duplicate identifiers.
- Beacon more accurately determines the UIViewController to open from, improving the ergonomics of opening in SwiftUI and UIKit.
- We've resolved an issue where Beacon assets would not load; this happened most frequently with Flutter apps. Issue 91
- We now call prefill: on subsequent opens of the contact form in Secure Mode. Issue 34
- Beacon now builds successfully when using Xcode 12.5. Issue 153
Customers can now rate their chat experience after completion (for mailboxes with chat satisfaction ratings enabled).
- We smoothed out the transitions when following a deep link into the app. Issue 131
- We enhanced our color selection logic to ensure all text provides suitable contrast to be easily read. Issue 139
- Added tint color override and beacon color override settings to the Beacon Example app. Issue 143
- Beacon no longer experiences intermittent crashes when rotating a chat that includes an attachment.
- Beacon now does a better job of wrapping text. Issue 83
- We made the chat back button a bit easier to tap on an iPad. Issue 133
- We show previous messages when they are available from the first time Beacon is launched. Issue 140
- We restored the ability to print to console when integrating Beacon using SPM. Issue 145
- Customers can now rate articles on the iOS SDK.
- Beacon now attaches sessionAttributes when a customer starts a chat in addition to starting a conversation. Issue 103
- Customers can now have anonymous chats if the "Require email?" option in the Beacon config is set to false.
- Beacon can now be distributed to the App Store when the host application has Bitcode enabled. Issue 124
- Beacon no longer crashes when chat agents become unavailable after the customer attempted to start a chat. Issue 132
- You can now integrate Beacon into your project using the Swift Package Manager. Issue 114
- [HSBeacon handleWillPresentNotification: completion:] now returns a BOOL to indicate if Beacon called the completionHandler. Issue 104
- Customers now have a similar experience with Beacon on all platforms: web, Android, or iOS. Issue 67
- Customizing the focusMode configuration value at the SDK or the Beacon config level allows you to change the SDK's behavior and appearance for your users.
- Beacon now uses the PHPicker when attaching images and videos on iOS 14. Beacon no longer requests permission to the user's photo library when attempting to attach photos or videos. Issue 119
- User attributes are now set for all logged-in users, even if they haven't sent an email. Issue 115
- Non-logged-in users are now able to change their email address after sending a message. Issue 120
- Selecting the previous conversations button on the sent message screen will now redirect you to the appropriate place. Issue 108
- SwiftUI previews now work as we distribute Beacon 2.1.0 as an XCFramework. Issue 112
- Users will no longer experience a crash when trying to preview chat attachments on iOS 11 and 12.
HSBeaconMessagingSettings.showGetInTouch&HSBeaconMessagingSettings.showGetInTouchSethave been deprecated as they're no longer applicable in Beacon 2.1.HSBeacon.loginhas been deprecated in favor ofHSBeacon.identify. The method parameters have not changed, so replacing calls to login with identify is the only necessary change.
We discovered an issue where under some Beacon configurations the Beacon SDK could not be dismissed. Because of this we have removed 2.1.0 and will resolve those issues before publishing a new release. Please use 2.0.2 in the mean time, thank you for your patience.
- We no longer show the incorrect email error when pressing the send message button the first time. This resolves the following issues:
- We have addressed the crash observed when attempting to add a video from your camera roll to an in-progress chat session. (Issue 100)
- Beacon now respects the messaging setting allowAttachments in both the contact form and chat. (Issue 101)
- We have fixed the crash caused by suggesting articles to a user with a previously opened Beacon. (Issue 102)
- We have remediated a threading violation when minimizing an active chat. (Issue 105)
- We have addressed the unwanted navigation color change issues. (Issue 85 & Issue 73))
- If
emailTranscriptionEnabledis false, we won't display a message saying we will send your chat transcript to you in an email when the chat ends. (Issue 87)). - If
enablePreviousMessagesis set to false on yourHSBeaconSettingsobject, Beacon will no longer display a message about viewing previous conversations when a chat ends. - Beacon will now notify the
HSBeaconDelegatewhen it was closed due to being swiped away on iOS 13+. (Issue 88)) - Beacon will present push notifications for conversation replies while the user has your app in the foreground.
HSBeaconSettingsnow has a single designated initializer that takes the Beacon ID to prevent problems down the line.
- Live chat - Customers can now start a chat within your app on their iOS device, accessing great support no matter where they are.
- We have added support for session attributes. (Issue 70)
- Custom Suggestion URLs no longer crash when tapped on iPad. (Issue 59)
- Users can now continue to the next field in the contact form by using the return key. (Issue 69)
- We no longer duplicate prefilled attachments on subsequent presentations of the contact form. (Issue 68)
- Email-only Beacons will now go straight to the contact form instead of an intermediary screen. (Issue 74)
- We now build the Beacon SDK as a library for distribution. (Issue 75) & (Issue 78)
- The 'Send a Message' screen now properly uses localization overrides from the Beacon Web UI. (Issue 79)
- We have removed all external dependencies. (Issue 60)
- Many bugs with the new Chat feature have been fixed.
- Live chat - Now customers can start a chat from your app on their iOS device, accessing great support no matter where they are.
- Fixed the root cause of issue 40 where the Reply modal was not presented when attempting to respond via your Conversation history
- Push notifications will now successfully register for any messages delivered across all iOS versions
- Attachments can now be added to replies from the previous messages screen on iPad (Issue 52)
- Update our use of UIWebView to WKWebView (Issue 37)
- Improved error messaging in cases where we failed to load the Beacon configuration (Issue 38)
- Chat replies are now presented (Issue 40)
- Prevent the prefill method from being called multiple times (Issue 42)
- Dismissing Beacon now prompts the user correctly on iOS 13 (Issue 43)
- Fixed image picker warnings on the main thread (Issue 46)
- Text prefill does not prevent message submission (Issue 47)
- Fixes a crash reported in HSBeaconPreviousMessagesController. (Issue 33)
- Improves prefill behavior when opening a contact form subsequent times. (Issue 34)
- Fixes a crash when calling reset on a form with attachments. (Issue 35)
- Fixes not being able to select an image from the Photo Library on iOS 13. (Issue 39 & Issue 41)
- Fixes an issue that prevented some apps from supporting dark mode. (Issue 32)
- Added a
tintColorOverridesetting to allow for customization of the color of buttons and labels throughout the SDK
- Fixes for the Get In Touch & Messaging Enabled settings
- Fixes for CSS issues with nested
oltags
- New
resetmethod onHSBeaconto clear the current state - New
suggestWithItemsmethod that also allows for URL-based custom suggestions - New
HSBeaconDelegatemethods for intercepting Beacon open and close events - Improved VoiceOver support - translations for button accessibility labels and the navigation tabs now respond correctly in VoiceOver mode
- The
HSBeaconSettingsobject is now available on theHSBeaconContactFormobject when callingprefill. - Fixes for layout bugs on iPad where UI elements would render offscreen.
- The
colorattribute ofHSBeaconSettingsis now a strong reference. - The name and email fields are now always shown on the contact form unless the
loginmethod is called. This allows users who have manually entered these values to correct mistakes when sending a new email.
- We've fixed the message history for secure mode users that broke in build 0.69. Sorry for the trouble!
- Added a new method
suggestfor custom suggestions - Added
dismissBeaconmethod to make sure Beacon isn't in the way of other code in your app - Carthage support is back!
- A continued restructuring of our developer documentation
- The main Beacon controller now implements
preferredStatusBarStyleto try to resolve issue #19 - Article viewed activities will now link to the article in you Help Scout Beacon note, rather than the application in the App Store. Search activities will no longer show a link. This also resolves a crash with a missing
CFBundleName. Long term, we'll add the Beacon name & platform to the note so you can more easily identify the source.
- Fixed user attribute upload for unsecure users
- Fixed a crash condition with the
navigatemethod
- New methods on
HSBeacon-search,openArticle, andnavigate. - Our developer site now includes Jazzy generated API documentation.
- The text for "We usually respond in..." was not getting translated with the
useLocalTranslationOverridesoption enabled (reported issue)
- New local overrides added to
HSBeaconSettings- Color
- Docs enabled
- Custom fields enabled
- Show name
- Show subject
- Allow attachments
- Show get in touch
- Show prefilled custom fields
- User attribute limit increased to 30
- Attachment preview now uses QuickLook instead of
UIDocumentInteractionControllerto address App Store rejections
- Status bar color is restored when exiting Beacon
- Fixed a crash on previous messages with an empty subject reported here
- Added a flag for disabling the contact form
- Added a blank state in cases where Docs and Messaging are both disabled
- UI enhancements related to overlapping & loading content
- Dynamic Type will no longer need an app restart to take effect
- Fixed scrolling issues for articles with large tables
- Beacon is now distributed as a static framework
- Added up & down arrows to navigate between form fields
- Custom fields and agent avatars are now cached between loads
- Dynamic Type is supported in multiple areas
- Form field length limits are now more tightly enforced
- The contact form can now be prefilled to provide attachments and field values automatically
- Fix a case where related article links would not always work from search
- Ensure that the search results back button will adhere to the Beacon color
- Added state restoring when opening the same Beacon after it has been closed
- Improvements to network error handling
- Updated the visual appearance of custom fields
- Updated the contact button when viewing empty search results
- Fixed crashes around attachment uploading
- Fixed articles failing to load correctly
- Improve error handling in the Previous Messages flow
- Prevent sending duplicate messages when replying to a thread or starting a new one
- Attachments with zero length are now rejected
- Use
WKWebViewfor rendering articles
- Fix an issue with article cards where the status bar would overlap the article
- Fix an issue where the article content may never appear after loading
- Initial framework release
- Initial framework release