Fazendo uma chamada após o processamento de uma mensagem

Um webhook de pós-mensagem chama um serviço ou aplicativo externo toda vez que o assistente apresenta uma resposta. O serviço externo pode processar a saída do assistente antes que ela seja enviada ao canal.

Você pode adicionar um webhook pós-mensagem ao seu assistente se quiser acionar o webhook antes que cada resposta de mensagem seja mostrada ao cliente.

Você pode usar um webhook pós-mensagem para fazer coisas como extrair respostas personalizadas de um repositório de conteúdo externo. Por exemplo, é possível definir ações com IDs customizados na resposta em vez de texto. O webhook pós-mensagem pode passar essas IDs para um banco de dados externo para recuperar respostas de texto armazenadas.

Você pode usar esse webhook em coordenação com o webhook de pré-mensagem. Por exemplo, se você usar o webhook de pré-mensagem para remover informações de identificação pessoal da entrada do cliente, poderá usar o webhook de pós-mensagem para adicioná-las novamente. Se você usar o webhook de pré-mensagem para traduzir a entrada do cliente para o idioma do assistente, poderá usar o webhook de pós-mensagem para traduzir a resposta para o idioma do cliente antes de retorná-la. Para obter mais informações, consulte Fazendo uma chamada antes de processar uma mensagem.

Observação: para ambientes em que endpoints privados estão em uso, lembre-se de que um webhook envia tráfego pela Internet.

Definindo o webhook

É possível definir uma URL de webhook para usar para o processamento de cada resposta de mensagem antes de ela ser enviada para o canal e mostrada para o cliente.

Antes de iniciar

A chamada programática para o serviço externo deve atender a esses requisitos:

  • Não configure e teste o webhook em um ambiente de produção no qual o assistente está implementado e interagindo com os clientes.
  • A chamada deve ser uma solicitação de HTTP POST.
  • A chamada deve ser concluída em 30 segundos ou menos.
  • A solicitação e a resposta devem estar no formato JSON. Por exemplo, Content-Type: application/json.
Observação: use um webhook de diálogo se precisar executar uma ação única quando necessário durante uma conversa. Por exemplo, as condições são atendidas quando o assistente coleta todos os detalhes necessários, como o número da conta, o ID do usuário e o segredo da conta. Para obter mais informações, consulte Como fazer uma chamada programática a partir da caixa de diálogo.

Escolha seu método de implantação

Selecione o método de implementação que você usa para visualizar as etapas corretas de configuração de um webhook pós-mensagem.

Para identificar o tipo de implantação que você está usando, clique no menu Manage (Gerenciar ) Gerenciar menu. Se vir Mudar para a experiência clássica, você está usando a nova experiência. Se vir Mudar para nova experiência, você está usando a experiência clássica.

Observação: O tipo de implantação não se aplica a watsonx Orchestrate.

Use os links a seguir para conhecer os procedimentos com base em seu tipo de implantação: