Freshsales - Déclencheur

Catalogue des nœuds Déclencheurs

Sur cette page

Recevoir les événements du CRM par webhook authentifié.

Utilisation et spécificités

Créez un identifiant Webhook CRM avec un secret aléatoire, publiez puis configurez un POST JSON côté CRM. Envoyez le secret dans X-Nodulz-CRM-Secret ou le paramètre token. Ce secret dédié ne vérifie pas les signatures natives HubSpot ou Close. Aucun abonnement distant n’est créé automatiquement.

Type technique : freshsales_trigger. Runtime : nodulz.

Identifiants et prérequis

Webhook CRM (integration / crm_webhook). Secret partagé dédié aux webhooks CRM. Envoyez-le dans X-Nodulz-CRM-Secret ou dans le paramètre token de l’URL.

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le guide des identifiants pour les accès et la rotation.

Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

Paramètre	Type	Par défaut	Valeurs / limites
`rateLimitEnabled`	`boolean`	-	-
`rateLimitMax`	`number`	-	-; > 0
`rateLimitWindowMs`	`number`	-	-; > 0
`allowedIps`	`array`	-	-; max 256
`blockedIps`	`array`	-	-; max 256
`credentialId`	`string`	`""`	-
`events`	`array`	`[]`	-
`resourceId`	`string`	`""`	-
`testPayload`	`string`	`""`	-

Aide de configuration

events Événements à recevoir: Noms exacts séparés par des virgules. Exemples : created, updated, deleted. Vide : tous. Pour les formats natifs, utilisez le nom envoyé par le CRM, par exemple contact.creation pour HubSpot et create pour Pipedrive.
testPayload Événement de test: Corps normalisé contenant event, resourceId et payload. Le fournisseur est ajouté automatiquement. Vide : exemple créé automatiquement.

Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

json

{
  "credentialId": "",
  "events": [],
  "resourceId": "",
  "testPayload": ""
}

Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : Expressions et données, Exécutions, Catalogue des nœuds.