Configura un trigger webhook

​

Quando utilizzare i webhook

​

Configurazione passo-passo

​

Passaggio 1: Crea il flusso di lavoro

1. Vai a Impostazioni → Flussi di lavoro
2. Fai clic su + Nuovo flusso di lavoro
3. Assegnagli un nome (ad es., “Invio modulo sito web”)

​

Passaggio 2: Configura il trigger webhook

1. Fai clic sul blocco del trigger
2. Seleziona Webhook
3. Riceverai un URL webhook univoco come:
   https://api.twenty.com/webhooks/workflow/abc123...
   
4. Copia questo URL—ti servirà per il tuo servizio esterno

​

Passaggio 3: Definisci la struttura dati attesa

1. Fai clic su Definisci corpo previsto
2. Inserisci un JSON di esempio che corrisponda a ciò che il tuo servizio invierà:

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

3. Fai clic su Salva—questo crea variabili che puoi usare nei passaggi successivi

​

Passaggio 4: Aggiungi azioni

1. Aggiungi l’azione Crea record
2. Seleziona l’oggetto People
3. Mappa i campi:

​

Passaggio 5: Testa il 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. Crea una richiesta POST verso l’URL del tuo webhook
2. Imposta l’header Content-Type su application/json
3. Aggiungi il body JSON di test
4. Invia e controlla le esecuzioni del flusso di lavoro

​

Passaggio 6: Attiva

​

Gestione di strutture dati diverse

​

Dati annidati

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

​

Array

{
  "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
    }
  };
};

​

Correlati

• Trigger dei flussi di lavoro
• Azioni dei flussi di lavoro