Avec la version Linked Helper à stockage cloud, il est possible d’ajouter des profils à une campagne via un webhook entrant.
Création du webhook
Remarque : les webhooks entrants sont disponibles uniquement pour les utilisateurs de la version Linked Helper à stockage cloud.
- Ouvrez une campagne et allez dans l’onglet Workflow
- Cliquez sur l’icône Webhook à côté du bouton Add
- Donnez-lui un nom et cliquez sur le bouton Add webhook
- Une fois le webhook créé, vous pouvez :
- activer le mode Stand by, qui permet de garder la campagne prête à reprendre dès que de nouveaux profils sont reçus ; sinon, vous devrez la démarrer manuellement une fois les profils ajoutés ;
- copier l’URL du webhook et l’ajouter dans votre autre outil :
- Ajouter un autre webhook pour recevoir des profils depuis différentes sources :
Envoi de données au webhook
Schéma du payload et exemples
Le webhook peut recevoir des requêtes POST avec les données de payload dans le corps de la requête :
- obligatoire : URLs LinkedIn ou Sales Navigator
- optionnel : champs personnalisés
Il est possible d’envoyer plusieurs URLs dans une seule requête, chacune pouvant avoir plusieurs champs personnalisés (ou aucun).
Schéma du 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
}
Exemple de payload avec variables personnalisées :
{
"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"
}
]
}
]
}
Exemple de payload sans variables personnalisées :
{
"people": [
{
"externalId": "https://www.linkedin.com/in/jane-doe-123456789/",
"customFields": []
},
{
"externalId": "https://www.linkedin.com/sales/lead/ACwAAAZXyZABcD1234567890abcdef,NAME_SEARCH,abcd1234",
"customFields": []
}
]
}
Suppression du webhook
- Ouvrez une campagne et allez dans l’onglet Workflow
- Cliquez sur l’icône Webhook à côté du bouton Add
- Cliquez sur le bouton Bin sur la ligne du webhook que vous souhaitez supprimer et confirmez l’action :