Webhooks entrantes

Con la versión de almacenamiento en la nube de Linked Helper, es posible añadir perfiles a una campaña mediante un webhook entrante.

• Creación de un webhook
• Envío de datos al webhook
  • Esquema del payload y ejemplos
• Eliminación de un webhook

Creación de un webhook

Nota: los webhooks entrantes solo están disponibles para usuarios de la versión de almacenamiento en la nube de Linked Helper.

• Abra una campaña y vaya a la pestaña Workflow
• Haga clic en el icono Webhook junto al botón Add
  
• Asígnele un nombre y haga clic en el botón Add webhook
  
• Una vez creado el webhook, puede:
  • activar el modo Stand by, que le permite mantener la campaña lista para reanudarse cuando se reciban nuevos perfiles; de lo contrario, tendrá que iniciarla manualmente cuando se hayan añadido perfiles;
  • copiar la URL del webhook y añadirla a su otra herramienta:
    
  •  Añadir otro webhook para recibir perfiles de diferentes fuentes:
    

Envío de datos al webhook

Esquema del payload y ejemplos

El webhook puede recibir solicitudes POST con los datos del payload en el cuerpo de la petición:

• obligatorio: URLs de LinkedIn o Sales Navigator
• opcional: campos personalizados

Es posible enviar varias URLs en una sola petición, cada una con varios campos personalizados (o ninguno).

Esquema del payload:

{
  "type": "object",
  "required": ["people"],
  "properties": {
    "people": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "required": ["externalId"],
        "properties": {
          "externalId": {
            "type": "string",
            "minLength": 1,
            "format": "uri",
            "description": "LI/SN profile URL. Backend extracts person external id from the link."
          },
          "customFields": {
            "type": "array",
            "minItems": 1,
            "items": {
              "type": "object",
              "required": ["key", "value"],
              "properties": {
                "key": {
                  "type": "string",
                  "minLength": 4,
                  "pattern": "^cs_.+"
                },
                "value": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            },
            "description": "Optional per-person custom fields."
          }
        },
        "additionalProperties": false
      },
      "description": "List of people to add to campaign."
    }
  },
  "additionalProperties": false
}

Ejemplo de payload con variables personalizadas:

{
  "people": [
    {
      "externalId": "https://www.linkedin.com/in/jane-doe-123456789/",
      "customFields": [
        {
          "key": "cs_source",
          "value": "webhook"
        }
      ]
    },
    {
      "externalId": "https://www.linkedin.com/sales/lead/ACwAAAZXyZABcD1234567890abcdef,NAME_SEARCH,abcd1234",
      "customFields": [
        {
          "key": "cs_source",
          "value": "manual-import"
        },
        {
          "key": "cs_segment",
          "value": "enterprise"
        }
      ]
    }
  ]
}

Ejemplo de payload sin variables personalizadas:

{
  "people": [
    {
      "externalId": "https://www.linkedin.com/in/jane-doe-123456789/",
      "customFields": []
    },
    {
      "externalId": "https://www.linkedin.com/sales/lead/ACwAAAZXyZABcD1234567890abcdef,NAME_SEARCH,abcd1234",
      "customFields": []
    }
  ]
}

Eliminación de un webhook

• Abra una campaña y vaya a la pestaña Workflow
• Haga clic en el icono Webhook junto al botón Add
  
• Haga clic en el botón Bin en la fila del webhook que desea eliminar y confirme la acción: