observe-whatsapp
Отладка доставки сообщений WhatsApp и проблем с веб-хуками
Эффективное устранение производственных проблем с WhatsApp. Этот навык предоставляет команды для проверки доставки сообщений, отладки сбоев веб-хуков и выполнения проверок работоспособности на платформе Kapso.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «observe-whatsapp». Проверить доставку сообщения для номера телефона +1234567890
Ожидаемый результат:
Найдено 3 сообщения для +1234567890. Идентификатор сообщения msg_abc123: доставлено 15.01.2024 в 10:30:00. Идентификатор сообщения msg_def456: ожидает (веб-хук не подтвержден). Идентификатор сообщения msg_ghi789: не удалось — получатель отказался.
Использование «observe-whatsapp». Показать статус доставки веб-хука за последний час
Ожидаемый результат:
Сводка доставки веб-хуков: 45 успешно, 3 не удалось. Неудавшиеся доставки: 503 Service Unavailable от конечной точки веб-хука в 10:15, 10:22, 10:45. Количество повторных попыток: 3/3. Рекомендуется проверить работоспособность сервера веб-хука.
Аудит безопасности
БезопасноThis skill is documentation-only (SKILL.md). Static analyzer flagged markdown code blocks as shell commands, but all 28 external_commands findings are false positives from code formatting. Network and env_access findings reference YAML frontmatter URLs and documented environment variable requirements, not actual code execution. No executable code exists in this skill.
Оценка качества
Что вы можете построить
Реагирование на инциденты в производственной среде
Быстрое исследование причин недоставки сообщений WhatsApp клиентам во время активного инцидента.
Отладка веб-хуков
Проверка попыток доставки веб-хуков для понимания причин, по которым входящие сообщения или обновления статуса не поступают.
Мониторинг работоспособности
Периодическое выполнение проверок работоспособности номеров телефонов и проектов для проактивного обнаружения проблем до того, как они повлияют на пользователей.
Попробуйте эти промпты
Мне нужно проверить, было ли доставлено сообщение WhatsApp. Номер телефона — +1234567890. Помогите найти диалог и проверить статус доставки.
Наша конечная точка веб-хука перестала получать события от WhatsApp. Используйте скрипт webhook-deliveries для проверки недавних попыток доставки и выявления каких-либо закономерностей ошибок.
Мы наблюдаем увеличение ошибок сообщений в производственной среде. Пройдите полный триаж ошибок: проверьте ошибки сообщений, просмотрите журналы API и выявите любые сбои доставки веб-хуков. Обобщите корневую причину.
Выполните проверку работоспособности для идентификатора номера телефона <id> и сгенерируйте отчет о состоянии. Включите любые неудавшиеся показатели работоспособности и рекомендуемые шаги по исправлению.
Лучшие практики
- Всегда проверяйте ошибки сообщений и журналы API вместе, чтобы коррелировать сбои с корневыми причинами
- Проактивно выполняйте проверки работоспособности перед развертыванием изменений в интеграциях WhatsApp
- Используйте скрипт lookup-conversation для получения полного контекста при исследовании проблем отдельных сообщений
Избегать
- Не запускайте диагностические скрипты повторно в быстрой последовательности, так как это может привести к ограничению скорости доступа к API
- Не используйте этот навык для настройки веб-хуков или изменения конфигурации
- Избегайте исследования проблем без предварительной проверки действительности и срока действия учетных данных API