Configurar um gatilho de Webhook

​

Quando usar Webhooks

​

Configuração passo a passo

​

Etapa 1: Criar o fluxo de trabalho

1. Vá para Configurações → Fluxos de trabalho
2. Clique em + Novo fluxo de trabalho
3. Dê um nome (por exemplo, “Envio de formulário do site”)

​

Etapa 2: Configurar o gatilho de Webhook

1. Clique no bloco de gatilho
2. Selecione Webhook
3. Você receberá uma URL de webhook exclusiva, como:
   https://api.twenty.com/webhooks/workflow/abc123...
   
4. Copie esta URL—você vai precisar dela no seu serviço externo

​

Etapa 3: Definir a estrutura de dados esperada

1. Clique em Definir corpo esperado
2. Insira um JSON de exemplo que corresponda ao que o seu serviço enviará:

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

3. Clique em Salvar—isso cria variáveis que você pode usar nas etapas subsequentes

​

Etapa 4: Adicionar ações

1. Adicione a ação Criar registro
2. Selecione o objeto Pessoas
3. Mapeie os campos:

​

Etapa 5: Testar o 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. Crie uma solicitação POST para a sua URL de webhook
2. Defina o cabeçalho Content-Type como application/json
3. Adicione o corpo JSON de teste
4. Envie e verifique as execuções do fluxo de trabalho

​

Etapa 6: Ativar

​

Como lidar com diferentes estruturas de dados

​

Dados aninhados

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

​

Arrays

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

​

Relacionados

• Gatilhos de Fluxo de Trabalho
• Ações de Fluxo de Trabalho