Instale o Intercom no seu app iOS ou Android para ver quem são seus users e conecte-se com eles em todos os pontos de contato:
Engaje-os com mensagens push automatizadas.
Ofereça suporte com um Agente AI integrado, Help Center e o Intercom Messenger.
Engaje proativamente e faça upsell com Workflows de saída.
Faça onboarding e nutra-os com Carrosséis Móveis.
Tudo isso sem que eles precisem sair do seu app.
Instalando e configurando o Intercom no seu aplicativo móvel
Instalar o Intercom no seu app móvel leva apenas alguns minutos com nossos SDKs nativos para iOS, Android, React Native e Cordova.
Ao instalar o Intercom no seu app móvel, você deve configurar os dados personalizados que deseja rastrear sobre seus users. Isso permite enviar mensagens e carrosséis mais direcionados e personalizados.
Você ou seu desenvolvedor podem encontrar instruções sobre como fazer isso em nossa documentação para desenvolvedores:
Os SDKs também são pequenos, então não vão deixar seu app mais lento. 👌
Seletor de plataforma
Na página Canais > Messenger > Instalar, você será solicitado a escolher se deseja instalar o Messenger em um ambiente web ou móvel.
Escolher Instalar para web exibirá o fluxo de instalação para sites, escolher Instalar para mobile exibirá o novo fluxo de instalação para apps móveis. 👇
O status para mobile exibirá “Não instalado” se nem Android nem iOS estiverem instalados, ou “Instalado com segurança” se ambos estiverem instalados.
Há três etapas para você completar para instalar o Messenger em seus apps móveis.
Instalação inicial do Messenger
Escolha sua plataforma de instalação preferida; iOS, Android ou React Native. Todas as plataformas escolhidas têm etapas específicas para essa plataforma.
Você receberá opções de como instalar o Intercom em seus apps móveis e alguns trechos de código para ajudar na instalação. As opções de trechos de código fornecidas para iOS são:
Swift Package Manager
Cocoapods
Instalação manual
As opções de trechos de código fornecidas para Android são:
Groovy
Kotlin
Nota: O botão “Ativar tráfego de usuário para o messenger” é obrigatório para a instalação móvel do Messenger.
As opções de trechos de código fornecidas para React Native são:
Yarn
NPM
Expo
O próximo passo será "Inicializar o Intercom" dentro do código do seu app móvel. Você também pode gerenciar suas chaves API nesta etapa. As opções de trechos de código para iOS são:
Swift
Swift UI
ObjectiveC
As opções de trechos de código para Android são:
Kotlin
Java
As opções para React Native são:
iOS
Android
O botão Verificar instalação no final oferece uma notificação de sucesso se o Messenger foi encontrado com sucesso para sua instalação escolhida, ou indica se algo deu errado.
Nota: Ao conectar seu app móvel à API do Messenger, certifique-se de que o endpoint corresponda à região de hospedagem de dados do seu workspace. Workspaces hospedados nos EUA devem usar o endpoint padrão da API (sem 'eu' na URL), enquanto workspaces hospedados na UE devem usar o endpoint da UE. Usar o endpoint errado resultará em erros 404.
Protegendo seu Messenger com JWTs
Recentemente melhoramos nossa oferta de segurança do Messenger para usar JSON web tokens em vez de HMACs. Esta atualização substitui o método anterior de Verificação de Identidade (IdV) por recursos projetados para proteger os dados dos users.
Com JWTs, você se beneficia de:
✅ Proteção de dados — Assine e proteja tanto o ID do user quanto o e-mail, junto com quaisquer outros atributos do user.
✅ Tokens de curta duração — JWTs podem ser configurados para expirar, reduzindo o risco de uso indevido de tokens comprometidos.
Para proteger seu Messenger com JWTs, escolha iOS ou Android aqui e siga as instruções.
Nota: para React Native, você ainda deve usar Verificação de Identidade, pois o suporte a JWT ainda não foi lançado aqui.
Protegendo seu Messenger com Verificação de Identidade [Obsoleto]
Verificação de Identidade no mobile, vá para Configurações > Instalação > Instalar para mobile e escolha a plataforma de instalação; iOS, Android ou React Native.
Semelhante à etapa inicial de instalação, você será solicitado a escolher com qual plataforma deseja instalar o SDK React Native (iOS ou Android).
Trechos de código e instruções são fornecidos sobre como gerar um código HMAC (Hash-based Message Authentication Code) dentro do seu backend e fornecê-lo ao Intercom Messenger. Este código HMAC é usado pelo Intercom para verificar a autenticidade das interações dos users no Messenger.
Um trecho de código adicional é fornecido para que você possa incluir o HMAC ao inicializar o Intercom no seu app móvel. As opções de trechos de código fornecidas para iOS são:
Swift
Swift UI
ObjectiveC
As opções de trechos de código fornecidas para Android são:
Kotlin
Java
Para React Native, fornecemos um exemplo de trecho de código de como você pode usar o código HMAC para inicializar o Intercom com verificação de identidade.
A etapa final no processo de verificação de identidade é aplicar a verificação de identidade. Uma vez feito isso, todas as solicitações do Messenger que não incluírem o código HMAC válido serão rejeitadas.
Nota: Quando você aplica a verificação de identidade para um app iOS ou Android, a segunda etapa é marcada como concluída.
⚠️ Encerre as sessões dos seus users ao fazer logout
Garanta que você encerre o Intercom para limpar as conversas dos seus clientes quando eles saírem do seu app.
Veja como fazer isso em Objective C
- (void)logout { [Intercom logout]; }Veja como fazer isso em Java
private void logout() {
Intercom.client().logout();
}Nota: Você deve apenas fazer logout de um user identificado. Fazer logout de um user não identificado resultará em registros órfãos que não poderão ser mesclados no futuro.
O Intercom sabe quando seu app está em segundo plano e volta a funcionar, então você não precisará fazer login dos seus users novamente.
Opcional: Configurar notificações push
Nesta etapa, você terá novamente a opção da plataforma de instalação; iOS ou Android. Você pode configurar notificações push nesta seção, mas ela não irá guiá-lo pelo processo. Em vez disso, nossa documentação para desenvolvedores deve ser usada para a configuração de notificações push:
Nota: React Native não é oferecido como opção para notificações push móveis.
Nota: Esta etapa opcional é marcada como concluída quando as notificações push forem detectadas como configuradas para um app iOS ou Android.
Importante: Xcode 14 agora é necessário para compilar o Intercom iOS SDK v13.0.0+
No Xcode 14, vários avisos são registrados no console quando o SDK é instalado. Os avisos decorrem do uso do WKWebView pelo Intercom. Há um bug no Xcode 14 que gera esses avisos, e não é um problema que o Intercom possa corrigir.
São apenas avisos e o Intercom continua funcionando normalmente quando eles estão presentes.
Aqui estão as mensagens de aviso:
Erro WKWebView - Veja o artigo e você verá isso no console: Erro ao adquirir asserção: <Error Domain=RBSServiceErrorDomain Code=1 "target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit" UserInfo={NSLocalizedFailureReason=target is not running or doesn't have entitlement com.apple.runningboard.assertions.webkit}>Este método não deve ser chamado na thread principal, pois pode levar à falta de resposta da UI.[Sandbox] Não foi possível ativar Mach bootstrap, errno = 22.
Integre profundamente seu Help Center no seu app móvel
Incluir seu Help Center de Artigos diretamente no seu app móvel oferece muitas maneiras flexíveis de apresentar conteúdo de ajuda para seus users. Seja usando a UI pré-construída do Intercom ou desenvolvendo sua própria apresentação personalizada, você pode dar aos seus clientes exatamente o suporte que eles precisam.
Mantendo as conversas dos seus users seguras
Reforçamos fortemente a recomendação de ativar a Segurança do Messenger no seu app iOS e/ou Android. Isso ajuda a garantir que as conversas entre você e seus users sejam mantidas privadas, e que um user não possa se passar por outro.
Para instruções detalhadas sobre como configurar isso, veja nosso documento do help centre ou suas configurações de segurança. Para instruções móveis, veja nossa documentação para desenvolvedores para iOS e Android.