Webhook por ejemplo

Visión general

Esta opción está disponible para los usuarios de Turbo y Cloud que ejecutan Dux-Soup Expert UI.

Con los Webhooks de Dux-Soup ahora puedes recibir detalles de varios eventos que ocurren en Dux-Soup mientras utilizas las visitas automatizadas o manuales a perfiles y las funciones de escaneo. Además de los detalles de los perfiles, los webhooks recibirán los detalles de las acciones automatizadas, y sus resultados, a medida que se ejecuten. Puede añadir hasta 5 webhooks, lo que le permite enviar diferentes eventos a diferentes objetivos.

Los Webhooks pueden activarse en Opciones de Dux-Soup -> Pestaña Conectar. Simplemente active el interruptor y establezca la URL de destino donde desea recibir los datos:

URL de destino

Los datos del evento se enviarán a esta dirección web.

Enviar muestra

Pulse este botón para enviar datos de muestra de los tipos de eventos seleccionados a la URL de destino.

Tipos de actos

Seleccione cuál de los eventos disponibles desea recibir. 

• Visite
• Escanear
• Acción
• Mensaje
• Mando a distancia
• Sesión

A continuación se detalla cada uno de estos tipos de actos.

Visitar el evento

Los eventos de visita se producen cuando se visualizan manual y automáticamente perfiles en LinkedIn. 

Evento Visit.Create

Este evento se produce cuando un perfil se abre inicialmente y es reconocido por Dux-Soup. Contiene la mayoría de los detalles del perfil. Por favor, procese también el Evento de Actualización correspondiente para asegurarse de que se reciben todos los detalles del perfil capturados.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
  "userid": "117917531760586753354",		// The current Dux-Soup User
  "time": "2019-01-06T08:45:03.239Z",		// When the event was created
  "type": "visit",				// Visit Event
  "event": "create",				// Create Stage
  "data": {					// Profile Details
    "id": "id.11964767",
    "VisitTime": 1546764302571,
    "Profile": "https://www.linkedin.com/in/jamesbrooks3/",
    "Picture": "https://media.licdn.com/dms/image/C4E03AQGS174biYNVOA/profile-displayphoto-shrink_800_800/0?e=1552521600&v=beta&t=yWZVN_trvl0ycueCa4qayoJkVjqhPsuCzgzdQwv90mM",
    "Degree": "1st",
    "First Name": "James",
    "Middle Name": "",
    "Last Name": "Brooks",
    "From": "2018",
    "Title": "CX Innovation",
    "Company": "Capita",
    ...
  }
}

Evento Visit.Update

Este evento se produce cuando se dispone de información adicional sobre el perfil tras el envío del evento inicial. Tiene la misma estructura que el Evento de Creación e incluirá todos los datos de la Etapa de Creación así como de la Etapa de Actualización.

Ejemplo

{
  "userid": "117917531760586753354",                // The current Dux-Soup User
  "time": "2019-01-06T08:45:06.233Z",               // When the event was created
  "type": "visit",                                  // Visit Event
  "event": "update",                                // Update Stage
  "data": {                                         // Profile Details
    "id": "id.11964767",
    "VisitTime": 1546764302571,
    "Profile": "https://www.linkedin.com/in/jamesbrooks3/",
    "Picture": "https://media.licdn.com/dms/image/C4E03AQGS174biYNVOA/profile-displayphoto-shrink_800_800/0?e=1552521600&v=beta&t=yWZVN_trvl0ycueCa4qayoJkVjqhPsuCzgzdQwv90mM",
    "Degree": "1st",
    "First Name": "James",
    "Middle Name": "",
    "Last Name": "Brooks",
    "From": "2018",
    "Title": "CX Innovation",
    "Company": "Capita",
    ...
  }
}

Evento de escaneado

Los Eventos de Escaneo se producen cuando Dux-Soup procesa una Lista de Perfiles, después de que el usuario haya seleccionado "Escanear Perfiles".

Evento Scan.Create

Este evento se produce cuando Dux-Soup escanea un perfil. El usuario inicia el escaneo de perfiles a través de la opción "Escanear perfiles" del menú desplegable de Dux-Soup. Cada perfil de la lista que sea escaneado dará lugar a un único evento Webhook.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
  "userid": "117917531760586753354",                // The current Dux-Soup User
  "time": "2019-01-06T08:45:06.233Z",               // When the event was created
  "type": "scan",                                   // Scan Event
  "event": "create",                                // Create Stage
  "data": {                                         // Scanned Profile Details
    "id": "id.11964767",
    "ScanTime": 1546764302571,
    "Profile": "https://www.linkedin.com/in/jamesbrooks3/",
    "First Name": "James",
    "Middle Name": "",
    "Last Name": "Brooks",
    ...
}

Eventos de acción

Los eventos de acción se producen cuando las automatizaciones de Dux-Soup, como la autoinvitación o el autoenvío, se activan en un perfil.

Evento Action.Create

Este evento se produce cuando una acción automatizada ha finalizado. El nombre de la acción puede ser uno de los siguientes, correspondientes a las acciones de automatización que están disponibles en Dux-Soup Option:

•       connectProfile
•       disconnectProfile
•       endorseProfile
•       seguirPerfil
•       inmailPerfil
•       mensajePerfil
•       pdfPerfil
•       saveasleadProfile

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
  "userid": "117917536760586753354",		// The current Dux-Soup User
  "time": "2019-01-06T08:45:17.477Z",		// When the event was created
  "type": "action",				// Action Event
  "event": "create",				// Create Stage
  "data": {					// Action Details
    "name": "pdfProfile",
    "targeturl": "https://www.linkedin.com/in/jamesbrooks3/",
    "profileid": "id.11964767",
    "successflag": true,			// Success indicator
    "returnvalue": null				// Return value, if any
  }
}

Mensajes

Los Eventos de Mensaje ocurren cuando el Puente de Mensaje ha sido habilitado y nuevos mensajes están siendo procesados por Dux-Soup.

Evento Message.Received

Este evento se produce cuando un nuevo mensaje recibido ha sido leído por el puente de mensajes. El tipo de mensaje puede ser uno de los siguientes, correspondiente al tipo de mensaje que se leyó en la bandeja de entrada de LinkedIn.

• MIEMBRO_A_MIEMBRO
• ACEPTAR_INVITACIÓN
• INMAIL

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
  "userid": "117917536760586753354",		// The current Dux-Soup User
  "time": "2019-03-21T16:51:25.899Z",		// When the event was created
  "type": "message",				// Message Event
  "event": "received",				// Received message
  "data": {
    "url": 					// the conversation on LinkedIn
	   "https://www.linkedin.com/messaging/thread/64525225672721408/", 	
    "timestamp": "2019-02-15T15:28:20.980Z",	// Timestamp of the message
    "from": 					// Message sender LinkedIn URL
	     "https://www.linkedin.com/in/rodrigo-ramos-a0ab9327", 
    "fromId": "id.26429462492",			// Message sender profile id
    "fromFirstName": "Rodrigo",			// Message sender first name
    "fromLastName": 	"Ramos",		// Message sender last name
    "type": "MEMBER_TO_MEMBER",			// Type of message
    "tags": [	"🦆-default-invited", 
	 	"🦆-default-accepted" , 
		"🦆-default-responded"   ],	// Tags on the profile 
    "text": 					// Message body
	    "Hi man. You’re Welcome. Nice to have you in my contacts" 	
  }
}

Evento Message.Sent

Este evento se produce cuando un nuevo mensaje enviado ha sido leído por el puente de mensajes. El tipo de mensaje es MEMBER_TO_MEMBER.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
  "userid": "117917536760586753354",		// The current Dux-Soup User
  "time": "2019-03-21T16:51:25.899Z",		// When the event was created
  "type": "message",				// Message Event
  "event": "sent",				// Sent message
  "data": {
    "url": 					// the conversation on LinkedIn
	   "https://www.linkedin.com/messaging/thread/64525225672721408/", 	
    "timestamp": "2019-02-15T15:28:20.980Z",	// Timestamp of the message
    "to": 					// Message sender LinkedIn URL
	     "https://www.linkedin.com/in/rodrigo-ramos-a0ab9327", 
    "toId": "id.26429462492",			// Message recipient profile id
    "toFirstName": "Rodrigo",			// Message recipient first name
    "toLastName": 	"Ramos",		// Message recipient last name
    "type": "MEMBER_TO_MEMBER",			// Type of message
    "tags": [	"🦆-default-invited", 
		"🦆-default-accepted"   ],	// Tags on the profile 
    "text": 					// Message body
	    "Hi Rodrigo, what are you up to these days?" 	
  }
}

Eventos de control remoto

Los Eventos de Control Remoto se producen cuando el Robot de Control Remoto procesa comandos.

RCCommand.received Evento

Este evento se produce cuando un nuevo comando de Control Remoto ha sido leído por el robot de control remoto.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
  "userid": "117917536760586753354",		// The current Dux-Soup User
  "time": "2019-03-25T14:13:15.814Z",		// When the event was created
  "type": "rccommand",
  "event": "received",
  "data": {
    "id": "a5f64143-b847-5f473ac7488d",
    "command": "visit",
    "params": {
      "profile": "https://www.linkedin.com/in/janjanjanjanjan/"
    }
  }
}

RCCommand.completed Evento

Este evento se produce cuando un comando de Control Remoto ha sido ejecutado con éxito por el robot de control remoto.

RCCommand.snooze Evento

Este evento se produce cuando el robot de Control Remoto está dormitando debido a la configuración de estrangulamiento.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
  "userid": "103329626217674043154",		// The current Dux-Soup User
  "time": "2019-04-20T10:48:35.828Z",		// When the event was created
  "type": "rccommand",
  "event": "snooze",
  "data": {
    "reason": "throttling",
    "time": 15000
  }
}

Evento RCCommand.ready

Este evento se produce cuando el robot teledirigido está preparado para recibir órdenes.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
  "userid": "117917536760586753354",		// The current Dux-Soup User
  "time": "2022-06-25T14:13:15.814Z",		// When the event was created
  "type": "rccommand",
  "event": "ready",
  "data": {
      "clientid":"203bc8fa-13e9-4efe-b0e1-26a4067c5c6e",
      "exclusions":{
         "commands":[], // list of commands to be excluded due to throttling
         "campaigns":[	// list of disabled campaign ids
            "default"
         ]
  }
}

RCCommand.ignore Evento

Este evento se produce cuando un comando ha sido ignorado. Esto ocurre cuando el perfil de destino coincide con alguna de las reglas de exclusión de acciones, por ejemplo, la lista negra.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
    "userid" : "103329626217674043154",		// The current Dux-Soup User
    "time" : "2022-04-28T08:18:14.221Z",	// When the event was created
    "type" : "rccommand",
    "event" : "ignore",
    "data" : {
        "id" : "a7f8508d-bae9-2caafac11c66",
        "command" : "message",
        "params" : {
            "profile" : "https://www.linkedin.com/in/janjanjanjanjan/",
            "messagetext" : "Hi _FN_,\n\nThanks for connecting.",
            "campaignid" : "default",
        },
        "reason" : "blacklisted"
    }
}

Evento RCCommand.error

Este evento ocurre cuando se produce un error al intentar ejecutar el comando de Control Remoto.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
    "userid" : "103329626217674043154",		// The current Dux-Soup User
    "time" : "2022-04-28T12:35:03.878Z",	// When the event was created
    "type" : "rccommand",
    "event" : "error",
    "data" : {
        "id" : "86082680-b3c1-7e704c999d67",
        "command" : "connect",
        "params" : {
            "profile" : "https://www.linkedin.com/in/janjanjanjanjan/",
            "campaignid" : "playbook",
            "messagetext" : "Hi _FN_,\n\nLet's connect."
        },
        "error" : "selector '*[type=connect-icon],.pvs-profile-actions__action.artdeco-button--primary[0] not found within timeout."
    }
}

Eventos de la sesión

Los eventos de sesión se producen cuando se inicia la extensión Dux-Soup y cuando cambia el estado de la sesión LinkedIn del usuario.

Evento Session.Create

Este evento se activa al inicio de la extensión.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
    "userid" : "103329626277674043154",		// The current Dux-Soup User
    "time" : "2024-02-06T18:59:36.443Z", 	// When the event was created
    "type" : "session",
    "event" : "create",
    "data" : {
        "username" : "",                        // LinkedIn user
        "profile" : "",                         // LinkedIn profile
        "cloudsession" : false,                 // cloud or local
        "loggedin" : false,                     // logged into Linkedin?
        "paused" : false                        // extension paused?
    },
}

Evento Session.Update

Este evento se produce cuando algo cambia en el estado de la sesión LinkedIn de la extensión, o cuando la extensión se pausa o se desbloquea a través de la API.

Ejemplo

Este ejemplo muestra la estructura JSON que se enviará como cuerpo HTTP POST a la URL del webhook

{
    "userid" : "103329626277674043154",		// The current Dux-Soup User
    "time" : "2024-02-06T19:09:33.212Z", 	// When the event was created
    "type" : "session",
    "event" : "update",
    "data" : {
        "username" : "John Doe",                 // LinkedIn user
        "profile" : "https://www.linkedin.com/in/john-doe-381910160",
        "cloudsession" : false,                  // cloud or local
        "loggedin" : true,                       // logged into Linkedin?       
        "paused" : false                         // extension paused?
    },
}