Fähigkeiten observe-whatsapp
📦

observe-whatsapp

Sicher

Fehlerbehebung bei WhatsApp-Nachrichtenzustellung und Webhook-Problemen

Produktionsprobleme mit WhatsApp effizient beheben. Dieser Skill bietet Befehle zur Überprüfung der Nachrichtenzustellung, zum Debuggen von Webhook-Fehlern und zur Durchführung von Health Checks auf der Kapso-Plattform.

Unterstützt: Claude Codex Code(CC)
📊 71 Angemessen
1

Die Skill-ZIP herunterladen

2

In Claude hochladen

Gehe zu Einstellungen → Fähigkeiten → Skills → Skill hochladen

3

Einschalten und loslegen

Teste es

Verwendung von "observe-whatsapp". Zustellung für Telefonnummer +1234567890 überprüfen

Erwartetes Ergebnis:

3 Nachrichten für +1234567890 gefunden. Nachrichten-ID msg_abc123: zugestellt am 2024-01-15 10:30:00. Nachrichten-ID msg_def456: ausstehend (Webhook nicht bestätigt). Nachrichten-ID msg_ghi789: fehlgeschlagen - Empfänger hat abgemeldet.

Verwendung von "observe-whatsapp". Webhook-Zustellungsstatus für die letzte Stunde anzeigen

Erwartetes Ergebnis:

Webhook-Zustellungsübersicht: 45 erfolgreich, 3 fehlgeschlagen. Fehlgeschlagene Zustellungen: 503 Service Unavailable vom Webhook-Endpunkt um 10:15, 10:22, 10:45. Wiederholungsversuche: 3/3. Empfehlung: Webhook-Server-Gesundheit überprüfen.

Sicherheitsaudit

Sicher
v1 • 2/24/2026

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.

1
Gescannte Dateien
110
Analysierte Zeilen
0
befunde
1
Gesamtzahl Audits
Keine Sicherheitsprobleme gefunden
Auditiert von: claude

Qualitätsbewertung

38
Architektur
100
Wartbarkeit
87
Inhalt
32
Community
100
Sicherheit
91
Spezifikationskonformität

Was du bauen kannst

Produktionsincident-Beantwortung

Untersuchen Sie schnell, warum WhatsApp-Nachrichten während eines aktiven Vorfalls nicht an Kunden zugestellt werden.

Webhook-Debugging

Überprüfen Sie Webhook-Zustellungsversuche, um zu verstehen, warum eingehende Nachrichten oder Statusaktualisierungen nicht empfangen werden.

Gesundheitsüberwachung

Führen Sie regelmäßige Health Checks für Telefonnummern und Projekte durch, um Probleme proaktiv zu erkennen, bevor sie Benutzer betreffen.

Probiere diese Prompts

Grundlegende Nachrichtensuche
Ich muss überprüfen, ob eine WhatsApp-Nachricht zugestellt wurde. Die Telefonnummer ist +1234567890. Helfen Sie mir, die Konversation zu finden und den Zustellungsstatus zu überprüfen.
Webhook-Zustellungsuntersuchung
Unser Webhook-Endpunkt empfängt keine Ereignisse mehr von WhatsApp. Verwenden Sie das Skript webhook-deliveries, um aktuelle Zustellungsversuche zu überprüfen und Fehlermuster zu identifizieren.
Fehler-Triage-Workflow
Wir sehen erhöhte Nachrichtenfehler in der Produktion. Führen Sie die vollständige Fehler-Triage durch: Überprüfen Sie Nachrichtenfehler, analysieren Sie API-Logs und identifizieren Sie Webhook-Zustellungsfehler. Fassen Sie die Grundursache zusammen.
Health Check-Automatisierung
Führen Sie einen Health Check für die Telefonnummern-ID <id> durch und erstellen Sie einen Statusbericht. Beziehen Sie fehlgeschlagene Health-Indikatoren und empfohlene Korrekturmaßnahmen mit ein.

Bewährte Verfahren

  • Überprüfen Sie immer Nachrichtenfehler und API-Logs zusammen, um Fehler mit Grundursachen zu korrelieren
  • Führen Sie Health Checks proaktiv durch, bevor Sie Änderungen an WhatsApp-Integrationen bereitstellen
  • Verwenden Sie das Skript lookup-conversation, um den vollständigen Kontext zu erhalten, wenn Sie einzelne Nachrichtenprobleme untersuchen

Vermeiden

  • Führen Sie Diagnose-Skripte nicht wiederholt in schneller Folge aus, da dies die API-Zugriffe rate-limitieren kann
  • Verwenden Sie diesen Skill nicht für Webhook-Einrichtung oder Konfigurationsänderungen
  • Vermeiden Sie die Untersuchung von Problemen, ohne vorher zu überprüfen, ob API-Anmeldedaten gültig und nicht abgelaufen sind

Häufig gestellte Fragen

Welche Anmeldedaten benötige ich, um diesen Skill zu nutzen?
Sie benötigen die Umgebungsvariablen KAPSO_API_BASE_URL (die Host-URL ohne /platform/v1 Pfad) und KAPSO_API_KEY, die konfiguriert sein müssen.
Kann dieser Skill WhatsApp-Webhooks erstellen oder ändern?
Nein. Dieser Skill dient nur zur Beobachtung und Fehlerbehebung. Verwenden Sie den integrate-whatsapp Skill für Webhook-Einrichtung, Updates oder Löschungen.
Warum zeigen einige Befehle npm install-Anforderungen?
Die Skripte sind von Node.js-Paketen abhängig. Führen Sie npm install einmal aus, bevor Sie die Diagnose-Skripte verwenden, um die erforderlichen Abhängigkeiten zu installieren.
Was macht das Skript openapi-explore.mjs?
Es ermöglicht Ihnen, die OpenAPI-Spezifikation der Kapso-Plattform zu durchsuchen und zu erkunden, sodass Sie verfügbare Endpunkte, Operationen und Schemas finden können.
Wie überprüfe ich den Health-Status einer bestimmten Telefonnummer?
Verwenden Sie das Skript whatsapp-health.js mit dem Flag --phone-number-id gefolgt von der Telefonnummern-ID, die Sie überprüfen möchten.
Was sollte ich tun, wenn Webhook-Zustellungen fehlschlagen?
Überprüfen Sie zuerst, ob Ihr Webhook-Server mit 2xx-Statuscodes antwortet. Überprüfen Sie dann die Ausgabe von webhook-deliveries.js auf Wiederholungsmuster und Fehlercodes. Validieren Sie, dass Ihre Webhook-Signaturprüfung korrekt ist.

Entwicklerdetails

Dateistruktur

📄 SKILL.md