Referência de ponto

Cada ponto carrega um objeto point_data com exatamente uma chave aninhada, correspondendo ao point_type do ponto (consulte o mapeamento de tipo de ponto → chave). Esta página documenta a estrutura sob cada chave.

Nota

Pontos de entrada, tempo, divisão, ação e conversão são documentados integralmente abaixo.

Para pontos de mensagens (send_*, inapp), esta página cobre apenas os campos estruturais: qual predefinição ou conteúdo referenciar e quais configurações de canal passar. O conteúdo da mensagem em si é definido na predefinição e documentado na API de Predefinições e na documentação por canal. Alguns campos referenciam objetos aninhados que espelham os controles no construtor da Customer Journey.

Pontos de entrada

Uma jornada precisa de pelo menos um ponto de entrada. Todos os pontos de entrada têm uma única saída default.

start_by_segment

Insere usuários que correspondem a um segmento. POINT_TYPE_START_BY_SEGMENT.

Campo	Tipo	Descrição
application_code	string	Código da aplicação.
filter_code	string	Código do segmento/filtro que define o público.
repeat	SegmentRepeat	Agendamento opcional de entrada recorrente (consulte SegmentRepeat).
start_at	timestamp	Não processar antes deste horário (ISO 8601).
is_deactivated	bool	Se este ponto de entrada está desativado.

message_bus (entrada por evento)

Insere usuários quando eles disparam um evento. POINT_TYPE_EVENT.

Campo	Tipo	Descrição
event_name	string	Nome do evento a ser escutado.
application_code	string	Código da aplicação.
event_conditions	PointEventCondition[]	Condições comparadas com os atributos do evento.
active_period	Period	Janela de tempo durante a qual o gatilho está ativo.
multi_entry	MultiEntry	Como um usuário pode entrar mais de uma vez (consulte MultiEntry).
attribute_entry	AttributeEntry	Inscreve os IDs de usuário contidos em um atributo de evento em vez do usuário que disparou o evento (consulte AttributeEntry).
allow_reenter	bool	Se os usuários podem reentrar na jornada.

AttributeEntry

Inscreve os IDs de Usuário contidos em um atributo de evento, em vez do usuário que disparou o evento. Espelha Usuários de um atributo de evento no construtor da Customer Journey.

Campo	Tipo	Descrição
enabled	bool	Se deve inscrever usuários nomeados em um atributo de evento em vez do usuário que disparou o evento.
attribute_name	string	Nome do atributo de evento que contém o ID de Usuário (ou lista de IDs de Usuário) a ser inscrito.

start_by_api

Ponto de entrada alimentado pela chamada Start by API. POINT_TYPE_START_BY_API.

Campo	Tipo	Descrição
application_code	string	Código da aplicação.
attributes	string[]	Nomes dos atributos personalizados que podem ser passados nos attribute_values de uma solicitação Start by API.
is_deactivated	bool	Se este ponto de entrada está desativado.

Pontos de tempo

delay (espera)

Pausa cada usuário por um intervalo fixo ou calculado. POINT_TYPE_WAIT. O objeto point_data.delay define exatamente uma das seguintes chaves de intervalo:

Chave de intervalo	Tipo	Descrição
sec	uint64	Espera um número fixo de segundos.
exact_time	ExactTime	Espera até uma hora do dia (hour, minute).
exact_date_time	ExactDateTime	Espera até uma data e hora absolutas.
exact_week_days_time	ExactWeekDaysTime	Espera até horários específicos em dias da semana específicos (mapa de dia 0=Segunda … 6=Domingo → ExactTime).
dynamic_time	DynamicTime	Espera em relação a um valor de uma tag ou evento.

Um dynamic_time com split_branches: true adiciona uma ramificação output1 (consulte chaves de saída).

DynamicTime

Campo	Tipo	Descrição
from	enum DynamicTimeFrom	Se o tempo base vem de uma tag ou de um evento.
direction	enum DynamicTimeDirection	Deslocamento antes ou depois do tempo base.
duration	uint64	Tamanho do deslocamento.
unit	enum DynamicTimeUnit	Unidade de duration (minutos, horas, dias, …).
split_branches	bool	Divide os usuários em ramificações separadas quando seus tempos calculados diferem.
tag_name	string	Tag que contém o tempo base (quando from é uma tag).
event_name / event_attribute / point_id	string	Fonte do evento do tempo base (quando from é um evento).

wait_event

Espera até que os usuários disparem um evento (ou um tempo limite). POINT_TYPE_WAIT_EVENT. A saída default é o caminho não-disparado. O caminho disparado é output1 ou, com um script, uma ramificação por condição.

Campo	Tipo	Descrição
events	PointWaitEventInfo[]	Eventos a serem aguardados.
conditions_script	string	Script opcional para lógica complexa de múltiplos eventos. Seus nomes de condição analisados se tornam as chaves de saída.
multi_entry	MultiEntry	Comportamento de reentrada.

Pontos de divisão e filtragem

boolean_splitter

Encaminha os usuários por ramificações com base em uma condição. POINT_TYPE_BOOLEAN_SPLITTER.

Campo	Tipo	Descrição
split_strategy	enum	SPLIT_FILTER (por segmento), SPLIT_TAGS (por condições de tag) ou SPLIT_EVENTS (por condições de evento).
load_policy	enum	ALL (qualquer um dos dispositivos do usuário pode corresponder) ou FILTER (apenas o dispositivo atual).
filter_code	string	Código do segmento, quando split_strategy é SPLIT_FILTER.
filter_expressions	FilterExpression[]	Condições de tag, quando split_strategy é SPLIT_TAGS: uma ramificação output extra por expressão.
event	BooleanSplitterEventInfo	Condições de evento, quando split_strategy é SPLIT_EVENTS: uma ramificação output extra por condição.

ab_splitter

Divide aleatoriamente os usuários em variantes ponderadas. POINT_TYPE_AB_SPLITTER. As chaves de saída são output0, output1, … (uma por entrada em split, indexada a partir de 0. Não há default).

Campo	Tipo	Descrição
split	uint32[]	Porcentagem para cada ramificação. Deve somar 100. O índice i mapeia para a chave de saída output{i}.
auto_select_winner	bool	Se deve escolher automaticamente uma ramificação vencedora.
winner_strategy	enum	ANY_GOAL ou SPECIFIC_GOAL.
goal_uuid	string	Meta usada para determinar o vencedor (com SPECIFIC_GOAL).
winner_split	uint32	Número da ramificação vencedora (base 1, 0 = ainda sem vencedor).

filter

Permite que apenas os usuários correspondentes continuem (default), encaminhando o restante para output1. POINT_TYPE_FILTER.

Campo	Tipo	Descrição
filter	enum Filter	Uma verificação predefinida: EMAIL_EXISTS, PUSH_TOKEN_EXISTS, SMS_TOKEN_EXISTS, WHATSAPP_TOKEN_EXISTS, LINE_TOKEN_EXISTS ou CUSTOM.
filter_raw	string	Expressão de filtro personalizada, quando filter é CUSTOM.

Pontos de ação

set_tags

Atualiza as tags no usuário. POINT_TYPE_SET_TAGS.

Campo	Tipo	Descrição
application_code	string	Código da aplicação.
tags	Tag[]	Tags a serem escritas.

Tag

Campo	Tipo	Descrição
name	string	Nome da tag.
type	enum TagType	Tipo de dados e operação: TYPE_STRING, TYPE_INTEGER, TYPE_DATE, TYPE_BOOLEAN, TYPE_LIST, TYPE_LIST_APPEND, TYPE_LIST_REMOVE, TYPE_DYNAMIC, …
value	oneof	Exatamente uma chave de valor correspondente a type: str, int, bool, date, price, version, timezone, list ou dynamic.

web_hook

Envia uma solicitação HTTP de saída. POINT_TYPE_WEBHOOK. Saída única default.

Campo	Tipo	Descrição
method	string	Método HTTP (GET, POST, PUT, …).
url	string	URL de destino.
request_template	string	Modelo do corpo da solicitação. Suporta modelagem Liquid.
headers	map<string, string>	Cabeçalhos HTTP.
disabled	bool	Apenas leitura. true quando o Pushwoosh desativou automaticamente o webhook após erros repetidos.
reactivate	bool	Apenas escrita. Defina como true para reativar um webhook desativado.

audience_sync

Adiciona ou remove o usuário de um Público Personalizado da Meta. POINT_TYPE_AUDIENCE_SYNC.

Campo	Tipo	Descrição
ad_account_id	string	ID da conta de anúncios da Meta.
ad_account_name	string	Nome de exibição para ad_account_id, apenas para a interface do usuário.
audience_id	string	ID do Público Personalizado da Meta.
audience_name	string	Nome de exibição para audience_id, apenas para a interface do usuário.
action	enum AudienceSyncAction	AUDIENCE_SYNC_ACTION_ADD ou AUDIENCE_SYNC_ACTION_REMOVE.

Cuidado

Isso não é verificado quando você cria ou atualiza o ponto — apenas quando a jornada é validada ou iniciada. Um ad_account_id inválido (não mais conectado) ou audience_id (não retornado pela Meta) é salvo sem erro e só aparece nesse momento, não silenciosamente na sincronização de cada usuário.

Pontos de conversão

goal_event

Rastreia uma meta de conversão. POINT_TYPE_GOAL_EVENT. Não tem saídas.

Campo	Tipo	Descrição
event_name	string	Nome do evento da meta.
application_code	string	Código da aplicação.
event_conditions	PointEventCondition[]	Condições comparadas com os atributos do evento da meta.
is_throw_out	bool	Se deve remover o usuário da jornada assim que a meta for alcançada.
is_cancel_event	bool	Se esta é uma meta negativa (de cancelamento).

Pontos de saída

terminator

Termina a jornada para o usuário. POINT_TYPE_EXIT. Objeto vazio ({}) e sem saídas.

{ "point_type": "POINT_TYPE_EXIT", "point_data": { "terminator": {} }, "outputs": [] }

Um ponto terminador é opcional. Deixar o info.next_point_uuid de uma saída não definido termina a jornada para o usuário da mesma forma que um terminador explícito — ambos os casos são contados da mesma maneira, como Saídas, e não como erros.

Pontos de mensagens

Todos os pontos de mensagens enviam através de um canal e compartilham um envelope comum. Cada um tem uma única saída default, a menos que um divisor esteja habilitado (consulte chaves de saída).

Campos comuns:

Campo	Tipo	Descrição
application_code	string	Código da aplicação.
preset_code	string	Predefinição (modelo) a ser enviada. inapp usa richmedia_code em vez disso.
content / title	string	Conteúdo da mensagem em linha, quando não se usa uma predefinição (dependente do canal).
campaign_code	string	Código da campanha para rastreamento. Criado automaticamente se omitido.
split_params	BehaviorSplitter	Opcional: espera por uma interação e ramifica com base nela.
message_type	enum	Tipo de mensagem Marketing vs transacional (controla o manuseio do grupo de controle). Não usado por send_email, que tem seu próprio par email_type/email_category abaixo.

Tipos de ponto e seus campos extras notáveis:

Tipo de ponto	Chave point_data	Notas
POINT_TYPE_SEND_PUSH	send_push	split_params (comportamento) mais um divisor de entrega podem produzir até três saídas. send_by_user_id, wait_optimal_time.
POINT_TYPE_SEND_EMAIL	send_email	liquid_template_params, personalise, email_type, email_category (veja abaixo). Consulte a API de E-mail.
POINT_TYPE_SEND_SMS	send_sms	Consulte SMS.
POINT_TYPE_SEND_WHATSAPP	send_whatsapp	personalise (veja abaixo). Uma predefinição de resposta rápida adiciona uma saída por resposta (chave = valor da resposta). Consulte WhatsApp.
POINT_TYPE_SEND_TELEGRAM	send_telegram	Canal do Telegram.
POINT_TYPE_SEND_KAKAO	send_kakao	Consulte Kakao.
POINT_TYPE_SEND_LINE	send_line	Consulte a API LINE.
POINT_TYPE_SEND_DATA	send_data	Mensagem de dados silenciosa (sem interface de usuário).
POINT_TYPE_INAPP	inapp	Usa richmedia_code, expire_in_days, capping.

Cuidado

Em send_email, email_type deve ser omitido ou definido exatamente como marketing ou transactional — em minúsculas, qualquer outro valor é rejeitado. email_category é obrigatório quando email_type é marketing e deve ser o código de uma categoria existente, não seu nome de exibição.

Em send_whatsapp, uma entrada personalise.placeholders[] com type: "MPM" (mensagem de múltiplos produtos) deve ter actions.actions[].type definido exatamente como action — o único tipo de ação que a Meta aceita em um botão de modelo MPM. Qualquer outro valor é rejeitado.

Nada disso é verificado quando você cria ou atualiza o ponto — apenas quando a jornada é validada ou iniciada. Um valor inválido é salvo sem erro e só aparece nesse momento.

Tipos compartilhados

SegmentRepeat

Campo	Tipo	Descrição
enabled	bool	Se a entrada recorrente está ativada.
frequency	string	daily, weekly, monthly ou dates.
every	uint32	Repetir a cada N períodos.
dates	string[]	Datas específicas, quando frequency é dates.
time	SegmentRepeatTime	Configuração da hora do dia.

Objetos de tempo

• ExactTime: { "hour": 0–23, "minute": 0–59 }.
• ExactDateTime: { "year", "month": 1–12, "day": 1–31, "hour": 0–23, "minute": 0–59 }.

BehaviorSplitter

Campo	Tipo	Descrição
enabled	bool	Se deve esperar por uma interação e ramificar com base nela.
interval	uint64	Segundos para esperar pela interação.

MultiEntry

Controla quantas sessões ativas um usuário pode ter na jornada ao mesmo tempo. Espelha Controlar quantas sessões um usuário pode ter ao mesmo tempo no construtor da Customer Journey. Usado pelo ponto de entrada de evento e wait_event.

Campo	Tipo	Descrição
enabled	bool	Se um usuário pode ter várias sessões ativas ao mesmo tempo. false: uma sessão ativa por usuário. true: várias sessões ativas por usuário.
attribute_name	string	Opcional. Atributo de evento que define o escopo de cada sessão. Quando definido, um usuário pode ter uma sessão ativa por valor distinto deste atributo (por exemplo, uma por order_id). Eventos com o mesmo valor compartilham uma sessão. Deixe em branco para agrupar todas as entradas do usuário.

Relacionados

Objeto Journey

Criar e atualizar

API de Predefinições