Webhook Lifecycle Events

In n8n: top-right menu → "Import from clipboard" → paste. Then set the Webhook node's Production URL as your agent's webhook, and edit the "Build personalization" node to read from your system.

{
  "name": "VocoAgents Personalization Webhook",
  "nodes": [
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "vocoagents-personalization",
        "responseMode": "responseNode",
        "options": {}
      },
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 2,
      "position": [
        260,
        300
      ],
      "webhookId": "vocoagents-personalization"
    },
    {
      "parameters": {
        "jsCode": "const id = $input.first().json.body?.params?.call?.id;\n// TODO: look up the visitor by id in your CRM / database\nreturn [{ json: { result: {\n  personalization: { first_name: 'Joe', sex: 'unknown', language: 'en' },\n  additional_context: '## Customer\\n- Plan: Pro\\n- Open ticket #1234'\n} } }];"
      },
      "name": "Build personalization",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        480,
        300
      ]
    },
    {
      "parameters": {
        "respondWith": "json",
        "responseBody": "={{ $json }}",
        "options": {}
      },
      "name": "Respond to Webhook",
      "type": "n8n-nodes-base.respondToWebhook",
      "typeVersion": 1,
      "position": [
        700,
        300
      ]
    }
  ],
  "connections": {
    "Webhook": {
      "main": [
        [
          {
            "node": "Build personalization",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Build personalization": {
      "main": [
        [
          {
            "node": "Respond to Webhook",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

In Make: create a scenario → ⋯ menu → "Import Blueprint" → paste. Copy the Custom webhook URL into your agent settings, then edit the Webhook response body.

{
  "name": "VocoAgents Personalization Webhook",
  "flow": [
    {
      "id": 1,
      "module": "gateway:CustomWebHook",
      "version": 1,
      "parameters": {
        "hook": null,
        "maxResults": 1
      },
      "mapper": {},
      "metadata": {
        "designer": {
          "x": 0,
          "y": 0
        }
      }
    },
    {
      "id": 2,
      "module": "gateway:WebhookRespond",
      "version": 1,
      "parameters": {},
      "mapper": {
        "status": "200",
        "headers": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": "{\n  \"result\": {\n    \"personalization\": {\n      \"first_name\": \"Joe\",\n      \"sex\": \"unknown\",\n      \"language\": \"en\"\n    },\n    \"additional_context\": \"## Customer\\n- Plan: Pro\\n- Open ticket #1234\"\n  }\n}"
      },
      "metadata": {
        "designer": {
          "x": 300,
          "y": 0
        }
      }
    }
  ],
  "metadata": {
    "version": 1,
    "scenario": {
      "roundtrips": 1,
      "maxErrors": 3,
      "autoCommit": true
    },
    "designer": {
      "orphans": []
    }
  }
}

A standalone webhook server. Point your agent's webhook URL at /vocoagents/personalization.

// VocoAgents personalization webhook — minimal Express server
// Install:  npm i express
// Run:      node server.js
import express from 'express';

const app = express();
app.use(express.json());

app.post('/vocoagents/personalization', async (req, res) => {
  const id = req.body?.params?.call?.id;

  // TODO: look up the visitor by `id` in your CRM / database
  // const user = await db.findVisitor(id);

  res.json({
    result: {
      personalization: {
        first_name: 'Joe',
        sex: 'unknown',
        language: 'en'
      },
      additional_context: '## Customer\n- Plan: Pro\n- Open ticket #1234'
    }
  });
});

app.listen(3000, () => console.log('Webhook listening on :3000'));