El pasoHacer llamada de API德尔generador de flujos permite que un bot de mensajería utilice una solicitud de API de REST para extraer datos de un sistema externo como Shopify o Salesforce.
Esta receta sirve de guía para crear una respuesta de bot encargada de extraer información meteorológica para un lugar proporcionado por el usuario final. La respuesta obtiene los datos de laAPI de OpenWeather. El flujo de respuesta creado con esta receta se puede usar como un punto de partida para crear sus propias respuestas impulsadas por la API.
- Tarea 1: Verificar la configuración
- Tarea 2: Crear una conexión de API
- Tarea 3: Crear un campo de ticket personalizado
- Tarea 4: Crear una respuesta usando el generador de flujos
- Tarea 5: Probar los cambios
Tarea 1: Verificar la configuración
Para completar esta receta, se necesita lo siguiente:
- Una cuenta de Zendesk con un bot de mensajería publicado. Si desea, puede usar unentorno de pruebas de sandboxpara probar el bot antes de usarlo en producción.
Para configurar un bot de mensajería en un canal de mensajería por web y móvil, consulteTrabajar con bots de mensajería para los canales web y móvil. Para configurar un bot de mensajería en un canal de redes sociales, consulteUso del generador de flujos para crear un bot de mensajería por redes sociales.Si desea información sobre cómo usar la mensajería en un entorno de sandbox, consulteUso de la mensajería en un sandbox.
- Una clave de API para una cuenta deOpenWeather. La API que se usa en esta receta está disponible en el plan gratuito de OpenWeather.
Para registrarse para una cuenta gratis de OpenWeather, consulte la página Create New Account (Crear nueva cuenta) del sitio webopenweathermap.org. Después de iniciar sesión, puede obtener una clave de API en lapágina de su cuenta de OpenWeather.
Para activar las claves de API de OpenWeather, debe verificar la dirección de correo electrónico de su cuenta. Después de la verificación, las claves de API pueden demorar hasta dos horas para activarse. Si desea más información, consulte las preguntas frecuentes enopenweathermap.org.
Tarea 2: Crear una conexión de API
Para comenzar, cree una conexión de API para guardar su clave de API de OpenWeather. Su bot de mensajería puede usar esta conexión para autenticar las llamadas a la API de OpenWeather.
- En elCentro de administracion, haga clic en
Aplicaciones e integracionesen la barra lateral y luego seleccioneConexiones > Conexiones. - Haga clic enCrear conexion.
- Seleccione el tipo de autenticaciónClave API.
- Ingreseopenweather_api_keycomo elNombre de la conexión.
- Ingresex-api-keycomo elNombre del encabezado.
- Ingrese la clave de API de OpenWeather como elValor.
- Ingreseapi.openweathermap.orgcomo elDominio permitido.
- Haga clic enGuardarpara crear la conexión.
Tarea 3: Crear un campo de ticket personalizado
Luego cree un campo de ticket personalizado para capturar la ubicación proporcionada por el usuario final.
- En elCentro de administracion, haga clic en
Objetos y reglasen la barra lateral y luego seleccioneTickets > Campos. - Haga clic enAgregar campo.
- Seleccione el tipo de campoTexto.
- IngreseUbicacióncomo elNombre mostrado.
- BajoPermisos, seleccioneLos clientes pueden editar.
- BajoClientes, ingreseUbicacióncomo elTítulo mostrado a los clientes.
- Haga clic enGuardar.
Si su cuenta usa un solo formulario de ticket, el campo nuevo aparece automáticamente en el formulario de ticket. Para eliminar el campo, consulteEditar formularios de ticket.
Tarea 4: Crear una respuesta usando el generador de flujos
Esta sección le guía a través de la creación de la respuesta, la definición de su intención y la adición de pasos para la respuesta en el generador de flujos. A continuación se describe el proceso paso a paso.
- Paso 1: Crear la respuesta
- Paso 2: Definir la intención de la respuesta
- Paso 3: Agregar un paso de mensaje inicial
- Paso 4: Solicitar una ubicación al usuario final
- Paso 5: Obtener información meteorológica para la ubicación
- Paso 6: Enviar un mensaje sobre el tiempo al usuario final
- Paso 7: Agregar un mensaje de falla
- Paso 8: Publicar el bot actualizado
Paso 1: Crear la respuesta
Use el generador de flujos para crear una respuesta para su bot de mensajería.
- En elCentro de administracion, haga clic en
Canalesen la barra lateral y luego seleccioneBots y automatización > Bots. - Pase el cursor por encima del bot con el cual desea trabajar y haga clic enEditar.
- Haga clic enCrear respuesta.
Paso 2: Definir la intención de la respuesta
Defina la intención de la respuesta y las frases de capacitación. Aquí se incluyen frases y palabras que se usan para gatillar la respuesta en una conversación.
- En la pestaña Respuestas de la página de edición del bot, haga clic enCrear respuesta.
- IngreseObtener tiempocomo laIntenciónde la respuesta.
- BajoFrases de capacitación, ingreseObtener pronóstico del tiempoyObtener temperatura actual.
- Haga clic enSiguiente.
拉respuesta se abre en el generador de flujos donde puede crear la respuesta del bot.
Paso 3: Agregar un paso de mensaje inicial
Agregue un pasoEnviar mensajepara solicitar al usuario final la ubicación que le interesa. Este es el primer paso en el flujo de respuesta.
- En el generador de flujos, haga clic enAgregar paso.
- BajoElegir paso, seleccioneEnviar mensaje.
- EnMensaje de bot, ingrese el siguiente texto:
What location would you like to get the weather for? Include the country code. For example: "Melbourne, AU" or "San Francisco, US"
Paso 4: Solicitar una ubicación al usuario final
Después del mensaje inicial, agregue un pasoSolicitar detallespara presentar un formulario básico al usuario final. El formulario incluye un cuadro de texto para el valor del campo de ticketUbicación.
- En el generador de flujos, haga clic en el iconoAgregar paso(
). - BajoElegir paso, seleccioneSolicitar detalles.
- IngreseObtener ubicacióncomo elNombre.
- EnCampos, escriba y seleccione el campo de ticketUbicación.
Paso 5: Obtener información meteorológica para la ubicación
Agregue un pasoHacer llamada de APIpara obtener la información meteorológica del extremoCurrent weather datade la API de OpenWeather.
- En el generador de flujos, haga clic enAgregar paso.
- BajoElegir paso, seleccioneHacer llamada de API.
- IngreseObtener tiempocomo elNombrede la respuesta.
- BajoDetalles de la API,ingrese
https://api.openweathermap.org/data/2.5/weather?units=metric&q=como elURL de extremo. - 使用el iconoAgregar una variable(
) para adjuntar la variable del campoUbicaciónal valor deURL de extremo.El valor terminado deURL de extremose debería ver así:
- EnAutenticación, seleccione la conexiónopenweather_api.
- Para probar la solicitud de API, haga clic enHacer llamada de API.
- BajoDatos de prueba, ingreseMelbourne, AUcomo laUbicación.
- Haga clic enHacer llamada de API
- Guarde las siguientes variables usando sus nombres predeterminados:
- main>temp
- weather>item 1>description
Paso 6: Enviar un mensaje sobre el tiempo al usuario final
Después de obtener la información meteorológica, use un pasoEnviar mensajepara enviársela al cliente.
- En el generador de flujos, haga clic enAgregar pasobajo la rama拉llamada a la API se realizó correctamentedel pasoObtener tiempo.
- BajoElegir paso, seleccioneEnviar mensaje.
- EnMensaje de bot, ingrese el siguiente texto:
It's {{temp}}° C with {{description}} in - 使用el iconoAgregar una variable() para adjuntar la variable del campoUbicaciónal valor deMensaje de bot. Luego agregue un punto (.).
El valor terminado deMensaje de botse debería ver así:
Paso 7: Agregar un mensaje de falla
拉solicitud hecha durante el pasoHacer llamada de APIpuede fallar si, por ejemplo, la solicitud incluye una ubicación que no existe. Agregue un pasoEnviar mensajea la ramaError de llamada de API. Este paso devuelve un mensaje en caso de que la llamada de API de OpenWeather llegue a fallar.
- En el generador de flujos, haga clic enAgregar pasobajo la ramaError de llamada de APIdel pasoObtener tiempo.
- BajoElegir paso, seleccioneEnviar mensaje.
- En Mensaje de bot, ingrese el siguiente texto:
I'm sorry. I wasn't able to get weather data for - 使用el iconoAgregar una variable() para adjuntar la variable del campoUbicaciónal valor deMensaje de bot. Luego agregue un punto (.).
El valor terminado deMensaje de botse debería ver así:
Paso 8: Publicar el bot actualizado
Para hacer push de la respuesta en vivo, publique el bot actualizado.
- Haga clic enTerminadoen la esquina superior derecha del generador de flujos.
- En la página del bot, haga clic enPublicar bot.
- Haga clic enPublicar.
Tarea 5: Probar los cambios
Después de publicar los cambios, puede probar la nueva respuesta haciendo la pregunta “¿Cómo está el tiempo?” en una conversación con el bot actualizado. Si desea más información sobre cómo probar los bots de mensajería, consultePruebas de la experiencia de mensajería del usuario final.
0 Comentarios
Inicie sesiónpara dejar un comentario.