# twilio-debugging-observability

Разбирает, почему не доходят SMS и падают звонки, и помогает настроить мониторинг Twilio в продакшене.

- скилл · `type=skill` · Codex, ChatGPT · ★ 7596
- Автор: Twilio · официальный репозиторий OpenAI
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/openai/plugins/tree/HEAD/plugins/twilio-developer-kit/skills/twilio-debugging-observability/SKILL.md
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/skills/twilio-debugging-observability

## Что делает

Скилл ведёт по шагам: сначала статус-колбэки конкретного сообщения или звонка, потом сам ресурс через REST API, затем репутация номера и регистрация отправителя, Console Debugger, ваш вебхук и уже после этого Monitor Alerts API или Event Streams. Порядок не случайный. Статус-колбэк даёт точный код ошибки для того самого сообщения, а Console Debugger собирает ошибки по всему аккаунту и нужную может не показать. Начните с узкого места, потом расширяйте.

Внутри есть готовые обработчики вебхука Debugger на Python (Flask) и Node.js (Express) с проверкой подписи `X-Twilio-Signature`, запросы к `monitor.alerts.list` с фильтром по дате и уровню, разбор частых кодов вроде 30007 и 30034. Для Event Streams понадобится публичный HTTPS-эндпоинт или поток AWS Kinesis. Ещё нужны `TWILIO_ACCOUNT_SID` и `TWILIO_AUTH_TOKEN`, а SDK ставится через `pip install twilio requests` или `npm install twilio`.

Полезная эвристика из скилла: если колбэк показывает `delivered`, а получатель говорит, что ничего не пришло, ищите причину на стороне оператора или устройства. Если в Console Debugger ошибок нет вообще, проблема в вашем приложении — вебхук, TwiML или бизнес-логика. Это повод не чинить Twilio там, где он не виноват.

## Установка

### Codex (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill twilio-debugging-observability -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/twilio-debugging-observability/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Claude Code

1. **Через Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill twilio-debugging-observability -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/twilio-debugging-observability/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/twilio-debugging-observability/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/skills/twilio-debugging-observability/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins twilio-debugging-observability
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/twilio-debugging-observability/SKILL.md`

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/twilio-developer-kit/skills/twilio-debugging-observability
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/twilio-debugging-observability/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/openai/plugins/tree/HEAD/plugins/twilio-developer-kit/skills/twilio-debugging-observability/SKILL.md

## Когда брать
- найти код ошибки для конкретного недоставленного сообщения
- понять, почему звонок ушёл в голосовую почту или помечен как спам
- настроить вебхук Console Debugger с проверкой подписи
- выгрузить ошибки аккаунта за сутки через Monitor Alerts API
- отличить проблему на стороне оператора от бага в своём вебхуке

## Примеры запросов агенту
- Сообщения не доставляются, пройди по шагам отладки Twilio и скажи, где искать причину
- Настрой вебхук Console Debugger на Python с проверкой X-Twilio-Signature
- Покажи ошибки уровня error за последние сутки через Monitor Alerts API

## Похожие
- [connector-twilio](https://affpapa.org/nevibecode/skills/connector-twilio.md) — скилл · 11200 установок
- [Twilio SMS Automation](https://affpapa.org/nevibecode/skills/twilio-sms-automation.md) — скилл · 5400 установок
- [twilio-communications](https://affpapa.org/nevibecode/skills/sickn33-twilio-communications.md) — скилл · 994 установки
- [integration-error-observability](https://affpapa.org/nevibecode/skills/integration-error-observability.md) — скилл · 7700 установок
- [cx-observability-setup](https://affpapa.org/nevibecode/skills/cx-observability-setup.md) — скилл · 3400 установок
- [distributed-debugging](https://affpapa.org/nevibecode/plugins/distributed-debugging.md) — плагин · ★ 41729

Из того же набора: [openai/plugins](https://affpapa.org/nevibecode/by/openai/plugins.md) — 337 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md