Introducción
Esta documentación enseña cómo dirigir a un usuario a un subbot (servicio) específico de un enrutador y, opcionalmente, a un bloque determinado dentro de ese flujo, utilizando la API de Blip.
Esta acción es útil para:
Realizar pruebas y validaciones en puntos específicos del flujo.
Importante: Para que este proceso funcione correctamente, la opción "Utilizar el contexto del Enrutador" debe estar activada en las configuraciones de flujo de todos los subbots (servicios) vinculados al enrutador.
Dirigir a un subbot/servicio de un enrutador (Master-State)
Para mover al cliente a un subbot/servicio vinculado al enrutador, utilice la siguiente solicitud:
Solicitud (Master State)
POST https://{{contractid}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_ROUTER_TOKEN}
{
"id": "{{$guid}}",
"to": "postmaster@msging.net",
"method": "set",
"uri": "/contexts/{{contact.identity}}/Master-State",
"type": "text/plain",
"resource": "{{idDoSubbot}}@msging.net"
}Donde:
-
YOUR_ROUTER_TOKEN: Token de autorización del Enrutador (y no del subbot).
Sugerencia: Consulte la documentación ¿Cómo encontrar la API-KEY de mi bot?
-
contact.identity: Identificador del usuario en el enrutador.
Ejemplo: En WhatsApp, es el número de teléfono + sufijo (ej: 5511999999999@wa.gw.msging.net).
-
idDoSubbot: El ID de identificación del subbot de destino.
Sugerencia: Consulte la documentación Cómo encontrar su ID en caso de que necesite localizar esta información.
Dirigir a un bloque específico del subbot (Change-User-State)
Si desea dirigir al usuario a un bloque específico del flujo, utilice la solicitud Change User State después de la ejecución del paso anterior.
POST https://{{contractid}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_ROUTER_TOKEN}
{
"id": "{{$guid}}",
"to": "postmaster@msging.net",
"method": "set",
"uri": "/contexts/{{contact.identity}}/stateid@{{flow-identifier}}",
"type": "text/plain",
"resource": "{{state-id}}"
}Donde:
{{contact.identity}} y {YOUR_ROUTER_TOKEN}: Utilice los mismos datos de la solicitud Master State;
{{flow-identifier}}: Es el identificador del flujo del subbot. Puede localizarse en las Configuraciones generales del Builder;
-
{{state-id}}: El ID del bloque de destino en el Builder.
Cómo encontrar: Acceda al Builder, haga clic en el bloque deseado con el botón derecho del ratón y seleccione la opción "Copiar ID".
Cabe resaltar que el bloque al cual el usuario será dirigido no mostrará su contenido, ejecutando solamente las condiciones y acciones de salida, que serán validadas después de la respuesta del usuario.
Por este motivo, es aconsejable mantener un botón de entrada del usuario (entrada del usuario) en el bloque donde se recibirá el mensaje del usuario y sin contenido (mensajes). Luego, cree una condición de salida para tratar su respuesta y dirigir al bloque deseado.
Ejemplo:
Para más información, acceda a la discusión sobre el asunto en nuestra comunidad o los vídeos en nuestro canal. 😃