1. ActiveCampaign Centro de Ajuda
  2. Integrações
  3. Integrações de Mensagens

Ligue a OneSignal à ActiveCampaign

Avatar
Sarah N
Última atualização
Planos da ActiveCampaign
Starter
Plus
Pro
Enterprise

Use a integração OneSignal com a ActiveCampaign para enviar notificações push para a Web, dispositivos móveis e apps e receber eventos do OneSignal na ActiveCampaign sempre que um evento ocorrer. Isso permite que você envie comunicação direta e imediata para clientes atuais e em potencial, impulsione taxas de engajamento, reengaje usuários inativos, personalize experiências do cliente e é uma adição econômica à sua estratégia de marketing. 

Este artigo explica como conectar o OneSignal ao ActiveCampaign para enviar notificações push e sincronizar eventos OneSignal com a ActiveCampaign.

Observação

  • O seguinte é necessário para configurar a integração:
    • Conta ActiveCampaign com permissões de automação
    • Configuração da conta OneSignal e configurada para enviar notificações push
    • Configuração e configuração do app web no OneSignal
    • Push modelos de notificação (se usar) no OneSignal. As plataformas suportadas incluem:
      • Apple iOS (APNs)
      • Google Android (FCM)
      • Teia
    • Chave de auth do Usuário OneSignal
    • Chave de API OneSignal Rest para cada app web
    • OneSignal External ID campo para cada registro de assinatura preenchido com o identificador exclusivo para ActiveCampaign (endereço de email)
      • Endereços de email capturados através de um formulário ActiveCampaign preencherão automaticamente o campo OneSignal External ID
      • Observação: Entre em contato com seu desenvolvedor de apps web ou móvel para configurar um caminho para empurrar o endereço de email de um contato da ActiveCampaign para o OneSignal External ID
      • Nota: O OneSignal não empurra o endereço de email capturado do prompt de email ou telefone dentro da configuração de solicitação de permissão
  • Para notificações de web push - O OneSignal parou de suportar novos apps usando Blogger, Bubble, Squarespace, Webflow, Weebly, Wix, sites HTTP e construtores de sites que não oferecem suporte ao upload de Trabalhadores de Serviço para um servidor (que são necessários para push da Web). Saiba mais aqui.
    • Clientes do Wix Studio - Revise este artigo sobre o upload do arquivo de trabalhadores do OneSignal para o seu diretório raiz

Assista o vídeo

Como funciona a integração da Square

Essa integração oferece duas opções diferentes de sincronização. Um sincroniza dados com sua conta ActiveCampaign e o outro envia notificações push por automação. Você pode optar por usar uma ou ambas as opções com essa integração. No entanto, elas funcionam separadamente.

Sincronização de fluxos de eventos onesignal com a ActiveCampaign

Uma vez configurados, os Fluxos de Eventos serão sincronizados com o ActiveCampaign sempre que ocorrer um evento. Isso é enviado através de um webhook. 

Notificações push da web

Para enviar notificações push, você pode configurar a integração por meio de uma das duas ações de automação: Você pode usar uma das ações de automação, ou ambas, para enviar notificações push:

  • "OneSignal - Atribua uma tag" ação - esta ação permite que você envie notificações push no app móvel
  • " OneSignal - Enviar notificação push" ação - esta ação permite que você envie notificações web e web push móvel

Relatórios

Você pode encontrar relatórios para essa integração em sua conta OneSignal. Você também pode usar o ActiveCampaign para criar uma pesquisa avançada de todos os contatos que inseriram e concluíram sua automação OneSignal.

Sincronizar fluxos de eventos OneSignal com a ActiveCampaign

Essa sincronização envia eventos do OneSignal para a ActiveCampaign sempre que ocorrer um evento. 

O que pode acontecer

A configuração da integração ocorre em sua conta ActiveCampaign e acontas da OneSignal. Forneceremos código JSON para implementar em sua conta OneSignal. Uma vez concluída, essa integração criará novos e atualizará registros de contato existentes no ActiveCampaign e sincronizará os dados de eventos apropriados.

  Observe que nossa equipe de Experiência do Cliente não pode ajudá-lo a solucionar problemas ou implementar código em seu nome. 

Eventos suportados

Os seguintes eventos são suportados:

  • Impressão no app
  • Clicado no app
  • Página no app exibida
  • Empurrar enviado
  • Empurrar recebido
  • Empurrar clicado
  • Falha no push
  • inscrição cancelada

Dados oneSignal sobre registros de contato

Um registro de objeto personalizado é criado para cada contato. Este objeto personalizado contém os seguintes dados:

  • Externo
  • Timestamp
  • ID do evento
  • Tipo de evento
  • ID da Mensagem
  • Nome da mensagem
  • Título da mensagem
  • Conteúdo da mensagem
  • Tipo de dispositivo de assinatura

Instruções passo a passo

Clique em ActiveCampaign > Configuração do Connection ID

  1. Na sua conta da ActiveCampaign, clique em "apps" no menu à esquerda.

Visualização expandida:
Apps no menu esquerdo expanded.jpeg

Visualização colapsada:
Apps no menu à esquerda collapsed.jpeg

  1. Use a barra de pesquisa para localizar a integração do OneSignal.
  2. Clique no botão "Adicionar uma conta". 

  3. Uma janela modal será exibida. Insira a chave de auth de usuário da sua conta OneSignal e clique no botão "Conectar".

      Se você já configurou a integração OneSignal por meio de uma ação de automação, você pode selecionar sua conexão existente nesta tela.

  4. Mapeie os campos OneSignal de entrada para os campos desejados no ActiveCampaign e clique em "Concluir".
    • Necessário: Você deve mapear o campo OneSignal "ID externo" para o campo ActiveCampaign "Email de contato" para que a integração funcione corretamente. Se você não fizer isso, a sincronização falhará
  5. Clique na seta ao lado do botão "Editar" para o recurso criado e clique em "Copiar URL do Webhook". Mantenha esse valor em sua área de transferência ou cole-o em algum lugar para referência futura, pois é necessário para a configuração OneSignal.

Configuração oneSignal:

  1. Faça login na sua conta do OneSignal, selecione "Todos os apps" e escolha o app que deseja conectar.
  2. Clique em "Fluxos de Eventos" no menu "Dados".
  3. Clique em "Novo fluxo de eventos".
  4. Nomeie o fluxo de eventos como desejado e clique em "Selecionar eventos". No modal pop-up, selecione todos os eventos nas seções "Mensagem no app" e "Notificação push" e clique em "Concluído".
  5. Cole a URL do Webhook copiada na última etapa da configuração da ActiveCampaign no campo URL.
  6. Na seção Cabeçalhos, adicione uma entrada com uma chave "Tipo de conteúdo" e um valor de "aplicativo/json".

  7. Na seção Corpo, selecione "Corpo personalizado" no menu suspenso. Substitua o conteúdo da seção pelo seguinte JSON:

    {
    "event.kind": "{{ event.kind }}",
     "event.id": "{{ event.id }}",
     "event.timestamp": "{{ event.timestamp }}",
     "event.datetime": "event.timestamp".{{ event.datetime }}",
    "event.app_id": "{{ event.app_id }}",
     "event.subscription_device_type": "{{ event.subscription_device_type }}",
     "event.subscription_id": "{{ event.subscription_id }}",
    "event.onesignal_id": "{{ event.onesignal_id }}",
     "event.external_id": "{{ event.external_id }}",
     "message.id": "{{ message.id }}}",
    "message.name": "{{ message.name }}",
     "message.title": "{{ message.title.en }}",
     "message.contents": "{{ message.contents.en }}",
    "template_id": "{{ message.template_id }}",
     "message.template_id": "{{ message.template_id }}",
     "message.url": "{{ message.url }}",
     "message.app_url": "{{ message.app_url }}",
     "message.web_url": "{{ message.web_url }}"
    }

      O código JSON acima deve ser copiado exatamente como está; caso contrário, a integração não funcionará corretamente.

  8. Clique em "Ativar" para salvar e ativar o Fluxo de Eventos.

Conecte o OneSignal ao ActiveCampaign com a ação de automação "OneSignal - Atribua uma tag".

Você deve criar segmentos no OneSignal para usar essa ação de automação. Uma vez definido o segmento, você pode enviar notificações móveis no app diretamente do OneSignal. A ActiveCampaign não pode enviar diretamente notificações push no app de automações.  

O que pode acontecer

Esta configuração tem três etapas principais:

  1. Crie um segmento no OneSignal usando o filtro "UserTags" para o par de chave/valor que você usará ao configurar a ação de automação.
  2. Configure a notificação push no OneSignal para aplicativos móveis.
  3. Adicione a ação "Adicionar uma tag - OneSignal" à sua automação. Nesta etapa, você inserirá a chave de API do OneSignal e criará um par de chave/valor durante a configuração de configuração. Este par de chave/valor deve corresponder ao segmento que você criou no OneSignal. Quando concluído, defina sua automação como "ativa".

Quando um contato passa por sua automação, a tag key/value pair é empurrada para o OneSignal. Qualquer tag que você enviar para o OneSignal a partir desta ação será criada no OneSignal se ainda não existir para contatos e atualizada se ela existir. 

Para encontrar a tag de par chave/valor, faça login em sua conta OneSignal e navegue até Público > Usuários.

Instruções passo a passo

  1. Crie um segmento no OneSignal:
    • Faça login em sua conta OneSignal
    • Navegue até o segmento de > de público > novo segmento
    • Crie seu novo segmento adicionando o filtro "Tags de usuário" para o par chave/valor criado na etapa 3 acima. Para saber mais, leia o guia da OneSignal sobre segmentação
  2. Crie a mensagem que você deseja enviar para o seu segmento. Para saber mais, leia o guia do OneSignal sobre mensagens no app.
  3. Reúna a chave de API nível do app OneSignal e salve-a em um arquivo para a etapa 5 (abaixo). Esta chave de API está localizada sob o app ActiveCampaign > Keys &IDs.
  4. A partir da ActiveCampaign, crie ou edite uma automação.
  5. Arraste a ação "OneSignal – Enviar uma notificação por push" para sua automação. Ele está na parte "CX Apps" do menu de ação de automação. Insira as seguintes informações nos campos fornecidos:
  6. Termine de criar sua automação e defina-a como "Ativa".

Conecte o OneSignal ao ActiveCampaign com a ação de automação "OneSignal - Atribua uma tag".

Essa ação de automação permite que você envie notificações push para dispositivos web e móveis.

O que pode acontecer

Uma vez que você adicione a ação "OneSignal - Enviar notificação push" à sua automação, um prompt vai levá-lo pelas seguintes etapas de conexão e configuração: Você pode usar um modelo OneSignal para sua notificação push ou criar manualmente sua mensagem na configuração. 

Depois de conectar a integração e definir a automação como "Ativa", os contatos que entrarem em sua automação e chegarem à sua ação OneSignal receberão uma notificação push. Além disso, o fluxo de atividades nos registros de contato mostrará que eles entraram em sua automação.

Você pode encontrar relatórios para essa integração em sua conta OneSignal. Você também pode usar o ActiveCampaign para criar uma pesquisa avançada de todos os contatos que inseriram e concluíram sua automação OneSignal. 

Essa integração não adiciona contatos a uma lista.  Se você quiser adicionar tags aos contatos que receberam uma notificação push, você deve adicionar a ação "Adicionar uma tag" à sua automação, seguindo a ação OneSignal. 

Instruções passo a passo

  1. Certifique-se de ter a seguinte configuração no lado OneSignal: Conta OneSignal configurada para enviar notificações push, App ActiveCampaign e Modelos (recomendado).
  2. Reúna as seguintes informações do OneSignal e salve-as em um arquivo para a etapa 5 (abaixo):
    • Chave de auth do usuário - Esta é a chave de nível de conta e está localizada em Chaves de Conta & API
    • OneSignal App ID - Esta é a chave API em nível de app e está localizada sob o app ActiveCampaign > Keys &IDs para o app ActiveCampaign
  3. A partir da ActiveCampaign, crie ou edite uma automação.
  4. Arraste a ação para a automação. Ele está na parte "CX Apps" do menu de ação de automação.
  5. Preencha as seguintes etapas na ação de automação OneSignal para conectar a integração:
    • Cole a chave Auth do usuário OneSignal no campo fornecido e clique em "Conectar"
    • Selecione o app web que você deseja usar no menu suspenso
    • Cole a chave API do app web
    • Selecione o modelo de notificação push que deseja usar (recomendado). Você pode criar manualmente sua notificação push aqui se não quiser usar um modelo.
      • Para criar manualmente uma notificação push na ação de automação: insira sua URL, título (linha de assunto) e conteúdo
      • Você também pode usar tags de personalização para o seguinte em sua mensagem: Contato, Conta, Negócio, Ecommerce e Objetos Personalizados
      • As tags de personalização da ActiveCampaign não funcionam com os modelos do OneSignal
    • Clique no botão "Concluir".

Capturar endereço de email para OneSignal com Formulários ActiveCampaign

Esta opção é para usuários avançados. Você precisará estar confortável com o uso de HTML A Equipe de Experiência do Cliente da ActiveCampaign não pode ajudá-lo a implementar ou solucionar qualquer código personalizado.

Com o OneSignal Web SDK, você pode adicionar código personalizado aos formulários da ActiveCampaign para capturar o endereço de email do Contato no envio e adicioná-los como inscritos no OneSignal.

Primeiro, instale o OneSignal Web SDK em seu site seguindo o guia de inicialização da documentação do OneSignal.

Depois de verificar que o Web SDK foi instalado, a próxima etapa é adicionar o formulário ActiveCampaign ao seu site.

Em ActiveCampaign: 

  1. Clique em "Site" > "Formulários" no menu à esquerda.
  2. Crie um novo formulário e escolha a opção "Formulário em linha".
  3. Depois de projetar o formulário, clique no botão "Integrar" no canto superior direito.
  4. Encontre o código "incorporação completa", selecione-o e copie-o.

No HTML do seu site (onde o Formulário ActiveCampaign será exibido):

  1. Cole no código de formulário copiado.
  2. Procure por uma função no javascript incluído chamado form_submit. A primeira linha nesta função deve ser e.preventDefault() Isso é importante.
  3. O código OneSignal deve ser inserido após a linha e.preventDefault() nesta função.

  4. Em uma nova linha abaixo da linha e.preventDefault(), adicione o seguinte código:

    var userEmail = document.getElementById("email"). valor;
    OneSignalDeferred.push(função async(OneSignal) {
     aguardar OneSignal.User.addEmail(userEmail);
        aguardar OneSignal.login(userEmail);
     });

Quando o formulário da ActiveCampaign for enviado, o endereço de email do remetente será passado para o campo OneSignal External ID.

Solução de problemas

Revise as configurações do modelo para permitir pushes em vários dispositivos.

Esse artigo foi útil?
Usuários que acharam isso útil: 16 de 16

Tem mais perguntas? Entre em contato

Start free trial