> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de início rápido

> Configure sua conta OneSignal, configure os canais de mensagens, gerencie Usuários e envie sua primeira mensagem.

Este guia apresenta quatro etapas para você começar a usar o OneSignal. Conclua-as em ordem ou acesse diretamente a seção de que precisa. Se ainda não o fez, [crie sua conta](https://onesignal.com) para começar.

1. [**Configure sua conta e canais de mensagens**](#set-up-your-account-and-messaging-channels) — crie seu app e configure pelo menos um canal
2. [**Adicione e organize seus Usuários**](#add-and-organize-your-users) — entenda Usuários, Assinaturas, tags e segmentos
3. [**Envie mensagens**](#send-messages) — crie campanhas, personalize conteúdo e construa Jornadas automatizadas
4. [**Meça o impacto com analytics**](#measure-impact-with-analytics) — acompanhe entrega, engajamento e conversões

Assista a um tour da plataforma ou pule para as etapas abaixo.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/bH60T1PZg1c?si=0qtigm-eVcpl1bcl" title="Vídeo de início rápido do OneSignal" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

***

## Configure sua conta e canais de mensagens

Seu App OneSignal é onde os dados de usuários e mensagens são armazenados. Você pode ter vários Apps em uma única Organização para diferentes projetos, ambientes ou necessidades de cobrança.

### Conta OneSignal

<Columns cols={2}>
  <Card title="Apps, Organizações e contas" icon="building" href="./apps-organizations">
    Seu App OneSignal, estrutura de Organização e configurações de conta.
  </Card>

  <Card title="Adicionar Membros da Equipe" icon="user-plus" href="./manage-team-members">
    Convide colaboradores e atribua funções dentro da sua Organização.
  </Card>

  <Card title="Chaves e IDs" icon="key" href="./keys-and-ids">
    Encontre seu App ID, Organization ID e chaves de API do OneSignal.
  </Card>

  <Card title="Uso e Cobrança" icon="credit-card" href="./billing-faq">
    Cobrança, faturas e detalhes de uso.
  </Card>
</Columns>

### Canais de mensagens

O OneSignal suporta notificações push, mensagens in-app, email, SMS/MMS/RCS e Live Activities. Escolha seu primeiro canal e siga o guia de configuração — você pode adicionar mais canais ao mesmo app a qualquer momento.

<Tip>
  Email e SMS podem ser configurados sem escrever código. Notificações push e mensagens in-app requerem integração do SDK — [convide um desenvolvedor](./manage-team-members) para sua equipe se necessário.
</Tip>

<Frame caption="Selecione um canal de mensagens no seu painel OneSignal para iniciar a configuração.">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/set-up-messaging-channels.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=bf38c40f30d3cc8e6c8ddc12224642ee" alt="Painel OneSignal mostrando opções de configuração de canais de mensagens, incluindo push, email, SMS e in-app" width="1690" height="868" data-path="images/dashboard/set-up-messaging-channels.png" />
</Frame>

<Columns cols={3}>
  <Card title="Email" icon="envelope" href="./email-setup">
    Configuração de email transacional e de marketing.
  </Card>

  <Card title="Push móvel" icon="mobile" href="./mobile-sdk-setup">
    Configuração de push para iOS, Android, Huawei e Amazon.
  </Card>

  <Card title="Push web" icon="globe" href="./web-sdk-setup">
    Configuração de notificações push baseadas em navegador.
  </Card>

  <Card title="Mensagens in-app" icon="window-maximize" href="./in-app-messages-setup">
    Mensagens ricas e interativas exibidas dentro do seu app.
  </Card>

  <Card title="SMS" icon="comment-sms" href="./sms-messaging">
    Mensagens de texto para alertas urgentes.
  </Card>

  <Card title="RCS" icon="message" href="./rcs-messaging">
    Mensagens ricas com conteúdo de marca e confirmações de leitura no Android.
  </Card>

  <Card title="Live Activities" icon="tower-broadcast" href="./live-activities">
    Atualizações dinâmicas da tela de bloqueio do iOS. Recursos semelhantes disponíveis para Android.
  </Card>
</Columns>

<Note>
  Após configurar o push, configure [prompts de permissão push móvel](./prompt-for-push-permissions) ou [prompts de permissão web](./permission-requests) para começar a coletar opt-ins dos seus Usuários.
</Note>

***

## Adicione e organize seus Usuários

À medida que os usuários interagem com seu app, o OneSignal atribui a cada um um **OneSignal ID** (ID de usuário) e **IDs de Assinatura** para cada dispositivo, endereço de email ou número de telefone. Um único Usuário pode ter várias Assinaturas em diferentes canais. Os Usuários permanecem anônimos até você identificá-los com um [External ID](./users#external-id).

<Frame caption="Painel OneSignal: Audience > Users">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/users-page.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=8992ef97cf3c9f336078f9dbf8a6374e" alt="Página de Usuários do painel OneSignal mostrando uma lista de usuários com detalhes de assinatura" width="2316" height="858" data-path="images/dashboard/users-page.png" />
</Frame>

<Columns cols={2}>
  <Card title="Usuários" icon="users" href="./users">
    Identificados por External ID; podem ter várias Assinaturas em diferentes canais.
  </Card>

  <Card title="Assinaturas" icon="address-book" href="./subscriptions">
    Endereços de email, números de telefone e dispositivos que recebem suas mensagens.
  </Card>
</Columns>

### Propriedades do usuário

Armazene dados do usuário como **tags** (pares chave-valor) e **eventos personalizados** (ações do usuário). Tags potencializam a personalização e segmentação de mensagens.

Exemplos comuns de tags:

* **Atributos**: `first_name`, `city`, `subscription_tier`
* **Comportamentos**: `cart_abandoned`, `last_login_date`, `onboarding_complete`
* **Preferências**: `notification_frequency`, `theme_preference`

<Columns cols={2}>
  <Card title="Tags" icon="tags" href="./add-user-data-tags">
    Use tags para personalização de mensagens e segmentação avançada.
  </Card>

  <Card title="Eventos personalizados" icon="bolt" href="./custom-events">
    Acione Jornadas ou ações de espera baseadas no comportamento do Usuário.
  </Card>
</Columns>

### Segmentos e integrações

Segmentos são grupos dinâmicos de Usuários definidos por tags, dados de comportamento ou interações com mensagens. Eles se atualizam automaticamente conforme os dados do usuário mudam — por exemplo, "Última sessão há mais de uma semana" ou "Item adicionado ao carrinho". Conecte plataformas externas para enriquecer seus segmentos.

<Frame caption="Criação de um segmento com filtro de Tag de Usuário.">
  <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/e1801ce-4667771-Segment_Picker_3_1.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=e27107ac0e1975e8cb63b3cbb02822ee" alt="Construtor de segmentos do OneSignal mostrando a configuração de filtro de Tag de Usuário" width="883" height="471" data-path="images/docs/e1801ce-4667771-Segment_Picker_3_1.png" />
</Frame>

<Columns cols={2}>
  <Card title="Segmentos" icon="chart-pie" href="./segmentation">
    Crie grupos de audiência dinâmicos usando tags e dados de comportamento.
  </Card>

  <Card title="Integrações" icon="plug" href="./integrations">
    Importe dados de usuários de plataformas externas para potencializar segmentos e Jornadas.
  </Card>
</Columns>

***

## Envie mensagens

Crie e envie campanhas de mensagem única ou Jornadas automatizadas de várias etapas pelo painel do OneSignal. Cada canal tem seu próprio compositor com opções de prévia, segmentação e agendamento.

<Tip>
  Antes de enviar para toda sua audiência, [configure Assinaturas de teste](./test-users) para verificar se suas mensagens são renderizadas e entregues corretamente.
</Tip>

<Frame caption="Compositor de notificações push no painel do OneSignal.">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/docs/007d277-f8b3231-message_1.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=d8d2e386bfa2ff742bfc6d3e6583f4d2" alt="Editor de notificações push do OneSignal mostrando campos de conteúdo da mensagem e prévia" width="790" height="627" data-path="images/docs/007d277-f8b3231-message_1.png" />
</Frame>

<Columns cols={2}>
  <Card title="Notificações push" icon="bell" href="./push">
    Envie para dispositivos web, iOS, Android, Huawei e Amazon.
  </Card>

  <Card title="Email" icon="envelope" href="./email-messaging">
    Crie e envie emails transacionais ou de marketing.
  </Card>

  <Card title="Mensagens in-app" icon="window-maximize" href="./in-app-messages-setup">
    Acione mensagens ricas e interativas com base no comportamento do Usuário dentro do seu app.
  </Card>

  <Card title="SMS" icon="comment-sms" href="./sms-messaging">
    Envie mensagens de texto para alertas e atualizações urgentes.
  </Card>

  <Card title="RCS" icon="message" href="./rcs-messaging">
    Envie mensagens de marca ricas com confirmações de leitura no Android.
  </Card>

  <Card title="Live Activities" icon="tower-broadcast" href="./live-activities">
    Entregue atualizações dinâmicas na tela de bloqueio do iOS.
  </Card>
</Columns>

### Personalize suas mensagens

Use tags, eventos personalizados e dados dinâmicos para adaptar o conteúdo das mensagens para cada destinatário. Crie modelos reutilizáveis para manter a consistência entre campanhas.

<Columns cols={2}>
  <Card title="Personalização de mensagens" icon="wand-magic-sparkles" href="./message-personalization">
    Personalize o conteúdo com sintaxe Liquid, tags, Data Feeds e dados personalizados.
  </Card>

  <Card title="Templates" icon="clone" href="./templates">
    Crie modelos de mensagens reutilizáveis para push, email e SMS.
  </Card>
</Columns>

### Jornadas

Jornadas são campanhas automatizadas de várias etapas que respondem ao comportamento do usuário — como sequências de integração, lembretes de carrinho abandonado e fluxos de reengajamento.

<Frame caption="Exemplo de Jornada de Carrinho Abandonado no painel do OneSignal.">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/be3ec1a-e61fae7-settings_Journeys_1.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=6f266cd498ccc2884a0fde9d35d2fd49" alt="Construtor de Jornada do OneSignal mostrando um fluxo de automação de carrinho abandonado" width="1105" height="745" data-path="images/docs/be3ec1a-e61fae7-settings_Journeys_1.png" />
</Frame>

<Columns cols={2}>
  <Card title="Jornadas" icon="route" href="./journeys-overview">
    Construa campanhas automatizadas de várias etapas acionadas pelo comportamento do usuário.
  </Card>

  <Card title="Exemplos de Jornadas" icon="book-open" href="./journeys-examples">
    Padrões comuns como integração, carrinhos abandonados e reengajamento.
  </Card>
</Columns>

### Enviar via API

Envie mensagens programaticamente para casos de uso transacionais como confirmações de pedidos, OTPs e alertas de cobrança.

<Columns cols={2}>
  <Card title="Guias para desenvolvedores" icon="code" href="./developers">
    Documentação de SDK e API REST para equipes de engenharia.
  </Card>

  <Card title="Mensagens transacionais" icon="paper-plane" href="./transactional-messages">
    Envie mensagens urgentes como OTPs, recibos e atualizações de envio via API.
  </Card>
</Columns>

***

## Meça o impacto com analytics

Acompanhe o desempenho das mensagens — incluindo entrega, aberturas, cliques e conversões — para entender o que impulsiona o engajamento e aprimorar sua estratégia.

<Columns cols={2}>
  <Card title="Visão Geral de Analytics" icon="chart-line" href="./analytics-overview">
    Revise todas as opções de análise disponíveis no OneSignal.
  </Card>

  <Card title="Event Streams" icon="signal-stream" href="./event-streams">
    Transmita eventos de mensagens como cliques, aberturas e recebimentos para seu data warehouse em tempo real.
  </Card>

  <Card title="Exportar dados" icon="file-export" href="./exporting-data">
    Exporte dados de usuários e mensagens em formato CSV ou API.
  </Card>

  <Card title="Integrações" icon="plug" href="./integrations">
    Conecte plataformas de analytics como Amplitude, Mixpanel, Segment e mais ao OneSignal.
  </Card>

  <Card title="Métricas de conversão" icon="arrow-trend-up" href="./conversion-metrics">
    Meça o impacto nos negócios como receita e cadastros com atribuição de último toque entre canais.
  </Card>

  <Card title="Metas" icon="bullseye" href="./goals">
    Defina uma métrica alvo em uma mensagem ou Jornada e acompanhe o progresso no relatório de entrega.
  </Card>
</Columns>

***

## Perguntas frequentes

### Preciso de um desenvolvedor para começar?

Não necessariamente. Os canais de email e SMS podem ser configurados sem código. As notificações push e mensagens in-app requerem integração do SDK, que pode precisar de um desenvolvedor ou assistente de IA. Você pode [convidar membros da equipe](./manage-team-members) com diferentes funções a qualquer momento.

### Posso adicionar mais canais de mensagens depois?

Sim. Adicione qualquer combinação de canais ao mesmo App OneSignal. Cada canal tem seu próprio guia de configuração — retorne à seção de [canais de mensagens](#messaging-channels) para adicionar um novo.

### Qual é a diferença entre um Usuário e uma Assinatura?

Um **Usuário** representa uma pessoa, identificada por um [External ID](./users#external-id). Uma **Assinatura** é um endpoint de canal específico — como um dispositivo, endereço de email ou número de telefone. Um Usuário pode ter várias Assinaturas em diferentes canais e dispositivos.

### Quanto tempo leva a configuração inicial?

A configuração de email geralmente leva menos de 30 minutos se você tiver acesso às configurações de DNS do seu domínio. O SMS requer registro na operadora, o que pode levar alguns dias. A configuração de notificações push depende da plataforma do seu app e do processo de build — planeje algumas horas de tempo de desenvolvedor.

***

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please include:

  * Details of the issue you're experiencing and steps to reproduce if available
  * Your OneSignal App ID
  * The External ID or Subscription ID if applicable
  * The URL to the message you tested in the OneSignal Dashboard if applicable
  * Any relevant [logs or error messages](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>