Configurer un déclencheur de webhook

​

Quand utiliser les webhooks

​

Configuration pas à pas

​

Étape 1 : Créer le flux de travail

1. Allez dans Paramètres → Flux de travail
2. Cliquez sur + Nouveau flux de travail
3. Nommez-le (par exemple, “Soumission de formulaire de site web”)

​

Étape 2 : Configurer le déclencheur de webhook

1. Cliquez sur le bloc de déclenchement
2. Sélectionnez Webhook
3. Vous recevrez une URL de webhook unique, par exemple :
   https://api.twenty.com/webhooks/workflow/abc123...
   
4. Copiez cette URL — vous en aurez besoin pour votre service externe

​

Étape 3 : Définir la structure de données attendue

1. Cliquez sur Définir le corps attendu
2. Saisissez un JSON d’exemple correspondant à ce que votre service enverra :

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "company": "Acme Inc",
  "message": "Interested in your product"
}

3. Cliquez sur Enregistrer — cela crée des variables que vous pouvez utiliser dans les étapes suivantes

​

Étape 4 : Ajouter des actions

1. Ajoutez l’action Créer un enregistrement
2. Sélectionnez l’objet People
3. Associez les champs :

​

Étape 5 : Tester le webhook

curl -X POST https://api.twenty.com/webhooks/workflow/abc123... \
  -H "Content-Type: application/json" \
  -d '{"firstName":"Test","lastName":"User","email":"test@example.com"}'

1. Créez une requête POST vers votre URL de webhook
2. Définissez l’en-tête Content-Type sur application/json
3. Ajoutez votre corps JSON de test
4. Envoyez et vérifiez les exécutions du flux de travail

​

Étape 6 : Activer

​

Gestion de différentes structures de données

​

Données imbriquées

{
  "contact": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "source": "website"
}

​

Tableaux

{
  "items": [
    {"name": "Product A", "qty": 2},
    {"name": "Product B", "qty": 1}
  ]
}

export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;
  return { items };
};

export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;

  return {
    product: {
      name: items[0]?.name || "",
      qty: items[0]?.qty || 0
    }
  };
};

​

Connexes

• Déclencheurs de flux de travail
• Actions de flux de travail