Por favor, note: em 4 de abril de 2025, a integração do OneSignal construída pela HubSpot será o pôr do sol. Após essa data, o aplicativo não terá mais suporte e não atualizará dados em contas HubSpot. É recomendável instalar a nova integração do OneSignal compilada pelo OneSignal avançando.
Com a integração do OneSignal, você pode criar e enviar notificações push do OneSignal usando fluxos de trabalho, exibir notificações push nos cronogramas de atividade dos contatos e segmentar usuários com base no engajamento com notificações push
Requisitos de integração
Como conectar o aplicativo
- Na sua conta HubSpot, clique no ícone do Marketplace marketplace na barra de navegação superior e selecione App Marketplace.
- Use a barra de pesquisa para localizar e selecionar a integração do OneSignal.
- No canto superior direito, clique em Instalar aplicativo.
- Faça logon em sua conta do OneSignal.
- Na caixa pop-up, insira a ID do aplicativo e a chave de API da sua conta do OneSignal.
- Se necessário, clique em Adicionar aplicativo para adicionar outro aplicativo.
- Clique em Instalar aplicativo.
- Você será redirecionado para a página Aplicativos conectados.
Corresponda seu usuário do OneSignal ao seu usuário do HubSpot
A integração requer a correspondência do usuário do OneSignal com os contatos do HubSpot. Os usuários têm duas opções para correspondência:
- Por endereço de e-mail: os usuários precisam usar a função setEmail do OneSignal utilizando o SDK para associar os usuários do OneSignal a endereços de e-mail. Esta opção de correspondência só está disponível para a ação de fluxo de trabalho Enviar Notificação do OneSignal .
- Por OneSignal external_user_id: os usuários precisarão selecionar a propriedade do contato HubSpot que desejam corresponder com a external_user_id no OneSignal. Para fazer isso:
- Na sua conta HubSpot, clique no ícone de <configurações< <settings icon< na barra de navegação superior. No menu da barra lateral esquerda, acesse <Integrações< > <Apps conectados<.
- Clique em OneSignal.
- Clique em Contato Matching.
- No menu suspenso, selecione a propriedade do contato HubSpot que deseja usar para correspondência com a propriedade external_user_id do OneSignal . Esta opção de correspondência está disponível para as ações de fluxo de trabalho Enviar notificações do OneSignal e Editar marcas do OneSignal .
Automatizar notificações por push do OneSignal
Você pode automatizar o envio de notificações por push do OneSignal usando fluxos de trabalho.
- Na sua conta HubSpot, acesse Automações > Fluxos de trabalho.
- No canto superior direito, clique em Criar fluxo de trabalho.
- No painel esquerdo, selecione Baseado em contato e clique em Próximo no canto superior direito.
- Defina disparadores de inscrição.
- Clique no ícone de adição + para adicionar uma ação.
- No painel direito, selecione Enviar notificação do OneSignal.
- Clique no menu suspenso Selecionar Aplicativo para selecionar seus aplicativos OneSignal conectados.
- Clique no menu suspenso Deseja usar um Modelo OneSignal Push existente ou Criar um Novo Push? e selecione uma opção de modelo:
- Para selecionar um modelo existente, clique em Usar modelos.
-
- Para criar um novo modelo, clique em Usar configuração personalizada e preencha os campos necessários. Você pode usar tokens de personalização nesses campos.
- Clique em Salvar.
- Você pode adicionar mais ações ao seu fluxo de trabalho.
- Quando terminar de configurar seu fluxo de trabalho, clique em Revisar no canto superior direito.
- Revise seu fluxo de trabalho configurado e clique em Ativar no canto superior direito.
A notificação por push aparecerá como uma atividade na linha do tempo do registro do contato.
Automatizar marcas do OneSignal para gatilho de mensagens no aplicativo
Use fluxos de trabalho para gatilho de mensagens no aplicativo em seu aplicativo OneSignal.
- Na sua conta HubSpot, acesse Automações > Fluxos de trabalho.
- Na parte superior direita, clique em Criar fluxo de trabalho .
- No painel esquerdo, selecione baseado em Contato e clique em Avançar no canto superior direito.
- Defina disparadores de inscrição.
- Clique no ícone ++ para adicionar uma ação.
- No painel direito, selecione Editar tags do OneSignal.
- Clique nos menus suspensos Selecionar Aplicativo para selecionar seus aplicativos OneSignal conectados.
- Insira a cadeia de caracteres JSON com { "key" : } pares de "value" que deseja editar. Saiba mais sobre como usar marcas de dados do OneSignal.
- Clique em Salvar.
- Você pode adicionar ações adicionais ao fluxo de trabalho .
- Quando terminar de configurar seu fluxo de trabalho, clique em Revisar no canto superior direito.
- Revise a configuração do fluxo de trabalho e clique em Ativar.
A edição de marcas OneSignal também pode ativar mensagens no aplicativo no OneSignal. Consulte o guia do OneSignal para obter etapas sobre como fazer isso.
Para usar essa funcionalidade, verifique se você tem o código apropriado das configurações do OneSignal Web Push adicionado ao HTML de cabeçalho das páginas.
Você tem duas opções para capturar e passar endereços de e-mail para o OneSignal:
- Coloque o seguinte globalmente em seu <head> ...</head> para aplicar em envios de formulários:
window.addEventListener('message', event => {
if(event.data.type === 'hsFormCallback' && event.data.eventName === 'onFormSubmit') {
OneSignal.push(function() {
OneSignal.setEmail($("input[name=email]").val())
.then(function(emailId) {
// Callback called when email have finished sending
console.log("emailId: ", emailId);
});
}
});
- Edite o script incorporado para um de seus formulários do HubSpot diretamente. Você precisará inserir sua ID do portal e ID do formulário da sua conta. Veja este exemplo:
<script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/v2.js"></script>
<script>
hbspt.forms.create({
region: "na1",
portalId: "YOUR PORTAL ID",
formId: "YOUR FORM ID",
onFormSubmit: function($form) {
OneSignal.push(function() {
OneSignal.setEmail($("input[name=email]").val())
.then(function(emailId) {
// Callback called when email have finished sending
console.log("emailId: ", emailId);
});
});
}
});
</script>
Integrations
Marketing Hub
Professional
,
Enterprise
Sales Hub
Professional
,
Enterprise
Service Hub
Professional
,
Enterprise
Operations Hub
Professional
,
Enterprise
