Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Quando há correspondência de uma intent no ambiente de execução,
o agente do Dialogflow continua coletando informações do usuário final
até que ele forneça dados para cada um dos parâmetros obrigatórios.
Esse processo é chamado de preenchimento de slot.
Por padrão, o Dialogflow não envia uma solicitação de webhook de fulfillment até coletar todos os dados necessários do usuário final.
Se o webhook para preenchimento de slot estiver ativado, o Dialogflow enviará uma solicitação de webhook de fulfillment para cada conversão de conversação durante o preenchimento do slot.
Na maioria dos casos, as solicitações de parâmetros são suficientes para coletar todos os parâmetros obrigatórios, mas um webhook para preenchimento de slots permite definir uma lógica de agente mais específica durante a coleta dos parâmetros.
Por exemplo, o webhook pode lidar com a personalização de perguntas de acompanhamento ou a definição de slots de parâmetros que não podem ser recuperados da resposta do usuário final, como um banco de dados.
Ativar o webhook para o preenchimento de slots
Para ativar o webhook para preenchimento de slots no momento do projeto:
Selecione Intents no menu da barra lateral à esquerda.
Selecione uma intent.
Role para baixo até a seção Fulfillment.
Ative a opção Ativar chamada de webhook para preenchimento de slot.
Clique em Salvar.
Gerenciar o webhook para chamadas de preenchimento de slots no ambiente de execução
A mensagem de solicitação do webhook recebida pelo serviço do webhook tem um campo queryResult.parameters.
Esse campo contém o conjunto atual de parâmetros fornecidos pelo usuário final.
Os valores que ainda não foram coletados são definidos como strings vazias.
Um exemplo da mensagem de resposta do webhook para definir parâmetros pode ser encontrado em Exemplos de resposta do webhook.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[[["\u003cp\u003eDialogflow collects required data from users through a process called slot filling, continuing until all parameters are filled.\u003c/p\u003e\n"],["\u003cp\u003eBy default, Dialogflow only sends a fulfillment webhook request after all required data is collected, but it can be configured to send a request for each conversational turn.\u003c/p\u003e\n"],["\u003cp\u003eEnabling the webhook for slot filling provides more specific agent logic during parameter collection, such as customizing follow-up questions or setting parameters from a database.\u003c/p\u003e\n"],["\u003cp\u003eTo enable webhook calls during slot filling, toggle the "Enable webhook call for slot filling" option in the Fulfillment section of an intent within the Dialogflow ES console.\u003c/p\u003e\n"],["\u003cp\u003eWhen a webhook for slot filling is enabled, each request to the webhook contains a \u003ccode\u003equeryResult.parameters\u003c/code\u003e field showing the current parameters with uncollected values being empty strings.\u003c/p\u003e\n"]]],[],null,["# Webhook for slot filling\n\nWhen an intent is matched at runtime,\nthe Dialogflow agent continues collecting information from the end-user\nuntil the end-user has provided data for each of the required parameters.\nThis process is called\n[slot filling](/dialogflow/docs/intents-actions-parameters#required).\n\nBy default,\nDialogflow does not send a fulfillment webhook request\nuntil it has collected all required data from the end-user.\n\nIf *webhook for slot filling* is enabled,\nDialogflow sends a fulfillment webhook request for each\nconversational turn during slot filling.\n\nWhile in most cases, the parameter prompts are enough to collect all required\nparameters, a webhook for slot-filling allows you to define more specific agent\nlogic during collection of the parameters.\nFor example, your webhook could handle the customization of follow-up questions\nor setting parameter slots that cannot be retrieved from the end-user response,\nlike from a database.\n\nEnable webhook for slot filling\n-------------------------------\n\nTo enable webhook for slot filling at design-time:\n\n1. Go to the [Dialogflow ES console](https://dialogflow.cloud.google.com).\n2. Select an agent.\n3. Select **Intents** in the left sidebar menu.\n4. Select an intent.\n5. Scroll down to the **Fulfillment** section.\n6. Toggle **Enable webhook call for slot filling** on.\n7. Click **Save**.\n\nHandle webhook for slot filling calls at runtime\n------------------------------------------------\n\nThe webhook request message received by your webhook service\nhas a `queryResult.parameters` field.\nThis field contains the current set of parameters provided\nby the end-user.\nValues that have not been collected yet\nare set to empty strings.\n\nAn example of the webhook response message for setting parameters can be found in\n[Webhook Response examples](/dialogflow/docs/fulfillment-webhook#session_entity)."]]
