Der Messenger benötigt die neuesten mobilen SDKs, um Kunden die beste Erfahrung auf dem Handy zu bieten. Dieser Artikel erklärt, wie Sie den Messenger für mobile Geräte anpassen und welche Funktionen in iOS- und Android-Apps unterstützt werden.
Hinweis: Um den neuesten Mobile Messenger zu verwenden, müssen Sie die neuesten mobilen SDKs einsetzen. Installationsdetails finden Sie in unseren Developer Docs:
Sie müssen sicherstellen, dass der mobile Messenger aktiviert ist unter Einstellungen > Channels > Messenger > Installieren. Wenn dies deaktiviert ist, schlagen alle Anfragen an Intercom fehl und es kann ein Fehler im Zusammenhang mit der loginUnidentifiedUser oder loginUser-Methode zurückgegeben werden.
Messenger für mobile Geräte anpassen
Sie können Ihren Messenger auf dem Handy unter Einstellungen > Channels > Messenger > Mobile SDKs anpassen und eine Vorschau für iOS oder Android auswählen.
In mobilen Apps verfügbar
Wenn users den Messenger in Ihrer iOS- oder Android-App öffnen, startet er als native Bottom Sheet. So wirkt der Messenger organisch eingebettet und bietet eine konsistente und nahtlose Customer Journey. Der Nutzer sieht weiterhin genau, wo er sich in Ihrer App befindet, und kann entscheiden, wie er mit Ihnen im Messenger interagieren möchte.
Messenger-Stile konfigurieren
Die Messenger Mobile SDKs können mehrere Marken unterstützen, die Sie haben. Wählen Sie einen bestehenden Messenger-Stil aus oder fügen Sie einen neuen unter dem Stile-Tab hinzu.
Mobile Messenger-Stile unterstützen auch mehrere Help Center, stellen Sie also sicher, dass Sie das richtige Help Center mit der Marke verbunden haben, die Sie für diesen Messenger-Stil verwenden.
Gestalten Sie jeden Messenger-Stil passend zu Ihren Geschäftsanforderungen. Stylen Sie ihn mit Ihrem Logo und einer Kopfzeilen-Hintergrundfarbe oder einem Bild.
Direkt in die Konversation starten
Entscheiden Sie dann, ob der Messenger direkt im Nachrichtenbereich starten soll (damit customers eine neue Konversation beginnen oder vorherige Nachrichten ansehen können), indem Sie "Direkt in eine Konversation starten" unter Messenger > Mobile SDKs > Inhalt aktivieren.
Diese neue Einstellung sorgt dafür, dass Ihre customers schneller Support erhalten, indem zusätzliche Schritte zum Starten eines neuen Chats mit Ihrem Team entfallen.
Messenger-Bereiche konfigurieren
Konfigurieren Sie nun, mit welchen Buttons customers im Home-Bereich interagieren können, indem Sie die Tickets und/oder Help-Bereiche unter Messenger > Mobile SDKs > Inhalt > Bereiche hinzufügen oder entfernen. (Messages können nicht deaktiviert werden).
Customers können Konversationen starten mit Ihnen vom Home- und Messages-Bereich, wenn sie Ihren Zielgruppenregeln entsprechen.
Sie können auch tickets einreichen und deren Fortschritt im dedizierten Tickets-Bereich verfolgen (wenn Sie diesen aktiviert haben).
Begrüßungsnachricht festlegen
Legen Sie fest, wie Sie customers im Messenger-Home-Bereich begrüßen möchten, indem Sie Ihre Begrüßungsnachricht einstellen. Ihre Begrüßungsnachricht kann für alle Ihre unterstützten Sprachen konfiguriert werden.
Home mit Apps anpassen
Unter Messenger > Mobile SDKs > Inhalt > Home mit Apps anpassen können Sie zusätzliche Apps zum Home-Bereich hinzufügen, wie z. B. Send us a message oder Search for help und andere Apps, die Sie in Ihrem Workspace installiert haben.
Unterschiede zwischen Web- und Mobile-SDKs
Bereiche
Web - Bereiche erscheinen als Tabs unten im Messenger. Diese Tab-Leiste ist immer sichtbar auf der obersten Ebene jedes Bereichs.
Mobile SDKs - Bereiche erscheinen nur als Buttons oben im Home-Bereich. Sie erscheinen nicht in anderen Bereichen.
Navigation
Web - Die Tab-Leiste verschwindet, wenn customers innerhalb eines Bereichs navigieren (z. B. zu einem Artikel, einer Konversation oder einem ticket). Ein „Zurück“-Button erscheint oben im Messenger.
Mobile SDKs - Customers können von jedem Bereich mit dem „Zurück“-Button (oder dem System-„Zurück“-Button auf Android) zum Home-Bereich zurückkehren.
Benachrichtigungen
Web - Bereichs-Tabs zeigen Benachrichtigungsabzeichen, wenn sie neue Inhalte enthalten (z. B. eine neue Nachricht in einer Konversation).
Mobile SDKs - Bereichs-Buttons zeigen Benachrichtigungsabzeichen, wenn sie neue Inhalte enthalten (z. B. eine neue Nachricht in einer Konversation oder eine ticket-Statusaktualisierung).
Nachrichten in den Mobile SDKs
Im Messages-Bereich gibt es auf iOS einen Button in der Kopfzeile, um eine neue Konversation zu starten. Auf Android gibt es stattdessen einen Floating Action Button.
Android SDK
Da dies ein großes Update ist, gibt es einige API-Änderungen, die unten aufgeführt sind:
Methode - Kotlin | Beschreibung |
fun present(space: IntercomSpace) | Öffnet einen bestimmten Bereich in Intercom. (Home, Messages, Help Center). Standardmäßig Home-Bereich. Gibt void zurück – akzeptiert keinen Callback. |
fun present() | Öffnet Intercom – standardmäßig den Home-Bereich. Gibt void zurück – akzeptiert keinen Callback. |
fun presentContent(content: IntercomContent) | Zeigt Intercom-Inhalte an. Gültige Inhaltstypen sind Artikel, Karussell, Help Center-Sammlungen. |
Hinweis: Keine der Methoden in dieser Tabelle akzeptiert einen Callback- oder Listener-Parameter. present(), present(space) und presentContent(content) geben alle void zurück – beachten Sie die Wichtig-Hinweise unten, die beeinflussen, ob present() erfolgreich ist (nur nach dem onSuccess von loginIdentifiedUser aufrufen).
Wichtig: Rufen Sie present() oder present(space: IntercomSpace) nur nach dem onSuccess-Callback von loginIdentifiedUser (oder loginUnidentifiedUser) auf. Ein sofortiger Aufruf nach dem Login-Start – bevor der asynchrone Aufruf abgeschlossen ist – führt zu einem stillen Fehler mit "Etwas ist schiefgelaufen", da das SDK noch nicht bereit ist.
Diese Methoden können weiterhin verwendet werden, werden aber in einer zukünftigen Version entfernt.
Methode - Kotlin |
fun displayMessenger() |
fun displayHelpCenter() |
fun displayHelpCenterCollections(collectionIds: List<String>) |
fun displayArticle(articleId: String) |
fun displayCarousel(carouselId: String) |
fun displaySurvey(surveyId: String) |
iOS SDK
Da dies ein großes Update ist, gibt es einige API-Änderungen, die unten aufgeführt sind:
Methode - Swift | Methode - Obj-C | Beschreibung |
func present(_ space:Space) | + (void)presentIntercom:(Space)space | Öffnet einen bestimmten Bereich in Intercom. (Home, Messages, Help Center). |
func present() | + (void)presentIntercom | Öffnet Intercom – standardmäßig den Home-Bereich. |
func presentContent(_ content: Content) | + (void)presentContent:(IntercomContent *)content | Zeigt Intercom-Inhalte an. Gültige Inhaltstypen sind Artikel, Karussell, Help Center-Sammlungen. |
Die folgenden Methoden wurden ebenfalls vollständig veraltet:
Methode - Swift | Methode - Obj-C |
func presentMessenger() | + (void)presentMessenger |
func presentHelpCenter() | + (void)presentHelpCenter |
func presentHelpCenterCollections(_ collectionIds: [String]) | + (void)presentHelpCenterCollections:(nonnull NSArray<NSString *> *)collectionIds |
func presentArticle(_ articleId: String) | + (void)presentArticle:(nonnull NSString *)articleId |
func presentCarousel(_ carouselId: String) | + (void)presentCarousel:(nonnull NSString *)carouselId |
func presentSurvey(_ surveyId: String) | + (void)presentSurvey:(nonnull NSString *)surveyId |
Abwärts- und Aufwärtskompatibilität für mobile SDKs
Es ist möglich, dass Ihr Workspace und die mobilen SDKs nicht synchron sind. Zum Beispiel kann der neue Messenger in Ihren Einstellungen aktiviert sein, aber die mobilen SDKs in Ihrer App noch nicht aktualisiert sein. So funktioniert das:
| Vorherige Messenger-Einstellungen (Sie haben nicht zugestimmt.) | Neue Messenger-Einstellungen (Sie haben zugestimmt.) |
Vorheriges Messenger Mobile SDK (weniger als v14.0.1) | Funktioniert wie zuvor. Alle vorherigen Messenger-Einstellungen werden berücksichtigt. | Die neuen Messenger-Einstellungen werden sinnvoll angewendet, um die vorherige Messenger-Erfahrung in der mobilen App darzustellen.
Einige der neuen Messenger-Funktionen funktionieren im vorherigen Messenger Mobile SDK nicht:
|
Neues Messenger Mobile SDK (v14.0.1 und höher) | Die vorherigen Messenger-Einstellungen werden sinnvoll angewendet, um die neue Messenger-Erfahrung in der mobilen App darzustellen.
Zum Beispiel:
| Alle neuen Messenger-Einstellungen werden berücksichtigt. |