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 …

Google Analytics en webcaStudio

Carles Galan API @es, Stats @es Deja un comentario

Este post explica como usar Google Analytics para controlar un evento en webcaStudio Requerimientos Acceso aun workspace de webcaStudio como usuario SuperAdministrador Una cuenta de Google Analytics Paso 1: Crear una cuenta de Google Analytics Para empezar a seguir la audiencia de tus eventos en webcaStudio con Google Analytics lo primero que necesitarás es crear una cuenta en Google Analytics Para ello entra en el Panel de control de Google Analytics  (https://www.google.com/analytics/) accede a la sección Admin, abre el desplegable Account y selecciona  “Create new account”. El dato importante en esta página es el Website URL, Su valor debe ser tu dominio de webcaStudio, por ejemplo: tuempresa.webcasting-studio.net. Igualmente es importante elegir adecuadamente el protocolo http o https. Ya que la consola de  webcaStudio te proporcionará direcciones seguras por defecto escoge https: como Website URL protocol. En caso que prefieras hacerlo con http: recuerda mas tarde utilizar una URL http: para dar acceso a tu evento. Haz click en el boton “Get Tracking Id” y acepta los terminos de uso. Al final la pagina que aparece te mostrará tu nuevo “Tracking ID” Copialo ya que lo necesitarás a continuación. Paso 2: Creaun nuevo Track-ID para tu workspace en webcaStudio Una vez tienes el tracking Id debes asociarlo a tu workspace en primer lugar Logate a la consola de webcaStudio y abre el apartado “Settings”. A la izquierda selecciona “Wokspace Settings” y luego “Google Analytics”. Asocia un nombre a tu Track ID y dalo de alta en tu Workspace. Si indicas que es el Track-Id por defecto, este será asociado automáticamente a tus nuevos eventos Paso 3: Asocia un Track-ID con un Evento Google Analytic no seguirá a tu audiencia hasta que no asocies un Track-Id con un evento Accede a la información estática de tu evento mediante “Edit”, selecciona el apartado “Integration” selecciona “Google Analytics”. Selecciona un “Track-Id” de la lista desplegable y pulsa “Save” Si hubieras definido un Track Id por defecto en el paso 2 este ya aparecería ahora. Puedes borrarlo y sustituirlo por otro si así lo deseas. Ahora tu evento será seguido por Google Analytics. NOTA: Configurar Google Analytics no deshabilita el sistema interno de registro de usuarios de webcaStudio. Dejar de seguir un evento con Google Analytics Si ya no quieres que Google Analytics siga tu audiencia, puedes eliminar la asociación del evento con el Track-Id seleccionando la opción “None” en la pestaña mencionada anteriormente

Configurar una campaña de MailChimp en webcaStudio

Carles Galan API @es, SSO @es Deja un comentario

Este tutorial explica como crear una campaña en MailChimp para poder invitar a tus contactos a un webinar producido con webcaStudio de manera que los datos de los subscriptores se pasen automáticamente a webcaStudio. Requisitos Vamos a suponer que ya se tienen cierta experiencia utilizando tanto MailChimp como webcaStudio. Cuenta en webcaStudio con permisos Super. Una PSK creada en el Workspace. Paso 1. Añadir API Key de MailChimp al workspace de webcaStudio. Lo primero que deberemos hacer es configurar tu workspace para poder acceder a los datos de tu cuenta de MailChimp. Accede a tu dashboard de MailChimp Haz click en Account > Extras > API keys Crea una API Key Copia el valor generado Accede a tu workspace de webcaStudio Ir a Settings > MailChimp API Keys Escribir un nombre para identificar la cuenta de MailChimp Pegar la API Key generada anteriormente y presionar el botón Add Puedes crear tantas API Keys como desees y así utilizar diferentes cuentas de MailChimp con el mismo workspace. Paso 2. Crear una lista en MailChimp WebcaStudio extraerá la información del usuario de una lista. En webcaStudio, el objeto User tiene 4 campos: Email, Nombre, Apellidos y Organización. Por consiguiente, tu lista de MailCHimp deberá tener al menos estos cuatro campos (no necesariamente con estas etiquetas). Si quieres utilizar lista ya existente, ves directamente al paso 4. Accede a tu cuenta de MailChimp Ves a Lists > Create List Rellena la información básica Haz click en Settings > List fields Asegúrate de que tu lista tiene al menos 4 campos. Típicamente serán: Email, Nombre, Apellidos y organización o compañía. Añade o importa subscriptores Paso 3. Configurar MailChimp en tu evento Accede a la página de edición del Evento Ves a la pestaña Integration Despliega el panel de MailChimp Selecciona una de tus API Keys de MailChimp Rellena el formulario de mapeo de acuerdo con los campos que has configurado en la lista de MailChimp. Por ejemplo, si tu lista contiene el campo Compañía en vez de Organización, cambia la etiqueta ORG por COMPANY Guarda los cambios Step 3. Crea una campaña de MailChimp Ves a tu dashboard de MailChimp Haz click en Campaigns > Create Campaign Selecciona un tipo Selecciona una lista o segmento Rellena la información básica Escoge una plantilla de email En la vista Design, arrastra un elemento de tipo Botón Deja la opción “Web address” seleccionada Pega como URL del botón una de las generadas en el panel de integración de …

Secure Single Sign-On Developer Guide

Frank Carmona Sin categorizar, SSO @es

INTRODUCCION Este documento explica el funcionamiento de la Aplicación de Single-Sign-On (SSO) para acceso a los contenidos de la plataforma webcaStudio A efectos de comprensión de este documento: Master Account: o Cuenta Master, Empresa que tiene una sbscripción activa en webcaStudio Workspace o Espacio de trabajo: Espacio de trabajo independiente para cada una de los clientes finales que pueda tener un subscriptor de webcaStudio webcaStudio: Plataforma mediante la cual una organización puede organizar y publicar presentaciones, en formato “Rich-Media webcast” en directo o bajo demanda, dirigidos a un elevado número de usuarios finales que de este modo pueden acceder y participar en una presentación profesional de alta calidad on-line. Aplicación de SSO Segura: Dado que en muchas ocasiones los contenidos producidos por el Cliente y servidos por la plataforma son confidenciales y /o tienen un alto valor económico, o simplemente para evitar al usuario la necesidad de logarse dos veces, Vancast propone un sistema de Single Sign On  Seguro” para que nuestros Clientes puedan integrar el acceso y datos de los usuarios finales de “Plataformas Internas de Cliente”  con  webcaStudio Plataforma Interna de Cliente: Se refiere a el portal interno, intranet, portal de empleado, plataforma de e-learning, aplicación de gestión de inscripciones on-line a congresos, etc., que ya tiene el Cliente y que incluye las prestaciones de autenticación de usuarios y las de gestión de los permisos de acceso a unos u otros contenidos   La Aplicación SSO segura es el sistema ideal para organizaciones que quieran facilitar el acceso conveniente y seguro a contenidos, en directo o bajo demanda, producidos en webcaStudio  a partir de un portal interno, intranet o plataforma de e-learning. También es conveniente este sistema para organizaciones que comercialicen conferencias on-line de pago y ya dispongan de plataforma de inscripción y gestión del pago on-line. El sistema se basa en las siguientes premisas: Autenticación delegada: La autenticación del usuario la realiza el sistema del cliente, es decir la intranet, plataforma de e-learning o sistema de acceso a conferencias on-line. SSO (Single Sign On): El usuario una vez se ha identificado y ha sido aceptado por el sistema de origen ya no deberá volver a identificarse en la plataforma webcaStudio Acceso Seguro: La plataforma webcaStudio  debe  validar el correcto acceso del usuario desde la plataforma del cliente y garantizar que de ningún modo un usuario no autorizado pueda acceder a los contenidos servidos por la plataforma.   IMPLEMENTACION La solución técnica, …