BlueConic

Visão geral

Webhooks BlueConic permitem que você sincronize dados de perfil ou segmento para o OneSignal em tempo real sempre que eventos específicos ocorrem no seu site. Este guia demonstra como configurar o BlueConic para enviar dados ao OneSignal via API Update user.

Configuração

Para sincronizar dados de usuário entre BlueConic e OneSignal, um identificador comum deve existir para associar usuários em ambas as plataformas. O BlueConic gera um identificador único chamado BlueConic ID, que pode ser vinculado a um usuário no OneSignal para sincronizar dados.

Script de atualização

Recomendamos criar um alias personalizado para identificar seus usuários usando seus IDs BlueConic. Antes de atribuir um novo alias, certifique-se de que o usuário está logado no OneSignal primeiro. O código a seguir fornece exemplos de associação de um BlueConic ID com um usuário OneSignal usando um Alias e um ID Externo.

// Get the BlueConic ID
const blueConicId = blueConicClient.profile.getProfile().getId();

// Ensure the user is logged in
// Logged in users will have an External ID
if (!OneSignal.User.externalId) {
await OneSignal.login("EXTERNAL_ID_FROM_YOUR_BACKENED");
}

// External ID must exist before calling this method
OneSignal.User.addAlias('blueconic_profile_id', blueConicId);

Se seu sistema usa IDs BlueConic como o identificador principal, passe-o para OneSignal.login.

// Get the BlueConic ID
const blueConicId = blueConicClient.profile.getProfile().getId();

// Set OneSignal External ID to BlueConic ID
OneSignal.login(blueConicId);

Adicionar webhooks

Use webhooks para sincronizar dados do BlueConic para o OneSignal com base em suas necessidades específicas. Os exemplos abaixo demonstram como usar a API Update user para conseguir isso. Detalhes da API


URL	`https://api.onesignal.com/apps/<APP_ID>/users/by/alias_label/alias_value`
Method	PATCH
Authorization	Basic <API_KEY>

Se seu sistema usa o BlueConic ID como o identificador principal… Use a seguinte URL em vez disso: https://api.onesignal.com/apps/<APP_ID>/users/by/external_id/{{blueconic_profile_id}}

Sincronizando propriedades de perfil

Sincronize dados de perfil BlueConic para o OneSignal definindo Tags e outros dados de usuário.

Exemplo de configuração para atualizar tags

Payload

{
  "properties": {
    "tags": {
      "tag_name_at_onesignal": "{{BLUECONIC_PROPERTY}}"
    }
  }
}

Sincronizando segmentos

Sincronize dados de segmento BlueConic para o OneSignal definindo Tags. Use essas tags para criar segmentos diretamente dentro do OneSignal.

Exemplo de configuração para manter segmentos sincronizados

Payload

{
  "properties": {
    "tags": {
      "early_bird": "Yes",
    }
  }
}

Você pode nomear tags com base em necessidades específicas, como early_bird ou qualquer outro rótulo descritivo. No entanto, o valor atribuído à tag deve sempre ser codificado, como Yes, para consistência entre segmentos no BlueConic e OneSignal.

Primeiros passos & configurações

Canais de mensagem

Jornadas

Público & eventos personalizados

Análises & Integrações

Privacidade & Segurança

Visão geral

Configuração

Script de atualização

Adicionar webhooks

Sincronizando propriedades de perfil

Sincronizando segmentos

​Visão geral

​Configuração

​Script de atualização

​Adicionar webhooks

​Sincronizando propriedades de perfil

​Sincronizando segmentos

Visão geral

Configuração

Script de atualização

Adicionar webhooks

Sincronizando propriedades de perfil

Sincronizando segmentos