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 em Configurações > Canais > Messenger > Instalar. Quando isso estiver desativado, todas as solicitações para 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 > Mobile SDKs 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 integrado organicamente, proporcionando uma jornada do cliente consistente e fluida. O usuário ainda pode ver exatamente onde está no seu app e decidir como quer interagir com você no Messenger.
Configure os estilos do Messenger
Os Mobile SDKs 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 ter conectado o Help Center correto à marca que você 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.
Abrir diretamente na Conversa
Depois, decida se deseja que o Messenger abra diretamente no espaço de Messages (para que os clientes iniciem uma nova conversa ou vejam mensagens anteriores) ativando "Abrir diretamente em uma Conversa" em Messenger > Mobile SDKs > 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 > Mobile SDKs > 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 o progresso deles 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 pode ser configurada para todos os seus idiomas suportados.
Personalize o Home com apps
Em Messenger > Mobile SDKs > 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 web e mobile SDKs
Espaços
Web - Os espaços aparecem como abas na parte inferior do Messenger. Esta barra de navegação por abas está sempre visível no nível mais alto de cada espaço.
Mobile SDKs - 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 ‘voltar’ aparece no topo do Messenger.
Mobile SDKs - Os customers podem voltar ao espaço Home 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).
Mobile SDKs - 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 mobile SDKs
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. Retorna void — não aceita callback. |
fun present() | Abra o Intercom - padrão para o espaço Home. Retorna void — não aceita callback. |
fun presentContent(content: IntercomContent) | Apresente conteúdo do Intercom. Tipos válidos de conteúdo são Article, Carousel, Help Center Collections. |
Nota: Nenhum dos métodos nesta tabela aceita parâmetro callback ou listener. present(), present(space) e presentContent(content) retornam void — use a nota Important abaixo para a única coisa que afeta se present() tem sucesso (chamar somente após o onSuccess do loginIdentifiedUser ser disparado).
Importante: Chame present() ou present(space: IntercomSpace) somente após o callback onSuccess do loginIdentifiedUser (ou loginUnidentifiedUser) ter sido disparado. Chamar qualquer um dos métodos imediatamente após iniciar o login — antes da chamada assíncrona ser concluída — faz com que falhe silenciosamente com "Algo deu errado", pois o SDK ainda não está pronto para renderizar.
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 mobile SDKs
É possível que seu workspace e os mobile SDKs estejam fora de sincronia. Por exemplo, você pode ter o novo Messenger ativado nas configurações, mas ainda não ter atualizado os mobile SDKs 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.) |
Mobile SDK anterior do Messenger (menor que v14.0.1) | Funciona como 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 mobile SDK anterior do Messenger:
|
Mobile SDK novo 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. |