Integra el enfoque aéreo con los Webhooks

Beneficios de usar webhooks

Los webhooks permiten que Airfocus y otras aplicaciones trabajen juntas fácilmente y en tiempo real. Esto significa que las actualizaciones y notificaciones ocurren rápidamente sin necesidad de aplicaciones adicionales ni codificación complicada.

Configuración inicial de un nuevo webhook

Crea un nuevo espacio de trabajo en Airfocus, o selecciona el que te gustaría para crear un nuevo webhook.

Requisitos:

• Licencias "completas" al espacio de trabajo donde quieres configurar el webhook.
• Subscripción pagada a un plan profesional o corporativo.
• Conocimientos técnicos para una correcta configuración.

Puedes agregar varios webhooks a un espacio de trabajo dado (por ejemplo, a diferentes canales de Slack para distintas audiencias de stakeholders).

Para ello, simplemente ve a la sección de Extensiones dentro de tu espacio de trabajo, haz clic en "Agregar integración" y "Conectar" bajo Webhook.

A continuación, ponle un nombre a tu webhook (opcional) y selecciona para qué eventos deben activar las solicitudes.

En las opciones de solicitud, elige el formato marcador y el método y pega la URL de tu webhook en el campo de la URL. También puedes agregar cabeceras a tus peticiones si es necesario.

Opcionalmente, también puedes configurar el cuerpo de tu solicitud en el formato marcador elegido arriba.

{
 "bloqueos": [
   {
     "type": "divider"
   },
   {
     "tipo": "sección",
     "texto": {
       "tipo": "mrkdwn",
       "texto": "{{title|esc}}"
     },
     "accesorio": {
       "tipo": "botón",
       "texto": {
         "type": "plain_text",
         "text": "Open in airfocus",
         "emoji": true
       },
       "valor": "click_me_123",
       "URL": "{{url}}",
       "action_id": "acción de botón"
     }
   },
   {
     "tipo": "sección",
     "texto": {
       "tipo": "mrkdwn",
       "texto": "{{details|esc}}"
     }
   }
 ]
}

Para una documentación detallada de las opciones de personalización de tus webhooks, por favor lee la siguiente sección.

Caso de uso: recibir notificaciones de Slack para actualizaciones de Airfocus

Para este caso de uso, nuestro objetivo es configurar un webhook que envíe un mensaje de Slack a un canal de nuestra elección cada vez que un elemento del espacio de trabajo para el que configuramos el webhook se actualice en estado.

Para ello, necesitamos configurar una app de Slack para generar una URL de webhook y luego configurar el resto de la integración en Airfocus.

Cómo crear una URL de webhook para tu canal de Slack:

1. Crea una nueva aplicación de Slack en el espacio de trabajo de Slack donde quieras recibir las notificaciones de AirFocus.
   
   
2. Desde la página Características, active la opción Activar webhooks entrantes .
   
3. Haga clic en Agregar nuevo webhook al espacio de trabajo.
   
4. Elige un canal al que la app publique y luego haz clic en Permitir.
   
5. Copia la URL del webhook y abre el espacio de trabajo de Airfocus para el que quieres configurar las actualizaciones.
   

Cómo configurar su webhook en Airfocus para enviar notificaciones de actualización de eventos a Slack:

1. En el popover de extensiones, haz clic en "Agregar integración".
   
2. En la visión general de integración, haz clic en "Conectar" debajo de la integración "Webhooks".
   
3. Ponle un nombre a tu webhook (opcional) y selecciona para qué eventos deben activar las solicitudes. → "Estado actualizado" para este caso de uso.
   
4. En las opciones de solicitud, selecciona "Slack markdown" como formato marcador y "POST" como método. Ahora pega la URL del webhook que copiaste de Slack en el campo URL.
   
5. Para recibir mensajes de Slack correctamente formateados, pega la siguiente Plantilla en el campo del cuerpo y pulsa actualizar.

   •  

     {
      "bloqueos": [
        {
          "type": "divider"
        },
        {
          "tipo": "sección",
          "texto": {
            "tipo": "mrkdwn",
            "texto": "{{title|esc}}"
          },
          "accesorio": {
            "tipo": "botón",
            "texto": {
              "type": "plain_text",
              "text": "Open in airfocus",
              "emoji": true
            },
            "valor": "click_me_123",
            "URL": "{{url}}",
            "action_id": "acción de botón"
          }
        },
        {
          "tipo": "sección",
          "texto": {
            "tipo": "mrkdwn",
            "texto": "{{details|esc}}"
          }
        }
      ]
     }

      

6. Ahora recibirás un mensaje de Slack en el canal que elegiste cuando cualquier elemento en el espacio de trabajo tenga su estado cambiado.
   

Recibe airfocus actualizaciones en Microsoft Teams

La función Microsoft Teams Flujos de Trabajo te permite configurar un gancho sitio web que envía un mensaje de Teams a un canal designado cuando se actualizan elementos dentro de un espacio de trabajo airfocus concreto. Para ello, necesitarás generar una URL de webhook en Microsoft Teams y luego configurar el resto de la integración en airfocus.

Crea una URL de webhook en Microsoft Teams

Para generar una URL de webhook en Microsoft Teams, sigue estos pasos:

1. Inicia sesión en Microsoft Teams.
2. Haz clic en el menú de tres puntos en el menú de navegación en el extremo izquierdo.
3. Selecciona flujos de trabajo.
4. En la barra de búsqueda, busca "webhook".
5. Selecciona Publicar en un canal cuando se reciba una solicitud de webhook.
6. Escribe un nombre para tu flujo de trabajo (por ejemplo, "airfocus actualizaciones").
7. Haz clic en Siguiente.
8. En "Detalles", selecciona el equipo y canal específicos donde quieres que aparezcan las actualizaciones.
9. Haz clic en Agregar flujo de trabajo.
10. En la pantalla de confirmación, copia la URL de POST.
    • Esta es la URL del webhook que tendrás que pegar en airfocus.
11. Haz clic en Listo para finalizar la configuración.

Configura tu webhook en airfocus

Para configurar tu webhook en airfocus, sigue estos pasos:

1. Abre el espacio de trabajo airfocus para el que quieres enviar actualizaciones a Microsoft Teams.
2. Haz clic en Extensiones desde la esquina superior derecha del espacio de trabajo.
3. Selecciona Agregar integración.
4. En "Webhooks", haz clic en Conectar.
5. Escribe un nombre para el webhook.
6. En "Eventos", selecciona qué tipo de actualizaciones quieres que se envíen a Microsoft Teams.
7. En "Formato marcador", selecciona Markdown.
8. En "Método", selecciona POST y luego pega la URL que generaste en Microsoft Teams bajo "URL".
9. Seleccionar + Agregar encabezado.
10. En "Nombre del encabezado", escribe "Content-Type".
11. En "Valor de cabecera", escribe "aplicación/json".
    
12. Para recibir mensajes de Microsoft Teams correctamente formateados, pega la siguiente Plantilla en el campo del cuerpo.

    • {
        "tipo": "AdaptiveCard",
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "versión": "1.4",
        "cuerpo": [
          {
            "type": "TextBlock",
            "texto": "{{title}}",
            "tamaño": "Mediano",
            "peso": "Más audaz",
            "wrap": Cierto
          },
          {
            "type": "TextBlock",
            "texto": "{{details}}",
            "wrap": Cierto
          }
        ],
        "acciones": [
          {
            "type": "Action.OpenUrl",
            "título": "Abierto en airfocus",
            "URL": "{{url}}"
          }
        ]
      }

13. Haz clic en Actualizar desde la parte inferior derecha de la página.

Ahora recibirás actualizaciones en el canal de Microsoft Teams que configuraste en la primera sección.
 

Configuración de la solicitud HTTP - documentación técnica

Método

Por defecto está configurado como POST, pero también se puede cambiar a GET o PUT. No se admiten otros métodos.

URL

• no debe estar vacío
• solo puede empezar con https:// (no se admiten otros esquemas o esquemas vacíos)
• debe tener un nombre de dominio público con un dominio de nivel superior bien conocido (no se admiten IPs)

Encabezados

• Se admite la autorización
• Se admite el tipo de contenido
• se admiten cabeceras personalizadas que Empezar con x-
• No se admiten otros encabezados

Texto

Define el cuerpo de la solicitud del webhook.

Puede contener cualquier texto de hasta 2000 caracteres.

Para completar el cuerpo de la solicitud con datos significativos de eventos, proporcionamos un conjunto de marcadores de posición que nuestro servidor reemplaza por datos de eventos antes de enviar la solicitud.

Formato provisional

Especifica cómo los marcadores de posición con tipo RichText deben ser prerenderizados por nuestro servidor. Por ejemplo {{title}} , el marcador de posición puede contener una cadena como "John updated field Labels on item Fix the botón" que contiene cierto formato de texto enriquecido como negrilla, cursiva, etc., y por lo tanto el formato de marcador especifica en qué sintaxis específica debe transformar este formato. Formatos disponibles:

Placeholders

Data modelo

Modelo de carga útil de eventos

Un objeto de nivel superior, producido para cada evento. Contiene datos sobre el evento, así como datos básicos incrustados sobre todas las entidades relacionadas con este evento.

Modelo de evento

Datos básicos sobre el evento

Modelo EventInitiator

Información sobre quién inició este evento. En la mayoría de los casos, el userId estará definido. También es posible que haya tanto userId como integrationId definidos, por ejemplo, si un usuario pulsaba el botón "sincronizar integración" que producía el evento.

Modelo EventEmbed

Datos adicionales sobre el evento: principalmente nombres de elementos/espacios de trabajo/campos/etc., que están relacionados con este evento.

TeamInfo modelo

Modelo UserInfo

Modelo AppInfo

Modelo WorkspaceInfo

Modelo IntegrationInfo

StatusInfo modelo

ItemInfo modelo

Modelo EventData

EventData es un tipo de unión: puede cualquiera de los tipos especificados:

CreatedItem

Punto actualizado

Dejar comentarios sobre este artículo