observe-whatsapp
Depurar problemas de entrega de mensajes de WhatsApp y webhooks
Soluciona problemas de producción de WhatsApp de manera eficiente. Esta habilidad proporciona comandos para inspeccionar la entrega de mensajes, depurar fallos de webhooks y ejecutar comprobaciones de salud en la plataforma Kapso.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "observe-whatsapp". Verificar entrega de mensaje para el número de teléfono +1234567890
النتيجة المتوقعة:
Se encontraron 3 mensajes para +1234567890. ID de mensaje msg_abc123: entregado a las 2024-01-15 10:30:00. ID de mensaje msg_def456: pendiente (webhook no confirmado). ID de mensaje msg_ghi789: fallido - destinatario se dio de baja.
استخدام "observe-whatsapp". Mostrar estado de entrega de webhook en la última hora
النتيجة المتوقعة:
Resumen de entregas de webhook: 45 exitosas, 3 fallidas. Entregas fallidas: 503 Service Unavailable del endpoint de webhook a las 10:15, 10:22, 10:45. Cantidad de reintentos: 3/3. Se recomienda verificar la salud del servidor de webhook.
التدقيق الأمني
آمن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.
درجة الجودة
ماذا يمكنك بناءه
Respuesta a incidentes de producción
Investiga rápidamente por qué los mensajes de WhatsApp no se están entregando a los clientes durante un incidente activo.
Depuración de webhooks
Inspecciona los intentos de entrega de webhooks para entender por qué los mensajes entrantes o las actualizaciones de estado no se están recibiendo.
Monitoreo de salud
Ejecuta comprobaciones de salud periódicas en números de teléfono y proyectos para detectar proactivamente problemas antes de que afecten a los usuarios.
جرّب هذه الموجهات
Necesito verificar si se entregó un mensaje de WhatsApp. El número de teléfono es +1234567890. Ayúdame a encontrar la conversación y verificar su estado de entrega.
Nuestro endpoint de webhook dejó de recibir eventos de WhatsApp. Usa el script webhook-deliveries para verificar los intentos de entrega recientes e identificar patrones de error.
Estamos viendo un aumento de errores de mensajes en producción. Ejecuta la clasificación completa de errores: verifica errores de mensajes, revisa los registros de API e identifica fallos de entrega de webhooks. Resume la causa raíz.
Ejecuta una comprobación de salud en el ID de número de teléfono <id> y genera un informe de estado. Incluye cualquier indicador de salud fallido y los pasos de remediación recomendados.
أفضل الممارسات
- Verifica siempre los errores de mensajes y los registros de API juntos para correlacionar fallos con causas raíz
- Ejecuta comprobaciones de salud proactivamente antes de desplegar cambios en las integraciones de WhatsApp
- Usa el script lookup-conversation para obtener el contexto completo al investigar problemas de mensajes individuales
تجنب
- No ejecutes scripts de diagnóstico repetidamente en rápida sucesión, ya que esto puede limitar por tasa el acceso a la API
- No uses esta habilidad para configuración o cambios de configuración de webhooks
- Evita investigar problemas sin primero verificar que las credenciales de API sean válidas y no estén expiradas