O método recebe dados após a execução bem-sucedida do bloco do widget no SalesBot e continua o fluxo de trabalho do Bot.
Limitações
- O método está disponível para administradores da conta.
- O número máximo de manipuladores que podem ser passados no parâmetro
"execute_handlers"
é 10.- Se um manipulador
"show"
for fornecido em"execute_handler"
, o parâmetrovalue
não deve exceder 80 caracteres.- O número máximo de botões que podem ser passados em
"execute_handler"
é 25
Request parameters
Se o widget precisar passar algum dado, ele deve ser inserido no campo "data"
como um objeto.
Se o widget precisar executar uma ação antes que o bot continue funcionando, você pode passar uma lista de manipuladores para o parâmetro "execute_handlers"
. Os manipuladores passados são executados um por um.
Exemplo de solicitação
No exemplo a seguir, passaremos um campo "status"
para o widget. O widget poderá obter o valor do campo ("success")
em qualquer bloco após o "widget_request"
pela chave {{json.status}}
. Também instruiremos o bot do widget a exibir texto, botões, botões com links e ir para a etapa 5 do bot do widget.
{
"data": {
"status": "success"
},
"execute_handlers": [
{
"handler": "show",
"params": {
"type": "text",
"value": "Seu texto"
}
},
{
"handler": "show",
"params": {
"type": "buttons",
"value": "Pressione o botão",
"buttons": [
"Botão 1",
"Botão 2",
"Botão 3",
"Botão 4",
"Botão 25"
]
}
},
{
"handler": "show",
"params": {
"type": "buttons_url",
"value": "Botões com links",
"buttons": [
"https://kommo.com"
]
}
},
{
"handler": "goto",
"params": {
"type": "question|answer|finish",
"step": 5
}
}
]
}