Use este artigo para instalar o Intercom Messenger no seu aplicativo móvel, autenticar seus users conectados com segurança e confirmar que tudo está funcionando antes de lançar.
Os passos para uma instalação completa e segura do Messenger são:
Escolha seu tipo de instalação.
Instale e inicialize o SDK.
Autentique users conectados.
Teste sua instalação.
Nota:
Esta é a nova experiência de instalação do Messenger, sendo implementada gradualmente. Se seu workspace ainda não foi atualizado, use Instale e use o Intercom no seu aplicativo móvel em vez disso.
Você precisará de um plano contratado ou mensal para instalar o Messenger, e acesso ao código do seu app (ou um desenvolvedor que tenha). O Messenger suporta iOS, Android e React Native.
Escolha seu tipo de instalação
Vá para Configurações > Canais > Messenger Live Chat > Visão geral , encontre o cartão Mobile app e selecione Instalar no aplicativo móvel.
Selecione seu tipo de instalação
Você será perguntado "Que informações sua equipe precisa na sua inbox?" e verá duas opções:
Users não conectados (mais rápido para instalar) — As conversas não são vinculadas aos detalhes do user. Você pode completar a configuração adicional depois para identificar users conectados.
Users conectados e users não conectados — As conversas de users conectados incluem detalhes relevantes, dando à sua equipe o contexto necessário para fornecer suporte personalizado. Requer mudanças no app e backend.
Selecione a opção que se encaixa no seu negócio, depois clique em Continuar para avançar para os passos de instalação abaixo.
Instale e inicialize o SDK
Esta seção cobre os passos 1 a 3 da instalação. Leva apenas alguns minutos e se aplica independentemente de você estar identificando users conectados.
1. Escolha sua plataforma
Use o menu suspenso Mobile app platform para escolher em qual plataforma você está instalando: iOS, Android ou React Native. Os passos abaixo usam iOS como exemplo — o formato do fluxo é o mesmo para outras plataformas, com código específico para cada uma.
2. Adicione a dependência do SDK
Escolha seu método de instalação no menu suspenso (para iOS, isso inclui Swift Package Manager e CocoaPods). Para Swift Package Manager:
No Xcode, navegue até Arquivo > Adicionar Pacotes.
Quando solicitado, insira a URL do repositório do Intercom iOS SDK (kit de desenvolvimento de software):
.package(url: "https://github.com/intercom/intercom-ios", from: "18.0.0")
Selecione a versão do Intercom que deseja usar. Recomendamos usar a versão mais recente.
Clique em Adicionar Pacote e o Intercom será automaticamente baixado como dependência para seu projeto.
3. Inicialize o Intercom
Você verá sua chave API específica da plataforma nesta etapa — por exemplo, sua Chave API iOS. Clique em Copiar código para copiá-la, ou Regenerar chave API se precisar de uma nova.
Chame o seguinte no método delegado da sua aplicação:
import UIKit
import Intercom
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions
launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
Intercom.setApiKey("YOUR_IOS_API_KEY", forAppId: "YOUR_APP_ID")
Intercom.setLauncherVisible(true)
// If you have identifying information for your user you can use
// `Intercom.loginUser(with:completion:)`
Intercom.loginUnidentifiedUser()
return true
}
}Autentique users conectados
Esta seção cobre os passos 4 a 7, e precisa de mudanças tanto no seu aplicativo móvel quanto no backend.
4. Escolha sua linguagem de backend
Use o menu suspenso para escolher a linguagem em que seu backend está escrito (por exemplo, Node).
Dica: Este passo precisa que alguém gere tokens no servidor. Se não for você, clique em Convidar um desenvolvedor para trazer um colega para finalizar com você.
5. Gere um token para cada cliente
No seu servidor, gere um JSON Web Token (JWT) assinado para cada user conectado:
const jwt = require('jsonwebtoken');
const token = jwt.sign(
{ user_id: user.id, email: user.email },
process.env.INTERCOM_SECRET_KEY,
{ algorithm: 'HS256', expiresIn: '1h' },
);
Você precisará da chave secreta do seu workspace para isso — ela é mostrada (mascarada) nesta etapa. Mantenha essa chave no seu servidor. Nunca a inclua no código do navegador ou do app.
Nota: As chaves são específicas para plataformas, e seu workspace pode ter mais de uma. Você pode criar, rotacionar ou decodificar uma chave nas configurações de segurança do Messenger.
6. Configure o JWT no seu aplicativo móvel
Passe o token gerado pelo seu servidor na sua chamada de inicialização do Intercom existente, junto com seu app_id:
Intercom({
app_id: 'your_app_id',
intercom_user_jwt: user.jwt,
});
7. Identifique users
Uma vez que o JWT esteja configurado, identifique o user conectado com:
Intercom.loginUser(
ICPRegistrationOptions.create(userJwt: user.jwt)
) { result in }Importante: Versões antigas do app não enviarão tokens assinados. Se seu app já está ativo, os dados dos clientes não serão conectados até que seus users atualizem o app. Recomendamos uma atualização forçada para que todos usem uma versão que envie o JWT.
Teste sua instalação
Depois de completar os passos acima, clique em Teste sua instalação. Isso confirma que o Messenger e (se aplicável) sua configuração de JWT estão funcionando corretamente antes de lançar para seus users.
Se algo não estiver funcionando, verifique:
O app_id na sua chamada de inicialização corresponde ao seu workspace.
Sua chave secreta não foi rotacionada ou revogada desde que você gerou seu último token.
O user_id que você está passando para o SDK corresponde ao que está codificado no payload do JWT.
Quando tudo estiver correto, você estará ao vivo. Pode verificar o status da instalação a qualquer momento em Configurações > Canais > Messenger Live Chat > Visão geral, em Locais de instalação.
Nota: O tempo de sessão é configurável em Configurações > Canais > Messenger Live Chat > Segurança, em Duração da sessão. Os clientes são solicitados a se reautenticar quando esse período expira.
💡 Dica: Precisa de mais ajuda? Obtenha suporte no nosso Fórum da Comunidade. Encontre respostas e receba ajuda do Suporte Intercom e Especialistas da Comunidade.