El método recibe los datos después de la ejecución exitosa de un bloque de widget en el Salesbot y continúa el flujo de trabajo del bot.
Limitaciones
- El método está disponible para los administradores de la cuenta.
- El número máximo de manejadores que se pueden pasar en el parámetro
"execute_handlers"
es 10.- Si se proporciona un manejador
"show"
en"execute_handler"
, el parámetrovalue
no debe exceder los 80 caracteres.- El número máximo de botones que se pueden pasar en
"execute_handler"
es 25.
Parámetros de la solicitud
Si el widget necesita enviar algún dato, debe colocarse en el campo “data”
como un objeto.
Si el widget necesita realizar una acción antes de que el bot continúe funcionando, entonces se puede pasar una lista de manejadores al parámetro "execute_handlers"
. Los manejadores pasados se ejecutan uno por uno.
Un ejemplo de la solicitud
En el siguiente ejemplo, pasaremos un campo “status”
field to the widget. al widget. El widget podrá obtener el valor de ese campo (“success”
) en cualquier bloque después del "widget_request"
utilizando la clave {{json.status}}
. También le indicaremos al bot del widget que muestre texto, botones, botones con enlaces, y que vaya al paso 5 del bot del widget.
{
"data": {
"status": "success"
},
"execute_handlers": [
{
"handler": "show",
"params": {
"type": "text",
"value": "Tu texto"
}
},
{
"handler": "show",
"params": {
"type": "buttons",
"value": "Presiona el botón",
"buttons": [
"Botón 1",
"Botón 2",
"Butón 3",
"Butón 4",
...
"Botón 25"
]
}
},
{
"handler": "show",
"params": {
"type": "buttons_url",
"value": "Botones con enlaces",
"buttons": [
"https://kommo.com"
]
}
},
{
"handler": "goto",
"params": {
"type": "question|answer|finish",
"step": 5
}
}
]
}