> ## 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.

# Mensagens de Journey

> Configure etapas de notificação push, email, SMS e mensagem in-app em uma Journey, incluindo templates, tempo de entrega e requisitos de sessão.

Cada etapa de mensagem em uma Journey envia uma mensagem ao usuário quando ele chega àquele ponto no fluxo. Você pode adicionar etapas de **notificação push**, **email**, **SMS** e **mensagem in-app** — cada uma com seu próprio template e comportamento de entrega.

Para adicionar uma etapa de mensagem, clique no botão **(+)** no canvas da Journey e selecione o canal.

<Note>
  O agendamento de mensagens dentro de etapas individuais não é suportado atualmente. Mensagens push, email e SMS são enviadas imediatamente quando o usuário chega à etapa. Use uma [etapa de espera](./journeys-actions#wait) antes da etapa de mensagem se precisar de um atraso.
</Note>

***

## Notificação push

1. Clique em **(+)** e selecione **Notificação Push**.
2. No painel lateral, selecione um [template de mensagem](./templates) existente ou crie um novo.
3. Salve a etapa.

Quando um usuário chega a esta etapa, o OneSignal envia a notificação push imediatamente. O usuário deve ter uma assinatura push ativa para recebê-la.

<Tip>
  Dê nomes descritivos aos templates (ex.: "Boas-vindas — Push Dia 1") para que sejam fáceis de encontrar no dropdown.
</Tip>

***

## Email

Antes de adicionar uma etapa de email, confirme que você tem o [email configurado](./email-setup) no seu app do OneSignal.

1. Clique em **(+)** e selecione **Email**.
2. No painel lateral, selecione um [template de email](./templates) existente ou crie um novo.
3. Salve a etapa.

O OneSignal envia o email imediatamente quando o usuário chega a esta etapa. O usuário deve ter um endereço de email assinado.

Você pode personalizar o conteúdo do email usando [sintaxe Liquid](./using-liquid-syntax), [Data Tags](./add-user-data-tags), ou [Data Feeds](./data-feeds) para dados de API em tempo real no momento do envio.

***

## SMS

Antes de adicionar uma etapa de SMS, confirme que você tem o [envio de SMS configurado](./sms-messaging) no seu app do OneSignal.

1. Clique em **(+)** e selecione **SMS**.
2. No painel lateral, selecione um [template de SMS](./templates) existente. Se ainda não criou um, vá em **Mensagens > Templates > + Novo Template > Novo Template de SMS**.
3. Salve a etapa.

O OneSignal envia o SMS imediatamente quando o usuário chega a esta etapa. O usuário deve ter um número de telefone assinado.

***

## Mensagem in-app

Antes de adicionar uma etapa de mensagem in-app, confirme que você tem o [envio de mensagens in-app configurado](./in-app-messages-setup) no seu app.

1. Clique em **(+)** e selecione **Mensagem In-App**.
2. No painel lateral, projete sua mensagem usando o [editor de arrastar e soltar](./design-your-in-app-message) ou o [editor HTML](./design-your-in-app-message-with-html).
3. Opcionalmente configure [condições de gatilho](./iam-triggers) e um **agendamento de entrega** (a janela de tempo que o usuário tem para abrir o app e ver a mensagem).
4. Salve a etapa.

### Timing de sessão

Mensagens in-app requerem uma **nova sessão** para serem exibidas. Uma nova sessão começa quando o app está fora de foco por 30+ segundos e é trazido de volta ao foco.

Isso significa:

1. O usuário chega à etapa de mensagem in-app na Journey.
2. A mensagem **não** é exibida durante a sessão atual.
3. Na próxima vez que o usuário abrir o app (iniciando uma nova sessão), a mensagem é exibida se as condições de gatilho forem atendidas e o agendamento de entrega não tiver expirado.

<Warning>
  Se o usuário estiver usando o app ativamente quando chegar à etapa de mensagem in-app, ele não verá a mensagem até fechar e reabrir o app (após 30+ segundos). Planeje seu fluxo de Journey adequadamente — considere colocar uma [etapa de espera](./journeys-actions#wait) antes da mensagem in-app para permitir tempo para uma quebra de sessão natural.
</Warning>

<Info>
  Mensagens in-app em uma Journey são exibidas apenas uma vez por usuário. Mesmo que o usuário re-entre na Journey, a mesma mensagem in-app não será exibida novamente.
</Info>

***

## Webhooks

Além das etapas de mensagem, você pode adicionar **etapas de webhook** para enviar dados em tempo real a sistemas externos (CRMs, plataformas de análise, backends personalizados) em qualquer ponto da Journey. Webhooks são úteis para sincronizar o estado do usuário, acionar fluxos de trabalho externos ou registrar o progresso da Journey fora do OneSignal.

<Card title="Webhooks de Journey" icon="webhook" href="./journeys-webhook">
  Configure etapas de webhook para enviar dados a ferramentas externas durante uma Journey.
</Card>

***

## FAQ

### Posso agendar uma mensagem para ser enviada em um horário específico?

Não dentro da própria etapa de mensagem. Para atrasar a entrega, adicione uma [etapa de espera](./journeys-actions#wait) antes da etapa de mensagem. Você também pode usar as [configurações de agendamento](./journeys-settings#schedule) da Journey para controlar quando toda a Journey está ativa.

### Por que minha mensagem in-app não foi exibida?

Mensagens in-app requerem uma nova sessão para serem exibidas. Se o usuário já estava no app quando chegou à etapa, a mensagem fica na fila até a próxima sessão (app fora de foco por 30+ segundos, depois reaberto). Verifique também se as condições de gatilho foram atendidas e se o agendamento de entrega não expirou.

### Um usuário verá a mesma mensagem in-app se re-entrar na Journey?

Não. Mensagens in-app em uma Journey são exibidas apenas uma vez por usuário, independentemente de re-entrada. Para exibir uma mensagem novamente, crie uma nova etapa de mensagem in-app com conteúdo diferente.

### O que acontece se um usuário não tem assinatura para o canal de mensagem?

A etapa de mensagem é ignorada para esse usuário. Por exemplo, se uma etapa de email for atingida mas o usuário não tiver um endereço de email assinado, o email não é enviado e o usuário continua para a próxima etapa na Journey.

### Posso personalizar mensagens de Journey?

Sim. Templates de push, email e SMS suportam [sintaxe Liquid](./using-liquid-syntax) para inserir atributos de usuário, [Data Tags](./add-user-data-tags) e [propriedades de Evento Personalizado](./message-personalization#custom-events). Templates de email também suportam [Data Feeds](./data-feeds) para dados de API em tempo real no momento do envio.

## Páginas relacionadas

<Columns cols={2}>
  <Card title="Webhooks de Journey" icon="webhook" href="./journeys-webhook">
    Envie dados em tempo real a sistemas externos em qualquer ponto de uma Journey.
  </Card>

  <Card title="Ações de Journey" icon="code-branch" href="./journeys-actions">
    Adicione etapas de espera, lógica de ramificação e caminhos divididos entre etapas de mensagem.
  </Card>

  <Card title="Configurações de Journey" icon="gear" href="./journeys-settings">
    Configure regras de entrada, regras de saída, re-entrada e agendamento.
  </Card>

  <Card title="Personalização de mensagens" icon="user-pen" href="./message-personalization">
    Personalize mensagens com tags, sintaxe Liquid e propriedades de eventos personalizados.
  </Card>

  <Card title="Templates" icon="copy" href="./templates">
    Crie e gerencie templates de mensagens reutilizáveis entre canais.
  </Card>

  <Card title="Data Feeds" icon="database" href="./data-feeds">
    Puxe dados de API em tempo real para mensagens de email no momento do envio.
  </Card>
</Columns>
