Pular para o conteúdo principal
Conectar o OneSignal aos seus sistemas internos como um data warehouse, CRM ou plataforma de gerenciamento de dados (DMP) desbloqueia capacidades poderosas para mensagens em tempo real, personalizadas e escaláveis. Seja você usando Salesforce, um sistema de usuário personalizado ou outra plataforma, a integração permite:
  • Enviar mensagens personalizadas e sensíveis ao tempo usando dados ao vivo
  • Sincronizar atributos de usuário e dados de mensagens entre sistemas
  • Usar seu sistema interno como a fonte da verdade enquanto aproveita a infraestrutura de mensagens do OneSignal
Este guia percorre casos de uso comuns, métodos de integração e melhores práticas de configuração.

Integração de banco de dados

​
Benefícios da integração de banco de dados

Mensagens personalizadas em escala Use dados de seus sistemas internos para personalizar mensagens em tempo real:
  • Adicione Tags para armazenar atributos de usuário no OneSignal para segmentação ou personalização de conteúdo.
  • Passe custom_data na API Create message para personalizar sem armazenar dados permanentemente.
Acionar mensagens sensíveis ao tempo Envie mensagens instantaneamente quando eventos chave ocorrem no seu sistema, como:
  • Pedidos realizados
  • Renovações ou expirações de assinatura
  • Marcos conquistados
  • Acionar usando:
Identidade de usuário unificada com External ID e aliases O OneSignal suporta external_id como um ID de usuário multiplataforma estável e até 10 aliases personalizados por usuário (por exemplo, crm_id, facebook_id).

​
Fluxo de dados

​
Estrutura de identidade do usuário

Use external_id como seu identificador primário de usuário entre sistemas. Você pode anexar outros aliases ou identificadores para flexibilidade. Se nenhum ID de usuário global existir, IDs de OneSignal/Assinatura podem ser usados, mas requerem tratamento extra, pois são anônimos até serem vinculados. Veja Users e Subscriptions para mais informações.

​
Enviar dados de usuário para o OneSignal

Use nossa REST API para criar e atualizar usuários em tempo real. Também suportamos importação CSV para integração em massa ou atualizações.

​
Exportar dados do OneSignal

Para recuperar dados do OneSignal:

​
Enviar eventos personalizados para o OneSignal

Envie Custom Events para acionar Journeys sincronizando dados do seu warehouse diretamente para o OneSignal.
Recurso beta. Email integrations@onesignal.com para acesso.
Integrações suportadas O OneSignal se integra com muitas fontes para sincronizar eventos personalizados. Veja Custom Events para uma lista de integrações suportadas. Primeiros passos
  1. Navegue até Data > Integrations no seu dashboard OneSignal.
  2. Procure o banner Beta: Sync data from your favorite data warehouse.
  3. Clique em Sync Data para acessar a configuração para ingestão de dados.

Sincronizar dados do seu data warehouse

​
1. Conectar sua fonte de dados

Se você não vê um data warehouse listado, ou se tiver dúvidas sobre como configurar uma integração - por favor nos informe enviando um email para integrations@onesignal.com. Atualmente estamos aceitando solicitações para expandir nossas ofertas de integração.

​
2. Criar sua sincronização

  • Clique em Add Sync
  • Selecione Any Warehouse Table
  • Escolha sua fonte de dados conectada
  • Selecione seu esquema e tabela
    • Para Google Sheets: Use o dropdown de tabela para selecionar planilhas específicas dentro do seu documento.

​
3. Configurar seu destino

  • Selecione OneSignal como conexão
  • Escolha Custom Event como tipo de objeto
  • Mantenha Create Only como comportamento de sincronização
  • Mapeie sua coluna de identificador para OneSignal External IDs

​
4. Escolher seus campos de dados

  • Selecione quais colunas sincronizar para o OneSignal:
    • Tipos suportados: Texto, números, booleanos, datas, horas
    • Uso: Esses campos ficam disponíveis para segmentação de jornada
    • Recomendação: Sincronize apenas os campos que você usará para segmentação

​
5. Testar e implantar

  • Teste sua sincronização para verificar se os dados fluem corretamente
  • Adicione um rótulo descritivo (não pode ser alterado depois)
  • Defina seu gatilho: Manual, agendado ou sequencial. Recomendamos selecionar sequencial para ingerir eventos personalizados.
O que acontece a seguir?Seus eventos personalizados aparecerão no índice de eventos do OneSignal, prontos para usar em jornadas com base no comportamento do usuário e dados do seu warehouse. Cada opção de sincronização tem detalhes específicos necessários para conectar à sua conta - entre em contato conosco em integrations@onesignal.com com quaisquer perguntas sobre configurações individuais.

​
Onde os dados devem ficar: OneSignal ou seu banco de dados?

Decida com base na finalidade dos dados:

​
O que armazenar no OneSignal

Armazene dados usados diretamente para mensagens:
  • external_id e aliases
  • Emails (para mensagens de email)
  • Números de telefone (para SMS)
  • Atributos leves de usuário como Tags
Para personalização mais rica, evite armazenar perfis completos—injete campos dinâmicos no momento do envio usando custom_data.

​
O que manter em seus próprios sistemas

Mantenha dados não relacionados a mensagens (por exemplo, perfis completos de usuário, logs de transações) em seus próprios sistemas para performance, privacidade e controle. Arquive o histórico de mensagens do OneSignal para analytics de longo prazo ou conformidade.

​
Acionando mensagens do seu banco de dados

Você pode acionar mensagens usando duas abordagens—escolha uma ou ambas com base no seu caso de uso.
  • API
  • Tags e Journeys
  • Custom Events e Journeys
Use a API Create message para mensagens imediatas e transacionais.Segmente usuários via:
  • external_id
  • Aliases (por exemplo, crm_id)
  • Email ou número de telefone
Melhor para:
  • Mensagens transacionais (por exemplo, recibos, alertas)
  • Notificações sensíveis ao tempo ou personalizadas
  • Segmentação de indivíduos ou grupos (até 20.000 usuários por chamada)
Você também pode agendar mensagens usando o parâmetro send_after.