Esperar mensagem

Wait for Message suspende até que o usuário envie uma mensagem e, em seguida, gera o contexto de conversa mais recente para os nós de conversa downstream consumirem.

O que faz

Aguarda até que o usuário envie a próxima mensagem na conversa e, em seguida, retoma com o contexto da conversa mais recente — o histórico do chat e informações do perfil do usuário — como sua saída.

Sempre coloque um nó Aguardar mensagem imediatamente após o gatilho de conversa para garantir que o fluxo esteja pronto para a primeira mensagem do usuário. Você pode fazer um loop de volta para etapas de acompanhamento ou adicionar mais nós Aguardar mensagem em outro lugar do fluxo.

Entradas

Campo	Description
ID da conversa	O ID da conversa a ser aguardada. Associe à saída do gatilho de conversa, por exemplo,.$vars.conversationTrigger1.output.conversationId
Limite de trocas	Número máximo de trocas anteriores (retorno e para frente) a serem incluídas no histórico de conversas retornadas. Determina quantas mensagens anteriores no histórico de conversas são retornadas.

Saída

Campo	Description
conversationContext	O contexto da conversa mais recente, incluindo o histórico de mensagens.

O conversationContext contém os seguintes campos:

Campo	Description
latestExchangeId	Identificador da troca mais recente (ir para frente e para trás). Use como a entrada do ID do Exchange para Enviar mensagem ao responder à conversa.
messages	O histórico da conversa recente, incluindo as mensagens do usuário e do fluxo. O limite de troca determina quantas trocas anteriores serão incluídas.
userSettings	Campos de perfil no nível do usuário, configuráveis pelo usuário final nos canais.

Exemplos de uso

Faça referência ao contexto completo da conversa em um nó subsequente do Agente de conversação :

$vars.waitForMessage1.output.conversationContext

Faça referência à saída latestExchangeId em um nó downstream Enviar mensagem :

$vars.waitForMessage1.output.conversationContext.latestExchangeId

Como lidar com vários nós Aguardar mensagem

Quando você tem vários nós Aguardar mensagem, você pode configurar acidentalmente um nó downstream para fazer referência a um contexto de conversa obsoleta de um nó Aguardar mensagem que foi executado anteriormente.

Para um rastreamento mais fácil, crie uma variável no nível do fluxo (por exemplo, $vars.globalConversationContext) e atualize-a na seção Atualizar variável de cada nó Aguardar mensagem. Os nós subsequentes podem fazer referência a essa única fonte de verdade em vez de precisar escolher a saída do nó Aguardar mensagem executada pela última vez.

Páginas relacionadas

• Gatilho de conversa — fornece o ID da conversa que este nó consome.
• Agente de conversação — o consumidor típico da saída conversationContext desse nó.
• Enviar mensagem — escreva na conversa, usando latestExchangeId desse nó para continuar a mesma troca.
• Chat — paleta completa de nós de conversação de chat.
• Crie um fluxo de trabalho de agente de chat — tutorial completo.
• Implantação de chat — publique e exponha o fluxo por meio de vários canais.