Webhooks en Zapier

Información general

En esta guía, creará un evento Webhook para un equipo en Frame.io y lo usará para enviar una carga útil a Zapier. En este escenario, Zapier actúa como mediador: puede “capturar” el enlace (hook) de Frame.io y luego usar los datos de ese enlace para interactuar con otros sistemas.

En muchos casos, la integración de Zapier de Frame.io admite “Triggers” (activadores) nativos que recuperarán datos de Frame.io sin administración manual de webhooks (por ejemplo, cuando se crea un activo). En esta guía, nos centraremos en un flujo de trabajo que actualmente no es compatible con un activador nativo al reaccionar cuando se crea un proyecto nuevo en Frame.io.

Primero, configuraremos un webhook para activar una notificación cuando se cree un proyecto nuevo en un equipo en Frame.io. Luego, usaremos la aplicación Zapier de Frame.io para capturar la notificación y transmitir información sobre el proyecto a una Google Sheet.

Necesitará lo siguiente

Antes de comenzar, necesitará tres cosas:

1. Acceso a una cuenta de Frame.io (para que pueda crear un token)
2. Acceso de responsable de equipo o administrador a un equipo en Frame.io (para que pueda crear un webhook)
3. Una cuenta de Zapier

Para verificar las primeras dos, vaya a developer.frame.io e inicie sesión. Si no ve los elementos del menú “Tokens” y “Webhooks” (que se muestran a continuación), póngase en contacto con su representante de cuentas de Frame.io. <img alt=“Herramientas en el sitio para desarrolladores de Frame.io” src=“file:docs/pages/v2/images/Screen_Shot_2021-03-02_at_7.46.59_AM.png”>

Paso 1: Crear un token de API

Para completar esta guía, necesitará un token de API cuyo ámbito coincida con el ámbito del webhook que enviaremos. Si ya tiene un token conectado a Zapier que incluye el ámbito que se muestra a continuación, puede usarlo. De lo contrario:

Asigne a su token nuevo un nombre descriptivo y seleccione el siguiente ámbito:

• Proyectos: Lectura

Paso 2: Crear un webhook en Zapier

En Zapier: Elija la aplicación de activador “Webhooks by Zapier” y seleccione “Catch Hook” como la acción de activador deseada. <img alt=“Selección de activador en Zapier” src=“file:docs/pages/v2/images/6fb7899-webhook_catch.png”> Después de guardar la selección, omita el siguiente paso opcional y debería ver una pantalla con una URL que comienza con https://hooks.zapier.com/... <img alt=“Introducir URL en Zapier” src=“file:docs/pages/v2/images/061fcf9-the-hook.png”> En esta pantalla:

1. Copie esta URL
2. Deje Zapier abierto
3. Vuelva a Frame.io Developer en una pestaña o ventana independiente.

Paso 3: Configurar el evento Webhook en Frame.io

En Frame.io Developer: Vaya a Webhooks y cree un webhook nuevo con:

1. Un nombre descriptivo.
2. La URL que copió en el paso anterior.
3. El equipo en el que le gustaría que funcionara este hook.
4. El evento de Frame.io que le gustaría asociar con el hook (para esta guía: Proyectos -> Creado).

<img alt=“Webhook nuevo” src=“file:docs/pages/v2/images/00b11e1-project-hook.png”> Guarde su webhook nuevo con el botón Create y vuelva a Zapier.

Paso 4: Enviar un hook de prueba

Repasemos, ahora tenemos:

1. Una configuración de webhook en Frame.io que se activará cuando crea un proyecto en un equipo específico.
2. Un activador de webhook en Zapier que está esperando un proyecto nuevo de Frame.io.

Ahora enviaremos realmente nuestros datos a Zapier mediante la creación de un proyecto.

a) En Zapier: Prepararse para capturar el webhook

En la pantalla que aún tiene del paso 2, haga clic en “Ok, I did this”. Esto preparará Zapier para recibir un evento en la URL especificada. <img alt=“webhook” src=“file:docs/pages/v2/images/f8d5933-catch-hook.png”>

b) En Frame.io: Crear un proyecto nuevo

En el equipo configurado, cree un proyecto nuevo: asígnele la configuración que desee.

Esto hará que se envíe un webhook, que luego Zapier recibirá. Como respuesta, debería ver un acuse de recibo de un hook nuevo en Zapier y, si lo expande, debería ver la carga útil completa del webhook de Frame.io.

Enhorabuena. Haga clic en Continuar y celebre su logro. Ahora que hemos terminado la parte difícil, podemos usar nuestro webhook para hacer cosas.

Paso 5: Obtener su proyecto

a) Añadir la acción de Frame.io

Haga clic en ”+ Add a Step” y busque Frame.io. Una vez que haya seleccionado la aplicación Frame.io, elija la acción Find Project. Ahora haga clic en “Save + Continue”.

b) Conectar su cuenta de Frame.io

En la siguiente pantalla, haga clic en “Connect an Account” y, en la ventana emergente siguiente, introduzca su token de API de Frame.io (que generó en el paso 1). Si ha olvidado o perdido su token, no se preocupe: solo tiene que crear uno nuevo en Account Settings. Asegúrese de elegir el ámbito “Proyecto: Lectura”. Haga clic en “Continue”.

c) Recuperar su proyecto

En la siguiente pantalla, haga clic en la flecha del extremo derecho del campo Project, en la parte inferior de la lista, y seleccione Use a Custom Value. A continuación, en el campo “Custom Value for Comment ID” nuevo que aparece, haga clic en el icono de la derecha y elija el Resource ID en el menú desplegable que aparece. <img alt=“Recuperar proyecto” src=“file:docs/pages/v2/images/eb0efbd-project-values.png”>

Ahora haga clic en “Continue”. Una vez que Zapier verifique que tiene el ID del proyecto en la siguiente pantalla, haga clic en “Fetch + Continue” y, una vez que se complete la búsqueda, debería ver una pantalla como la siguiente: <img alt=“Recuperación finalizada” src=“file:docs/pages/v2/images/0fe89ec-test-success.png”>

Excelente trabajo. Ahora tiene toda la información sobre su proyecto nuevo en Zapier y puede transmitirla a cualquier sistema diferente, incluidos:

• Google Sheets
• Airtable
• Asana
• Trello
• Jira

… y casi 3000 más.

Una vez que haya creado el resto de su Zap, simplemente actívelo. Eso es todo.