HubSpot

Integrar o OneSignal com o HubSpot permite automatizar a entrega de notificações push, emails, SMS e gerenciar tags de dados para mensagens no aplicativo através dos Workflows do HubSpot. Esta integração também permite visualizar atividades do OneSignal nas linhas do tempo de contatos e segmentar usuários com base em suas interações com o OneSignal. Para funcionalidades avançadas como testes A/B, entrega inteligente, limitação e retargeting, você pode utilizar o OneSignal independentemente.

---

​

Requisitos

• Você deve ser um Super Admin do HubSpot ou ter Permissões do App Market em sua conta HubSpot.
• Conta OneSignal atualizada (não disponível em aplicativos gratuitos).

Apenas clientes legados: Migrando para a nova integração HubSpot

​

Instalando a nova integração HubSpot

Conforme descrito no guia geral, os usuários agora precisarão ativar a integração HubSpot em seu painel OneSignal, na seção Integrations das Configurações do Aplicativo

​

Migrando seus workflows

Embora não seja obrigatório, recomendamos criar um novo workflow para testar a nova integração antes de substituir as Ações em seus Workflows existentes. Alguns usuários também mantêm ambientes HubSpot separados de staging e produção para fins de teste.

​

Clone seu workflow

Na página Workflows no HubSpot, você pode clicar no botão Clone ao lado do seu workflow existente para criar uma nova cópia dele.

​

Remova gatilhos do novo workflow

Após cloná-lo, você deve primeiro remover quaisquer gatilhos no Workflow recém-criado. Isso garantirá que você possa publicar o novo workflow sem acioná-lo inadvertidamente automaticamente.

​

Atualize ações legadas do OneSignal com as novas versões

Você pode então percorrer seu workflow, removendo todas as ações legadas do OneSignal e substituindo-as pela nova. Como você provavelmente terá tanto o aplicativo legado do OneSignal instalado quanto usando a nova integração construída pelo OneSignal, será importante ter cuidado para garantir que você esteja criando ações do novo aplicativo. O aplicativo legado terá o texto “Built by HubSpot”.

O menu de ações quando ambos os aplicativos OneSignal legado e novo estão instalados. Use aquele que não diz 'Built by HubSpot'

​

Teste o workflow

Depois de substituir as ações do workflow e salvar e publicar seu workflow, você poderá inscrever contatos manualmente para testar o workflow. Recomendamos que você faça isso com apenas um único contato de teste primeiro, para garantir que o workflow funcione corretamente.

Exemplo de migração de workflow HubSpot da integração legada.

Após inscrever o contato, você poderá visualizar o histórico de inscrição do workflow para ver se as ações foram bem-sucedidas. Se você tiver algum erro inesperado, entre em contato com o suporte do OneSignal.Após testar o workflow com sucesso, você pode substituir o Workflow original pela cópia ou fazer as mesmas alterações no workflow original.

---

​

Configuração

​

Ativar HubSpot no OneSignal

No OneSignal, vá para a página Data > Integrations do seu aplicativo e em HubSpot selecione Activate. Clique em Authenticate, depois faça login em sua conta HubSpot. Você pode ser solicitado a escolher qual conta HubSpot deseja usar. Depois de concordar com os termos e selecionar Connect app, você será redirecionado para seu aplicativo OneSignal e precisará abrir a conta HubSpot recém-conectada.

​

Definir o External ID do OneSignal

Para corresponder usuários no HubSpot com usuários no OneSignal, você precisará definir o identificador External ID no OneSignal para ter o mesmo valor de alguma propriedade de usuário única que você coleta no HubSpot. Você usará isso para corresponder dentro de seus workflows HubSpot descritos abaixo. O External ID pode ser definido de várias maneiras, mas é altamente recomendado usar uma propriedade prontamente disponível em seu aplicativo móvel ou site para que você possa defini-lo nas Subscriptions push do seu usuário com nosso método SDK login.

---

​

Definir um workflow HubSpot

No HubSpot, navegue até Automation > Workflows e clique em Create workflow. Selecione Contact-based e configure sua inscrição. Para adicionar a ação OneSignal, clique no + e pesquise por OneSignal. Nossas ações de workflow permitem criar Usuários no OneSignal e Tags (que são propriedades personalizadas de usuário ou eventos) e enviar mensagens. Para usar qualquer ação, você deve primeiro definir algumas propriedades:

​

Campo OneSignal App

Este é o aplicativo OneSignal que você conectou à conta HubSpot durante as instruções de configuração inicial acima.

​

Campo External ID

Esta é a propriedade que você define em seus usuários em seu aplicativo OneSignal que corresponde a uma propriedade definida no HubSpot.

---

​

Criar usuários OneSignal a partir do HubSpot

Você pode criar Users no OneSignal conforme eles são criados ou passam por um workflow no HubSpot. Você pode usar o nó de criar usuário para garantir que o OneSignal e o HubSpot estejam sincronizados. Se as seguintes propriedades do HubSpot forem definidas, ele criará Subscriptions correspondentes para esse usuário:

• A propriedade Email do HubSpot criará uma assinatura de email no OneSignal para esse usuário.
• A propriedade Phone number do HubSpot criará uma assinatura de SMS no OneSignal para esse usuário.

Os registros de SMS enviarão uma mensagem de opt-in se seu aplicativo OneSignal tiver Double Opt-in habilitado. Você pode desabilitar o envio automático da mensagem de opt-in dentro do nó Create User no HubSpot. Isso significa que um registro de SMS será criado no OneSignal, mas não inscrito em mensagens SMS, e nenhuma mensagem de opt-in será enviada para esse usuário. Você pode definir o External ID e tags dentro do nó Create User, de forma muito semelhante ao nó Edit Tags.

---

​

Editar tags OneSignal a partir do HubSpot

O OneSignal usa Tags para adicionar propriedades personalizadas aos usuários. As tags podem ser usadas para adicionar Propriedades de Contato do HubSpot ao OneSignal para Message Personalization e/ou Segmentation, que podem ser usadas para muitas coisas, incluindo enviar Mensagens no Aplicativo.

​

Campo Tags

Digite uma string JSON com o formato { "key1" : "value1", "key2" : "value2" } e pressione Save. Você pode injetar propriedades do HubSpot como tags para que sejam armazenadas no OneSignal. Um exemplo disso é adicionar o nome do usuário como uma tag para que você possa se dirigir ao usuário pelo nome em suas mensagens. Você pode excluir tags definindo o "value" como uma string vazia assim: { "key" : "" }. Isso é útil se você tiver dados de tag no OneSignal que deseja excluir. Se a tag não existir, ela será omitida.

---

​

Enviar notificação OneSignal

Você pode enviar uma notificação push preenchendo o formulário fornecido ou selecionar Templates predefinidos para ter a capacidade de enviar Email ou SMS. É recomendado Match by OneSignal external_id pois a correspondência por Email é para clientes legados ou se você definir email usando nosso método SDK addEmail. Você terá então a opção de enviar uma mensagem usando um template ou definindo uma notificação push diretamente dentro do workflow.

​

Opção de templates

Você pode criar Templates no painel OneSignal ou em nossa API. Ao usar templates, você pode enviar SMS, Email ou notificações push.

​

Opção de campos de formulário

Se você não usar um template, você só pode enviar notificações push usando texto em vários campos (Title, Subtitle, Message, Image URL, Launch URL). Email e SMS só podem ser usados via templates. O benefício desta opção é que você também pode usar dados de contato do HubSpot (por exemplo, First Name, favorite color) para personalizar os campos de notificação. O OneSignal formatará corretamente a mensagem para diferentes dispositivos e canais de mensagens. Clique em Save quando terminar.

---

​

FAQ

​

Quais dados são compartilhados entre HubSpot e OneSignal?

​

Como posso enviar mensagens no aplicativo com HubSpot?

No Audience do Painel OneSignal, selecione New Segment. Dê um nome baseado nas tags selecionadas e selecione o filtro User Tag. Digite o "key" e o "value" definidos no HubSpot e clique em Create Segment. Navegue até Messages > In-App e selecione New In-App. Nomeie seu novo IAM para que você possa identificá-lo no painel. Em “1. Audience” selecione Show to Particular Segment(s) e selecione seu segmento recém-criado. À medida que os usuários passam pelo workflow do HubSpot, eles receberão tags que os colocarão imediatamente neste segmento. Nota: receber uma tag não aciona o IAM. Mais detalhes abaixo em Opções de Gatilho. Para “2. Message” siga o Guia de Envio de Mensagens no Aplicativo para detalhes sobre como criar sua Mensagem no Aplicativo.

​

Opções de gatilho

As Mensagens no Aplicativo precisam ser acionadas para serem exibidas no dispositivo. Os gatilhos podem ser baseados em tempo ou programáticos. Nota: uma tag não é um gatilho. Se a tag for adicionada enquanto o dispositivo estiver usando o aplicativo atualmente, o IAM não será exibido. A Mensagem no Aplicativo será exibida na próxima vez que o usuário retornar ao seu aplicativo em uma nova sessão. Novas sessões são contadas quando o aplicativo fica fora de foco por 30 segundos. Em “3. Triggers” você pode configurar o IAM para exibir com base nos seguintes gatilhos:

• On App Open
• Session Duration > ou < um número definido de segundos
• Duration since another IAM was shown
• Programaticamente com o SDK OneSignal

Os gatilhos podem ser combinados com operadores “AND” e separados em múltiplas opções com operadores “OR”. Veja o guia Como acionar um IAM para mais detalhes.

---