Um gatilho define o que inicia uma Agentic Journey. Selecione o método de gatilho ao criar a jornada e configure as definições que o método escolhido exige.
escolha um método de gatilho
A Agentic Journey oferece suporte a quatro métodos de gatilho. A tabela a seguir compara esses métodos com base no que inicia a jornada, nos recursos dos quais ela depende e em quando usar cada um.
|
Método de gatilho |
Iniciado por |
Recursos dos quais depende |
Uso típico |
|
Um sistema externo, por meio de uma chamada de OpenAPI |
Um sistema externo que chama a OpenAPI |
Integrar uma jornada a um sistema externo |
|
|
Um usuário final, ao enviar uma mensagem por um canal de mensagens |
Uma conta de canal vinculada à jornada. Consulte Supported channel types. |
Responder automaticamente quando um usuário envia uma mensagem em um canal de mensagens compatível |
|
|
A programação do plano de público |
Um grupo de público criado em Audience Management > Group Management |
Executar campanhas de marketing para um grupo de público regularmente |
|
|
Outra jornada, por meio do componente Forward to Flow (New) |
Outra jornada que a invoca como uma subjornada |
Reutilizar a jornada como uma subjornada de outra jornada |
Configurações comuns da jornada
Todos os quatro métodos de gatilho utilizam as mesmas configurações de jornada. Após definir o Trigger Method e as configurações específicas do método, configure os parâmetros a seguir e clique em OK para criar a jornada:
Journey Name — Insira um nome para a jornada. Esta configuração é obrigatória.
Description — Insira uma descrição para a jornada. Esta configuração é opcional.
Creation Method — Selecione como construir a jornada: criação assistida por IA, um modelo, uma tela personalizada ou uma jornada importada.
Gatilho de evento de API
Um gatilho de evento de API inicia a jornada quando um sistema externo chama a OpenAPI. Use este método de gatilho quando a jornada precisar ser iniciada por um sistema externo, em vez de por um usuário final ou uma programação.
Procedimento
Faça login no Chat App Message Service console.
Na página Agentic Journey, clique em crie.
defina o Trigger Method como API Event Trigger.
Configure o common journey settings e clique em OK para criar a jornada.
Configure os parâmetros do gatilho
Após criar uma jornada que usa um gatilho de evento de API, defina os parâmetros que a jornada recebe:
Na página de edição da jornada, clique em Start na tela.
No painel de configuração, use o modo de parâmetro para adicionar os nomes das variáveis que a jornada recebe.
Os nomes dos parâmetros transmitidos pela OpenAPI devem corresponder aos nomes das variáveis definidas no nó Start. Caso contrário, a jornada descarta os parâmetros.
Gatilho de mensagem recebida
Um gatilho de mensagem recebida inicia a jornada quando um usuário final envia uma mensagem por um canal de mensagens. Use este método de gatilho para responder automaticamente a mensagens recebidas.
Tipos de canal compatíveis
Um gatilho de mensagem recebida inicia a jornada quando um usuário envia uma mensagem para a conta do canal vinculada à jornada. A tabela a seguir lista os tipos de canal compatíveis e o que você deve vincular para cada um.
|
Tipo de canal |
O que vincular |
|
|
Uma conta WABA e um número de telefone comercial do WhatsApp |
|
|
Uma conta profissional |
|
Messenger |
Uma página pública |
|
Viber |
Um ID de serviço |
|
Telegram |
Um ID de bot |
|
LINE |
Uma conta LOA |
Procedimento
O procedimento a seguir usa o WhatsApp como exemplo.
Faça login no Chat App Message Service console.
Na página Agentic Journey, clique em crie.
defina o Trigger Method como Incoming Message Trigger.
selecione WhatsApp na lista suspensa Channel Type.
Configure o Bind Account e o WhatsApp Business Phone Number.
Configure o common journey settings e clique em OK para criar a jornada e seu gatilho.
Modifique a configuração de gatilho de uma jornada existente
Para alterar a vinculação de conta de uma jornada que já usa um gatilho de mensagem recebida, execute as etapas a seguir:
Na página Agentic Journey, localize a jornada que deseja alterar.
clique em edite. Na página de edição, clique em Trigger Configuration no canto superior direito.
No painel de configuração do gatilho, modifique a vinculação da conta.
clique em OK e salve a configuração.
Gatilho de plano de público
Um gatilho de plano de público inicia a jornada automaticamente para os usuários em um grupo de público nos horários definidos pela programação. Use este método de gatilho para campanhas de marketing recorrentes.
Procedimento
Faça login no Chat App Message Service console.
Na página Agentic Journey, clique em crie.
defina o Trigger Method como Audience Plan Trigger.
selecione o grupo de público-alvo na lista suspensa Audience Group. Os grupos de público são criados e mantidos em Audience Management > Group Management.
-
Configure o Schedule Date:
Start Date: a data e a hora de início do plano de público.
End Date: a data e a hora de término do plano de público.
Configure o Execution Plan: defina a frequência de execução.
Configure o common journey settings e clique em OK para criar a jornada.
Gatilho de invocação de jornada
Um gatilho de invocação de jornada torna a jornada disponível como uma subjornada. Nenhum evento externo inicia uma jornada que usa este método de gatilho: apenas outra jornada pode iniciá-la, por meio do componente Forward to Flow (New).
Procedimento
Faça login no Chat App Message Service console.
Na página Agentic Journey, clique em crie.
defina o Trigger Method como Journey Invocation Trigger.
Configure o common journey settings e clique em OK para criar a jornada.
Invoque a jornada a partir de outra jornada
Ao usar o componente Forward to Flow (New) em outra jornada, selecione esta jornada como a subjornada.
A jornada invocada recebe os parâmetros transmitidos pela jornada invocadora e retorna o resultado para a jornada invocadora após a conclusão.