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

# Journeys

> Fluxos de conversa automatizados e em múltiplas etapas no WhatsApp — gatilhos, lógica de ramificação e onde as journeys se encaixam no modelo de dados.

Journeys são o primitivo de automação do Switchbord para conversas em múltiplas etapas — sequências de onboarding, lembretes de carrinho abandonado, campanhas de nutrição (drip), pesquisas automatizadas. Enquanto uma [Campaign](/pt-BR/features/campaigns) é um envio único para uma audiência, uma journey é um grafo: um contato entra por um gatilho, passa por etapas de mensagem e espera, ramifica-se com base em condições e pode alcançar uma meta.

Esta página é a visão geral. Para o editor gráfico em si — canvas, tipos de nó, versionamento — veja o aprofundamento em [Editor gráfico de journeys](/pt-BR/whatsapp/journey-editor).

## Como uma journey é construída

As journeys são criadas em um canvas visual (construído sobre o React Flow) onde você arrasta, solta e conecta nós:

<CardGroup cols={2}>
  <Card title="Nó de mensagem" icon="message">
    Envia um template específico do WhatsApp ou uma mensagem de texto livre para o contato.
  </Card>

  <Card title="Nó de espera" icon="hourglass">
    Pausa a journey por uma duração definida antes de continuar — por exemplo, "esperar 2 horas".
  </Card>

  <Card title="Nó de condição" icon="code-branch">
    Ramifica o fluxo com base em lógica como "se o botão foi clicado" ou "se a tag existe".
  </Card>

  <Card title="Nó de meta" icon="flag-checkered">
    Marca a conclusão bem-sucedida de um evento de conversão, rastreado nas estatísticas de desempenho da journey.
  </Card>
</CardGroup>

As arestas conectam os nós e representam o caminho que um contato percorre — um único nó pode se ramificar em múltiplas arestas acionadas por diferentes ações do cliente (um clique em botão, uma resposta com palavra-chave).

## Execução em tempo real

As journeys reagem aos webhooks recebidos no momento em que ocorrem. Quando um contato interage com uma mensagem — clicando em um botão, respondendo com uma palavra-chave — o motor de journeys avalia imediatamente a condição relevante e avança o contato para o próximo nó, sem qualquer atraso de polling.

## Rascunhos e publicação

Novas journeys começam no modo **Draft**, onde você pode construir e testar o grafo sem afetar nenhum contato ativo. Ao publicar uma nova versão, você escolhe se os contatos que já estão parcialmente avançados na versão anterior terminam como estão ou migram para a nova lógica — assim você pode iterar em uma journey ativa sem interromper contatos no meio do fluxo.

## Monitoramento de desempenho

Todo nó em uma journey publicada exibe estatísticas em tempo real: quantos contatos **entraram** naquela etapa, quantos **abandonaram** (deixaram de avançar) e quantos **converteram** rumo a uma meta. Isso torna simples identificar exatamente a etapa em que um fluxo está perdendo pessoas.

## Modelo de dados

As journeys são armazenadas como registros `journeys`, com o progresso dos contatos rastreado em relação às definições em `templates` (para etapas de mensagem) e ao livro-razão central de `conversations`/`messages` para o histórico de execução. Veja [Modelo de dados](/pt-BR/platform/data-model#templates-campanhas-e-jornadas) para entender como as journeys se relacionam com templates, campaigns e o restante do esquema.

## Criando rascunhos com a Margaret

Você pode descrever uma journey em linguagem natural e pedir à [Margaret](/pt-BR/features/margaret) para rascunhar o formato do grafo para você — ela propõe uma estrutura que você revisa e aprova antes de ela ser criada, o mesmo padrão de rascunho e aprovação usado para templates e respostas.

## Veja também

* [Editor gráfico de journeys](/pt-BR/whatsapp/journey-editor) — o canvas, os tipos de nó e o versionamento em detalhes.
* [Modelo de dados](/pt-BR/platform/data-model) — como `journeys` se encaixa com `templates`, `campaigns` e o livro-razão de mensagens.
* [Campaigns](/pt-BR/features/campaigns) — a alternativa de envio único a uma journey em múltiplas etapas.
* [Automations](/pt-BR/features/automations) — como as journeys se combinam com as capacidades de automação da Margaret.
