Guía de desarrollador para Webhooks

Carles Galan API @es, Webhooks @es

Introducción Los Webhooks te permiten obtener información sobre eventos que suceden en la plataforma a medida que suceden. Configura una URL, selecciona cuando quieres recibir información sobre un evento de tu workspace y te enviaremos notificaciones cuando la acción tenga lugar. Para más información a cerca de Webhooks, lea PBWiki Webhooks page. Puedes probar nuestros Webhooks sin tener que escribir scripts mediante la herramienta RequestBin tool. Es una utilidad excelente que te permitirá ver la información que se envía con cada notificación. Como configurar los Webhooks Puedes configurar los Webhooks en la consola de tus Worskpaces. Puedes crear webhooks a dos niveles: A nivel de Workspace y a nivel de Evento. Como crear un webhook a nivel de Workspace Los Webhooks a nivel de workspace consisten en una colección de eventos que se disparan cuando ciertas acciones se realizan en en un Workspace. Entra en la consola de tu Workspace Ves a Settings Haz click en el apartado Worskpace del menú lateral para desplegar las opciones Haz click en Webhooks Haz click en el botón “Añadir Webhook” Como crear un webhook a nivel de Evento Los Webhooks a nivel de evento, al contrario que los de Workspace, disparan notificaciones cuando se realiza una acción en un determinado Evento Entra en la consola de tu Workspace Crea un nuevo evento o edita un evento ya existente Abre la pestaña Integración Despliega el apartado Webhooks Haz click en “Añadir Webhook” Mapping La prestación de Mapping te permite indicar qué nombres de variables quieres que te lleguen a tu servicio. Esto es útil cuando utilizas un servicio genérico para diferentes propósitos. Webhooks types Webcastuidio enviará un objecto que representa la entidad que ha sido afectada por la acción que ha disparado el Webhook. Estos son los posibles typos de objecto que pueden ser enviados: Event-type Describe la entidad Evento Property Type Description event_id Number Event ID account_id Number Workspace ID event_name String Título del Evento event_description String Descripción del Evento event_status String Category de estado. Valores possibles: “live_pending” (representado con el color verde en la consola), “od_pending” (azul), “od_publisehd” (naranja). event_start_date String Fecha de inicio del Evento.  event_finish_date String Fecha de fin del Evento. event_languages Array of Objects Lista de los idiomas disponibles para este evento   id Number Language ID   name String Nombre corto del idioma (e.g. ‘es’, ‘ca’)   label String Nombre largo del idioma (e.g. ‘Español’, ‘Català’) Session-type Describe la entidad Session. Una Session representa una sesión de …