Confirmación de bloqueo de ejecución del widget SalesBot

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ámetro value 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
          }
      }
  ]
}
Path Params
int32
required

ID del bot

int32
required

ID de continuación. El sistema lo pasa al webhook.

string
enum
required

Tipo de bot

Allowed:
Body Params
json

Datos para el widget. Se pueden obtener en el código de SalesBot con la clave {{json.OBJECT_KEY_NAME}}, donde OBJECT_KEY_NAME es el nombre del campo pasado en "data"

json

Actualmente, los siguientes tipos de controladores son compatibles: show, goto

Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json