Chat App Message Service:Usar o Agentic Journey

Nome da jornada

Obrigatório. Identifica a jornada.

Tipo de gatilho

Selecione como a jornada será acionada. A tabela a seguir descreve os quatro tipos de gatilho compatíveis.

Método de criação

Escolha como criar a jornada. A tabela abaixo detalha os quatro métodos de criação disponíveis.

Observações

Opcional. Insira observações sobre a jornada. O limite é de 100 caracteres.

Escopo

O modo AI possui dois escopos:

• Canvas inteiro: quando nenhum componente está selecionado, a IA pode gerar uma jornada completa, incluindo múltiplos componentes e conexões.

• Componente único: ao selecionar um componente no canvas, a IA modifica apenas esse componente e mantém os demais inalterados.

Procedimento

1. Entrar no modo AI: no painel de configuração à direita, clique na aba AI mode.

2. Verificar o escopo: o escopo atual da IA aparece acima da caixa de entrada.

   • Quando nenhum componente estiver selecionado: Current scope: Entire canvas

   • Quando um componente estiver selecionado: Current scope: {component name}. A IA modificará apenas o componente selecionado.

3. Inserir um requisito:

   • Canvas inteiro: descreva o processo de negócios completo, por exemplo, "Desenhe um processo de rastreamento de encomendas e devoluções para o setor de logística".

   • Componente único: descreva a alteração desejada no componente, por exemplo, "Altere o tempo de espera para 48 horas".

4. Gerar a jornada:

   • A IA compreende seu requisito por meio de múltiplas rodadas de diálogo e pode fazer perguntas para esclarecer detalhes.

   • O canvas é atualizado automaticamente após a conclusão da geração.

5. Continuar ajustando: após a geração, continue o diálogo com a IA para fazer ajustes ou mude para o modo de parâmetros para uma configuração mais granular.

Modelos rápidos

Na primeira vez que você abrir o modo AI, o sistema fornecerá três botões de modelos rápidos:

• Design a welcome and onboarding process for new users

• Design a package tracking and return process for the logistics industry

• Design a coupon push process for a marketing campaign

  Clique em um modelo para enviar seu conteúdo à IA como seu requisito.

Procedimento

1. Abrir a biblioteca de componentes: clique no ícone Component library à esquerda para visualizar os componentes disponíveis. Cada componente possui um ícone de ponto de interrogação. Clique nele para ver a documentação de ajuda correspondente.

2. Adicionar um componente:

   • Arraste um componente da biblioteca para o canvas e posicione-o entre os componentes Start e End.

   • Alternativamente, clique no ícone + entre os componentes Start e End e selecione um componente.

3. Configurar o componente:

   • Clique em um componente no canvas. O painel de configuração à direita mudará para o modo de parâmetros.

   • Na aba do modo de parâmetros, configure os parâmetros do componente, como conteúdo da mensagem, condições e tempo de espera.

   • Para mais detalhes, consulte Agentic Journey component description.

4. Conectar componentes: as conexões entre os componentes são geradas automaticamente para indicar a ordem de execução.

5. Salvar a jornada: após concluir a orquestração, clique no ícone Save no topo da página. Para detalhes sobre salvamentos manuais e automáticos, consulte Save a journey.

Nota

Salve regularmente durante a orquestração para evitar perda de dados.

Alternar entre modos

É possível alternar entre o modo AI e o modo de parâmetros a qualquer momento durante a edição:

• Após selecionar um componente, o painel de configuração à direita exibe tanto a aba AI mode quanto a aba Parameter mode.

• Clique em uma aba para alternar os modos.

• As alterações feitas em qualquer modo são sincronizadas com o canvas em tempo real.

Colocar em produção

Salvar uma jornada

Durante a edição, clique no ícone Save no topo da página para salvar a jornada manualmente a qualquer momento. Cada salvamento manual cria uma entrada Manual save nos registros de operação, para a qual você pode reverter posteriormente usando o botão de reversão.

O sistema também salva a jornada automaticamente a cada 5 minutos. As entradas de salvamento automático são rotuladas como System auto-save.

Publicar uma jornada

Publique uma jornada para colocar em produção uma jornada recém-criada ou editada. Cada publicação bem-sucedida gera um número de versão.

1. Verificações pré-publicação: clique em Publish no topo da página. O sistema verifica os seguintes itens e bloqueia a operação de publicação se alguma verificação falhar:

   • Todas as jornadas referenciadas por esta jornada estão online. Não é possível publicar a jornada se uma jornada referenciada estiver offline.

   • A profundidade de referência não excede 5 níveis.

   • A jornada não contém referências circulares.

   • Todos os parâmetros obrigatórios dos componentes estão definidos.

2. Confirmação de publicação: após a aprovação nas verificações, confirme a operação de publicação.

3. Geração de versão:

   • Primeira publicação: a versão V1.0 é gerada e o status da jornada muda para Online.

   • Publicações subsequentes: o número da versão aumenta, por exemplo, para V2.0 ou V3.0, e a versão anterior muda para Offline.

4. Operação automática: após a publicação, a jornada executa automaticamente 24 horas por dia, 7 dias por semana. É possível visualizar seus dados de execução na página de detalhes da jornada.

   Se a operação de publicação falhar, consulte FAQ para conhecer as causas comuns.

Ativar ou desativar uma jornada

Na página de lista de jornadas, use Bring online para restaurar uma jornada desativada e use Take offline para parar uma jornada em execução.

Ativar uma jornada

• Aplica-se a jornadas com status offline.

• Clique em Bring online na coluna Actions.

• Antes de a jornada entrar em produção, o sistema executa as mesmas verificações descritas em Publish a journey. A jornada não pode ser ativada se alguma verificação falhar. Para as causas comuns, consulte FAQ.

Desativar uma jornada

• Aplica-se a jornadas com status online.

• Clique em Take offline na coluna Actions.

• Antes de a jornada ser desativada, o sistema verifica se ela é referenciada por outras jornadas online. Caso seja referenciada, a jornada não pode ser desativada e o sistema lista as jornadas que a referenciam.

• Após confirmar a operação, a jornada para de executar e seu status muda para Offline.

Gerenciamento de jornadas

Editar uma jornada

Na página de lista de jornadas, clique em Edit na coluna Actions para acessar a página de edição da jornada.

Lógica de edição

Status da jornada	Comportamento de edição
Draft	Abre o rascunho diretamente para edição.
Online	Cria um rascunho baseado na versão online. A versão online continua executando sem ser afetada. Se já houver um rascunho sendo editado, o rascunho salvo será aberto.
Offline	Cria um rascunho baseado na versão offline. Se já houver um rascunho sendo editado, o rascunho salvo será aberto.

Nota

• O estado de edição é isolado da versão online, portanto, editar uma jornada não afeta a jornada em execução.

• Após concluir a edição, publique a jornada novamente para gerar uma nova versão e colocá-la em produção.

Modificar a configuração do gatilho

Para modificar parte das informações do gatilho, clique em Trigger configuration na página de edição da jornada. Os campos modificáveis dependem do tipo de gatilho:

• API event trigger: é possível modificar o nome da jornada.

• Inbound message trigger: é possível modificar o nome da jornada, as contas vinculadas e os números comerciais. Não é possível modificar o tipo de canal.

• Audience plan trigger: é possível modificar o nome da jornada, o grupo de público-alvo e as datas do plano.

• Journey invocation trigger: é possível modificar o nome da jornada.

Gerenciamento de versões

O Agentic Journey oferece gerenciamento de versões. É possível visualizar versões históricas e reverter para elas.

Regras de versionamento

• Status de rascunho: uma nova jornada não possui número de versão e está no status de rascunho.

• Primeira publicação: a versão V1.0 é gerada e o status torna-se Online.

• Edição de jornada online ou offline: nenhuma nova versão é gerada. As alterações são feitas apenas no rascunho.

• Publicações subsequentes: quando uma jornada editada é publicada com sucesso novamente, uma nova versão é gerada e o número da versão aumenta para V2.0, V3.0 e assim por diante. A versão anterior muda para Offline.

Visualizar versões históricas

1. Na página de edição, clique no ícone Historical versions no canto superior direito.

2. Na caixa de diálogo, visualize todas as versões históricas, incluindo o número da versão, o status da jornada e o horário de atualização.

Operações de versão

Operação disponível	Descrição
View details	Clique em uma versão para abrir uma página de detalhes somente leitura que exibe todas as informações daquela versão.
Sync as draft	Clique em Sync as draft para sobrescrever o canvas que você está editando com o conteúdo dessa versão. Prossiga com cautela. Para desfazer a sincronização, reverta para o salvamento mais recente nos registros de operação.

Nota

• A operação Sync as draft sobrescreve todo o conteúdo do rascunho atual. O sistema solicitará confirmação antes da operação.

• Após a sincronização, publique a jornada novamente para gerar uma nova versão.

Registros de alterações

Os registros de alterações rastreiam o histórico de edição de uma jornada e permitem reverter para qualquer registro histórico.

Visualizar registros de operação

Na página de edição, clique no ícone Operation records no painel de configuração à direita para visualizar todos os registros de salvamento.

Tipos de registro

Tipo	Descrição	Número do registro
Manual save	Você clica no ícone Save.	Um novo número de registro é gerado, como #1, #2 ou #3.
Auto-save	O sistema salva a jornada automaticamente a cada 5 minutos.	Um novo número de registro é gerado.

Reverter uma jornada

1. Na lista de registros de alterações, localize o registro para o qual deseja reverter.

2. Clique em Roll back.

3. Após confirmar a operação, o conteúdo atual do canvas é sobrescrito pelo conteúdo desse registro.

Importante

• Uma reversão não pode ser desfeita. Confirme a operação cuidadosamente antes de prosseguir.

• Uma reversão não gera um novo número de registro.

• Se você reverter para o registro errado, selecione outro registro e reverta novamente.

Excluir uma jornada

Na página de lista de jornadas, clique em Delete na coluna Actions para excluir uma jornada.

Limites de exclusão:

• Apenas jornadas com status offline podem ser excluídas.

• Jornadas com status online não podem ser excluídas. Desative a jornada primeiro.

Importante

A exclusão não pode ser desfeita. Uma jornada excluída não pode mais ser utilizada. Prossiga com cautela.

Copiar uma jornada

Na página de detalhes da jornada, clique no ícone Copy as new journey no topo da página para copiar a jornada atual para uma nova jornada.

1. Clique no ícone Copy as new journey.

2. Na caixa de diálogo, insira um nome para a nova jornada. O nome padrão é {current journey name} copy.

3. Clique em Confirm. O sistema cria a nova jornada e abre sua página de edição.

Nota

• A cópia retém todas as configurações e componentes da versão atual.

• A nova jornada possui o mesmo tipo de gatilho e método de criação da jornada original.

Baixar uma jornada

Na página de detalhes da jornada, clique em Download no topo da página para exportar a versão atual como um arquivo JSON para o seu computador.

É possível importar o arquivo JSON baixado usando o método de criação Import journey ao criar uma jornada.

Painel de análise de dados

Visualize os dados de execução de uma jornada na página de detalhes da jornada.

1. Na página de lista de jornadas, clique no nome da jornada para acessar a página de detalhes da jornada.

2. Clique na aba Data Panel para visualizar os dados de execução da jornada.

Nota

• Apenas jornadas online possuem dados de execução.

• O painel de dados ajuda a entender o desempenho de uma jornada para que você possa ajustar e otimizar sua configuração oportunamente.

Perguntas frequentes

O Agentic Journey suporta limites de frequência de resposta automática?

O Agentic Journey não oferece suporte à definição direta de um limite de frequência de resposta automática. Sempre que um cliente envia uma mensagem que aciona uma jornada, o sistema executa a lógica de resposta automática dessa jornada. O sistema não identifica quantas vezes o cliente acionou a jornada no dia atual ou o estado histórico de interações, portanto, não pode implementar lógicas como "responder apenas uma vez por dia" ou "responder apenas uma vez independentemente de quantas mensagens o cliente enviar".

Para um controle de frequência semelhante, use um sistema externo, como um banco de dados que registre as contagens de acionamentos do cliente, juntamente com a OpenAPI para gerenciar o comportamento na camada de negócios.

Por que minha jornada não consegue entrar em produção?

Uma jornada pode falhar ao entrar em produção pelos seguintes motivos:

• A jornada referencia outra jornada, mas a jornada referenciada está offline.

• A profundidade de referência da jornada excede 5 níveis.

• A configuração do gatilho está incompleta. Por exemplo, um gatilho de mensagem recebida não tem nenhuma conta de canal configurada.

  Verifique as configurações acima e tente novamente.

Editar uma jornada online afeta a versão em execução?

Não. O estado de edição é isolado da versão online, portanto, a edição não afeta a jornada em execução. A nova versão entra em produção apenas após você publicar a jornada novamente, e a versão anterior é desativada automaticamente.

Como visualizo as relações de referência de uma jornada?

Na página de lista de jornadas, as colunas Referenced by e Journey references mostram o número de referências. Clique em um número para abrir uma caixa de diálogo que exibe as relações de referência detalhadas e informações sobre as jornadas referenciadas.

Referências

Para mais informações sobre o Agentic Journey, consulte os seguintes tópicos:

• Agentic Journey canvas

• Agentic Journey component reference

• Triggers