O Messenger requer os SDKs móveis mais recentes para oferecer a melhor experiência aos clientes no celular. Este artigo explica como personalizar o Messenger para dispositivos móveis e quais recursos são suportados nos apps iOS e Android.
Nota: Para usar o Mobile Messenger mais recente, você precisará estar usando os SDKs móveis mais recentes. Detalhes da instalação podem ser encontrados em nossos Developer Docs:
Você deve garantir que o Mobile Messenger esteja ativado dentro do painel de configurações do Intercom. Quando desativado, todas as solicitações para o Intercom falharão e um erro relacionado ao método loginUnidentifiedUser ou loginUser pode ser retornado.
Personalize o Messenger para dispositivos móveis
Você pode personalizar e visualizar seu Messenger no celular em Configurações > Canais > Messenger > SDKs móveis e então selecionar a visualização do dispositivo para iOS ou Android.
Disponível em apps móveis
Quando users acessam o Messenger no seu app iOS ou Android, ele é aberto como uma folha nativa na parte inferior. Isso permite que o Messenger pareça e funcione como se estivesse embutido organicamente, proporcionando uma jornada do cliente consistente e fluida. O user ainda pode ver exatamente onde está no seu app e decidir como quer interagir com você no Messenger.
Configure os estilos do Messenger
Os SDKs móveis do Messenger podem suportar múltiplas marcas que você possa ter. Selecione ou adicione um novo estilo de Messenger na aba Estilos.
Os estilos do Mobile Messenger também suportam multi-brand Help Center, então certifique-se de que você conectou o Help Center correto à marca que está usando para este estilo de Messenger.
Projete cada estilo de Messenger para atender às necessidades do seu negócio. Estilize com seu logo e uma cor ou imagem de fundo no cabeçalho.
Inicie diretamente na Conversa
Depois decida se deseja que o Messenger seja aberto diretamente no espaço de Messages (para que os clientes iniciem uma nova conversa ou vejam mensagens anteriores) ativando "Iniciar diretamente em uma Conversa" em Messenger > SDKs móveis > Conteúdo.
Esta nova configuração garante que seus clientes tenham acesso mais rápido ao suporte, eliminando etapas adicionais para iniciar um novo chat com sua equipe.
Configure os espaços do Messenger
Agora configure quais botões os customers podem interagir no espaço Home adicionando/removendo os espaços Tickets e/ou Help em Messenger > SDKs móveis > Conteúdo > Espaços. (O espaço Messages não pode ser desativado).
Customers poderão iniciar conversas com você a partir dos espaços Home e Messages se corresponderem às suas regras de público.
Eles também podem enviar tickets e acompanhar seu progresso no espaço dedicado Tickets (se você o tiver ativado).
Defina sua mensagem de boas-vindas
Decida como você gostaria de cumprimentar os customers no espaço Home do Messenger definindo sua mensagem de boas-vindas. Sua mensagem de boas-vindas pode ser configurada para todos os seus idiomas suportados.
Personalize o Home com apps
Em Messenger > SDKs móveis > Conteúdo > Personalizar home com apps, você pode adicionar apps adicionais ao espaço Home, como Send us a message ou Search for help, e outros apps que você instalou no seu workspace.
Diferenças entre SDKs web e móveis
Espaços
Web - Os espaços aparecem como abas na parte inferior do Messenger. Esta barra de abas está sempre visível no nível mais alto de cada espaço.
SDKs móveis - Os espaços aparecem como botões apenas no topo do espaço Home. Eles não aparecem em outros espaços.
Navegação
Web - A barra de abas desaparece quando os customers navegam para conteúdo dentro de um espaço (ex: um artigo, conversa ou ticket). Um botão de ‘voltar’ aparece no topo do Messenger.
SDKs móveis - Os customers podem navegar de volta ao espaço Home a partir de qualquer outro espaço usando o botão ‘voltar’ (ou o botão ‘voltar’ do sistema no Android).
Notificações
Web - As abas dos espaços mostrarão indicadores de notificação se contiverem conteúdo novo (ex: uma nova mensagem em uma conversa).
SDKs móveis - Os botões dos espaços mostrarão indicadores de notificação se contiverem conteúdo novo (ex: uma nova mensagem em uma conversa ou uma atualização de status de ticket).
Mensagens nos SDKs móveis
No espaço Messages há um botão no cabeçalho no iOS para iniciar uma nova conversa. No Android, há um Floating Action Button em vez disso.
Android SDK
Como esta é uma atualização importante, há algumas mudanças na API listadas abaixo:
Método - Kotlin | Descrição |
fun present(space: IntercomSpace) | Abra um espaço específico no Intercom. (Home, Messages, Help Center). O padrão é o espaço Home. |
fun present() | Abra o Intercom - padrão para o espaço Home. |
fun presentContent(content: IntercomContent) | Apresente conteúdo do Intercom. Tipos válidos de conteúdo são Article, Carousel, Help Center Collections. |
Estes métodos ainda podem ser usados, mas serão removidos em uma versão futura.
Método - Kotlin |
fun displayMessenger() |
fun displayHelpCenter() |
fun displayHelpCenterCollections(collectionIds: List<String>) |
fun displayArticle(articleId: String) |
fun displayCarousel(carouselId: String) |
fun displaySurvey(surveyId: String) |
iOS SDK
Como esta é uma atualização importante, há algumas mudanças na API listadas abaixo:
Método - Swift | Método - Obj-C | Descrição |
func present(_ space:Space) | + (void)presentIntercom:(Space)space | Abra um espaço específico no Intercom. (Home, Messages, Help Center). |
func present() | + (void)presentIntercom | Abra o Intercom - padrão para o espaço Home. |
func presentContent(_ content: Content) | + (void)presentContent:(IntercomContent *)content | Apresente conteúdo do Intercom. Tipos válidos de conteúdo são Article, Carousel, Help Center Collections. |
Os seguintes métodos também foram totalmente descontinuados:
Método - Swift | Método - 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 |
Compatibilidade retroativa e futura para SDKs móveis
É possível que seu workspace e SDKs móveis estejam fora de sincronia. Por exemplo, você pode ter o novo Messenger ativado nas suas configurações, mas ainda não ter atualizado os SDKs móveis no seu app. Veja como isso funcionará:
| Configurações anteriores do Messenger (Você não optou por participar.) | Configurações novas do Messenger (Você optou por participar.) |
SDK móvel do Messenger anterior (menor que v14.0.1) | Funciona da mesma forma que antes. Todas as configurações anteriores do Messenger são respeitadas. | As novas configurações do Messenger serão aplicadas de forma sensata para renderizar a experiência anterior do Messenger no app móvel.
Alguns dos novos recursos do Messenger não funcionarão no SDK móvel do Messenger anterior:
|
Novo SDK móvel do Messenger (v14.0.1 e superior) | As configurações anteriores do Messenger serão aplicadas de forma sensata para renderizar a nova experiência do Messenger no app móvel.
Por exemplo:
| Todas as novas configurações do Messenger são respeitadas. |