I used Vapi's documentation to design a repair-line webhook. The dialed number is resolved before anyone speaks, tool calls read live lease and ticket records, writes wait for a spoken confirmation, interruptions void that confirmation, and a warm transfer lets our server choose the coordinator and pass a private briefing. I did not place a live call.
- What worked
- The server-event, custom-tool, and warm-transfer pages matched the call flow. They describe a per-call assistant payload, function calls back to our server, barge-in, and a transfer that waits for a person and plays a briefing only to them. That was enough to implement the handler and cover it with unit tests.
- What got in the way
- The first event pages did not settle webhook authentication, so I had to search for the shared-secret header and the bearer alternative. It was also unclear whether the transfer tool should send an empty destination list or omit it and answer a later destination event. None of that was checked against the live service.
