¿Conoce la función de webhooks y los quiere usar con su equipo? A continuación, mostramos cómo funciona en el Chat. Sepa que esta sección requiere un entendimiento básico de webhooks y programación.
Importante: Tendrá que estar conectado a Wi-Fi para usar webhooks.
Términos usados en esta sección
webhook
Un webhook es un evento que activa alguna función.
servicio o proveedor de webhook
Un servicio webhook es una aplicación por la web para recuperar y almacenar datos de algún evento en particular.
evento webhook
Un evento webhook es una solicitud por la web a través de un enlace URL que tiene información adicional para el servicio o proveedor webhook.
Un evento webhook consiste en dos partes: (1) el URL y (2) la carga útil en formato JSON. El evento es la pieza que envía el programa Chat.
Ejemplo de evento: Crear un documento
URL
Un URL es una dirección de Internet. Para los webhooks, el URL es la dirección que activará un evento. Webhooks usa el protocolo http para comunicarse con el servicio o proveedor de webhook.
carga útil
Puede enviar instrucciones adicionales con el URL para llevar a cabo el evento. Le llamamos a estas instrucciones adicionales la carga útil.
Nota: No todo evento necesita una carga útil.
Ejemplos de carga útil: Añadir contenido a su documento (vea “evento webhook” arriba); formatear el contenido
El servicio o proveedor de webhook define la carga útil. Así se ve una porción de una carga útil al integrarse a un servicio de webhook:
{
"event_id": "LtWXD3crgy",
"event_type": "form_response",
"form_response": {
"form_id": "lT4Z3j",
"token": "a3a12ec67a1365927098a606107fac15",
"submitted_at": "2018-01-18T18:17:02Z",
JSON
Los Webhooks integran respuestas (cargas útiles) en formato JSON, un idioma que usan los programadores. El programa Chat tiene un interfaz para estas respuestas. El ejemplo bajo “carga útil” arriba está en formato JSON.
marcador
Con el fin de simplificar la creación de cargas útiles, el programa Chat ofrece dos marcadores: (1) el contenido de la Barra de visualización de habla y (2) el mensaje del botón (en el cuadro de Mensaje, no de Etiqueta).
Los marcadores deben estar en estos formatos: ${SDB} y ${MESSAGE}
Los marcadores no son requeridos. Puede usar uno de los dos, ambos o ninguno.
Añadiendo un evento webhook
Puede crear todos los botones webhook que desee, pero solo puede enlazar un URL a cada botón.
Ejemplos de eventos webhook: enviar el último informe del tiempo a su equipo; hacer un pago; enviar una alerta cuando algo ocurra; encender una luz; abrir una puerta; ajustar el termostato; operar un equipo doméstico inteligente.
Nota: Puede simplificar el proceso de programación de webhooks usando el ChatEditor, especialmente copiando y pegando los URLs e ingresando datos en formato JSON.
Seleccione Menú > Modo de edición.
Toque y sostenga el botón al cual desea añadir el evento webhook.
Seleccione Editar botón.
Añada una etiqueta y/o un mensaje e imagen (idioma estándar).
Seleccione Funciones.
Toque la flecha de lista para abrir la lista de funciones.
Seleccione Webhook. Aparecerá un teclado con un cuadro para añadir el URL.
Ingrese el URL. Puede copiar esto desde el servicio o proveedor de webhook.
Si el evento requiere una carga útil, toque bajo JSON e ingrese la información que desea enviar desde el botón en formato JSON.
Nota: El programa Chat ofrece dos marcadores: (1) el contenido de la Barra de visualización de habla y (2) el mensaje [en el cuadro de mensaje] en el botón. Los marcadores deben aparecer en este formato: ${SDB} and ${MESSAGE}.
Toque Grabar.
Asegúrese de tener una conexión Wi-Fi y seleccione el botón que creó.