К основному содержанию
скилл CX Codex

setup-webhook — скилл для Claude Code: что делает и как установить

Скилл setup-webhook для Claude Code, который настраивает серверные URL и вебхуки для получения событий от Vapi. Запускается при интеграции Vapi в приложение или создании эндпоинтов для обработки вызовов.

MIT 968 установок ★ 69 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add VapiAI/skills --skill setup-webhook -a claude-code
Открыть на GitHub

Что делает setup-webhook

Скилл настраивает серверные URL для обмена данными с Vapi в реальном времени. Он позволяет приложению получать транскрипты, результаты вызовов и отчёты, а также возвращать ответы, влияющие на ход разговора. Настройка доступна на уровне организации, ассистента или конкретного телефонного номера.

Для работы необходим доступ в интернет и ключ VAPI_API_KEY. Скилл не создаёт публичный URL самостоятельно, поэтому для локальной разработки потребуется ngrok или аналогичный инструмент для проброса портов.

Какие задачи решает

  • Получать транскрипты звонков в реальном времени
  • Обрабатывать вызовы инструментов прямо во время разговора
  • Динамически настраивать ассистента через вебхук

Примеры запросов агенту

  • Настрой вебхук для получения отчётов о завершении вызова
  • Добавь серверный URL к ассистенту с ID assistant_id

Как установить setup-webhook

1Через Skills CLI (Vercel)

npx skills add VapiAI/skills --skill setup-webhook -a claude-code

2Вручную: положить файлы

~/.claude/skills/setup-webhook/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/setup-webhook/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о setup-webhook

Как установить setup-webhook в Claude Code?

Используйте команду npx skills add VapiAI/skills --skill setup-webhook -a claude-code.

Что делает setup-webhook?

Скилл автоматизирует настройку серверных URL, через которые Vapi отправляет события вроде транскриптов и отчётов, а также запрашивает данные для управления звонком.

Что нужно для работы setup-webhook?

Для работы необходим активный ключ VAPI_API_KEY и сервер, доступный из интернета для приема HTTP-запросов.

Исходный текст

SKILL.md · MIT
---
name: setup-webhook
description: Configure Vapi server URLs and webhooks to receive real-time call events, transcripts, tool calls, and end-of-call reports. Use when setting up webhook endpoints, building tool servers, or integrating Vapi events into your application.
license: MIT
compatibility: Requires internet access and a Vapi API key (VAPI_API_KEY).
metadata:
  author: vapi
  version: "1.0"
---

# Vapi Webhook / Server URL Setup

Configure server URLs to receive real-time events from Vapi during calls — transcripts, tool calls, status changes, and end-of-call reports.

> **Setup:** Ensure `VAPI_API_KEY` is set. See the `setup-api-key` skill if needed.

## Overview

Vapi uses "Server URLs" (webhooks) to communicate with your application. Unlike traditional one-way webhooks, Vapi server URLs support bidirectional communication — your server can respond with data that affects the call.

## Where to Set Server URLs

### On an Assistant

```bash
curl -X PATCH https://api.vapi.ai/assistant/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server": {
      "url": "https://your-server.com/vapi/webhook",
      "credentialId": "cred_abc123"
    }
  }'
```

Create the optional `credentialId` in **Dashboard > Custom Credentials**. Omit it only for a deliberately public endpoint.

### On a Phone Number

Phone-number updates also use a `server` object with `url` and optional `credentialId`. When updating through the API, first retrieve the number and preserve its existing `provider` discriminator in the PATCH body. The dashboard is the safest choice when the provider is unknown.

### At the Organization Level

Set a default server URL in the Vapi Dashboard under **Settings > Server URL**.

Priority order: Tool server URL > Assistant server URL > Phone Number server URL > Organization server URL.

## Event Types

| Event | Description | Expects Response? |
|-------|-------------|-------------------|
| `assistant-request` | Request for dynamic assistant config | Yes — return assistant config |
| `tool-calls` | Assistant is calling a tool | Yes — return tool results |
| `status-update` | Call status changed | No |
| `transcript` | Real-time transcript update | No |
| `end-of-call-report` | Call completed with summary | No |
| `hang` | Assistant failed to respond | No |
| `speech-update` | Speech activity detected | No |

## Webhook Server Example (Express.js)

```typescript
import express from "express";
const app = express();
app.use(express.json());

app.post("/vapi/webhook", (req, res) => {
  const { message } = req.body;

  switch (message.type) {
    case "assistant-request":
      // Dynamically configure the assistant based on the caller
      res.json({
        assistant: {
          name: "Dynamic Assistant",
          firstMessage: `Hello ${message.call.customer?.name || "there"}!`,
          model: {
            provider: "openai",
            model: "gpt-4.1",
            messages: [
              { role: "system", content: "You are a helpful assistant." },
            ],
          },
          voice: { provider: "vapi", voiceId: "Elliot", version: 2 },
          transcriber: { provider: "deepgram", model: "nova-3", language: "en" },
        },
      });
      break;

    case "tool-calls":
      // Handle tool calls from the assistant
      const results = (message.toolCallList || []).map((toolCall: any) => ({
        toolCallId: toolCall.id,
        result: handleToolCall(
          toolCall.name,
          toolCall.parameters || toolCall.arguments
        ),
      }));
      res.json({ results });
      break;

    case "end-of-call-report":
      // Process the call report
      console.log("Call ended:", {
        callId: message.call.id,
        endedReason: message.endedReason,
        cost: message.cost,
        analysis: message.analysis,
        artifact: message.artifact,
      });
      res.json({});
      break;

    case "status-update":
      console.log("Call status:", message.status);
      res.json({});
      break;

    case "transcript":
      console.log(`[${message.role}]: ${message.transcript}`);
      res.json({});
      break;

    default:
      res.json({});
  }
});

function handleToolCall(name: string, args: any): string {
  // Implement your tool logic here
  return `Result for ${name}`;
}

app.listen(3000, () => console.log("Webhook server running on port 3000"));
```

## Webhook Server Example (Python / Flask)

```python
from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route("/vapi/webhook", methods=["POST"])
def vapi_webhook():
    data = request.json
    message = data.get("message", {})
    msg_type = message.get("type")

    if msg_type == "assistant-request":
        return jsonify({
            "assistant": {
                "name": "Dynamic Assistant",
                "firstMessage": "Hello! How can I help?",
                "model": {
                    "provider": "openai",
                    "model": "gpt-4.1",
                    "messages": [
                        {"role": "system", "content": "You are a helpful assistant."}
                    ],
                },
                "voice": {"provider": "vapi", "voiceId": "Elliot", "version": 2},
                "transcriber": {"provider": "deepgram", "model": "nova-3", "language": "en"},
            }
        })

    elif msg_type == "tool-calls":
        results = []
        for tool_call in message.get("toolCallList", []):
            results.append({
                "toolCallId": tool_call["id"],
                "result": f"Handled {tool_call['name']}",
            })
        return jsonify({"results": results})

    elif msg_type == "end-of-call-report":
        print(f"Call ended: {message['call']['id']}")
        print(f"Summary: {message.get('analysis', {}).get('summary')}")

    return jsonify({})

if __name__ == "__main__":
    app.run(port=3000)
```

## Webhook Authentication

Use a Vapi Custom Credential and place its ID in `server.credentialId`. Vapi supports Bearer Token, OAuth 2.0 client credentials, and HMAC credentials. Verify requests according to the credential you configured; HMAC header names, algorithms, timestamps, and payload formats are configurable, so do not assume a fixed `x-vapi-signature` format.

For a bearer credential, compare the incoming `Authorization: Bearer <token>` value with the token stored securely by your server. Never put the secret itself in an assistant or phone-number payload.

## Local Development

For a local development environment where the Vapi CLI and ngrok are already installed, use the CLI with a public tunnel. Do not download or execute remote installation scripts as part of webhook setup. See the official installation documentation if a prerequisite is missing. The CLI forwards from port 4242 to your app, but it does not create the public URL itself:

```bash
# Terminal 1: expose the CLI listener
ngrok http 4242

# Terminal 2: forward events from the CLI to your app
vapi listen --forward-to localhost:3000/vapi/webhook
```

Set the Vapi server URL to the public ngrok URL. To skip the CLI and tunnel directly to the Express or Flask server instead:

```bash
ngrok http 3000
# Copy the ngrok URL and set it as your server URL
```

## End-of-Call Report Fields

The `end-of-call-report` event includes:

| Field | Description |
|-------|-------------|
| `call` | Full call object with metadata |
| `endedReason` | Why the call ended |
| `artifact` | Recording, transcript, messages, and other enabled artifacts |
| `analysis` | Configured summaries, structured data, and success evaluation |
| `cost` | Total call cost |
| `startedAt` / `endedAt` | Call timing, when included |

## References

- [Common Server URL Events](references/webhook-events.md) — Common event payloads and responses
- [Setting Server URLs](https://docs.vapi.ai/server-url/setting-server-urls) — Placement and priority
- [Server Authentication](https://docs.vapi.ai/server-url/server-authentication) — Custom Credentials
- [Local Development](https://docs.vapi.ai/server-url/developing-locally) — Testing webhooks locally

## Additional Resources

Vapi provides a **documentation MCP server** that gives compatible AI agents access to the Vapi knowledge base. Use its documentation search for advanced configuration, troubleshooting, SDK details, and anything beyond this skill.

To add the Vapi documentation MCP server manually in Claude Code, run:
```bash
claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server
```

See the [Vapi MCP integration guide](https://docs.vapi.ai/cli/mcp) for setup instructions across supported agents.

© vapi · MIT · VapiAI/skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
Webhook Automation Claude Office Skills Скилл Webhook Automation для Claude Code: приём событий вебхука, проверка подписи, маршрутизация и преобразование payload. Связывает платежи, GitHub и Slack с внутренними сервисами. CX Codex +1 4 800установок nansen-alerts-webhook-listener nansen-ai Скилл nansen-alerts-webhook-listener для Claude Code настраивает локальный HTTP-сервер для получения вебхуков умных алертов Nansen в реальном времени с проверкой HMAC-подписи и туннелированием наружу. CX Codex +1 174установок webhook membrane Скилл webhook связывает ассистента со сторонними вебхуками и сервисами через Membrane CLI. Он берёт на себя авторизацию и маршрутизацию запросов. CX Codex +1 159установок Webhook Integration taste f Промпт Webhook Integration taste для ChatGPT задаёт правила надёжной интеграции вебхуков. Он охватывает приём событий, их обработку и отправку клиентским endpoint’ам. GP ChatGPT ★ 178 201звёзд репо encore-go-webhook encoredev Скилл encore-go-webhook помогает принимать webhook-события в Encore Go через raw HTTP, проверять подписи и передавать обработку в Pub/Sub. CX Codex +1 358установок Webhook Tester — Send & Measure HTTP Endpoints axel-belfort Webhook Tester — Send & Measure HTTP Endpoints — MCP-сервер отправляет запрос на ваш webhook и показывает код ответа и тайминги, включая TLS-рукопожатие. Используется при отладке интеграций. CX Codex +1 2 465установок

Из того же набора10

Весь набор →
create-call Скилл create-call для Claude Code инициирует разовые исходящие, веб-звонки и простые пакетные вызовы через Vapi API. Запускает из кода проверку голосовых ассистентов и звонки клиентам. CX Codex +1 1 100установок create-assistant Скилл create-assistant для Claude Code проектирует и проверяет голосовых ассистентов Vapi. Он подключается при создании телефонного или веб-агента и настройке его поведения. CX Codex +1 1 100установок create-phone-number Скилл create-phone-number для Claude Code и Codex: управляет телефонными номерами Vapi через публичный API — создание, импорт, маршрутизация, обновление и проверка номеров для голосовых ассистентов. CX Codex +1 973установок create-tool Скилл create-tool помогает проектировать, создавать и привязывать инструменты к ассистентам Vapi через публичный API. Поддерживает вызовы телефонии, интеграции с сервисами, REST-запросы и MCP. CX Codex +1 958установок create-squad Скилл create-squad помогает решить, нужна ли команда ассистентов вместо одного, и собирает Squad через публичный API Vapi с проверкой ID и хендоффов. CX Codex +1 910установок vapi-bootstrap-framework Скилл vapi-bootstrap-framework для быстрого создания голосовых агентов Vapi из черновика. Генерирует полный проект на Bun + TypeScript с регистром сценариев, стеками языков и bootstrap-скриптом — нужны только ROUGH_DRAFT.md, Bun и API-ключ. CX Codex +1 314установок vapi-prompt-builder Скилл vapi-prompt-builder для Claude Code создаёт, улучшает и проверяет системные промпты Vapi для голосовых агентов и Squad. В промптах задаются сценарии звонков, маршрутизация и передача оператору. CX Codex +1 297установок simulations Скилл simulations проектирует, собирает и запускает голосовые или текстовые симуляции для ассистентов Vapi. Помогает проверить поведение агента в диалоге до релиза. CX Codex +1 161установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой