observe-whatsapp
Déboguer la livraison des messages WhatsApp et les problèmes de webhooks
Dépannez efficacement les problèmes de production WhatsApp. Cette compétence fournit des commandes pour inspecter la livraison des messages, déboguer les échecs de webhooks et exécuter des vérifications de santé sur la plateforme Kapso.
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Tester
Utilisation de "observe-whatsapp". Vérifiez la livraison des messages pour le numéro de téléphone +1234567890
Résultat attendu:
3 messages trouvés pour +1234567890. ID de message msg_abc123 : livré le 2024-01-15 10:30:00. ID de message msg_def456 : en attente (webhook non reconnu). ID de message msg_ghi789 : échoué - destinataire désinscrit.
Utilisation de "observe-whatsapp". Affichez le statut de livraison des webhooks pour la dernière heure
Résultat attendu:
Résumé des livraisons de webhooks : 45 réussies, 3 échouées. Livraisons échouées : 503 Service Unavailable du point de terminaison webhook à 10:15, 10:22, 10:45. Nombre de tentatives : 3/3. Recommandation : vérifiez la santé du serveur webhook.
Audit de sécurité
SûrThis 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.
Score de qualité
Ce que vous pouvez construire
Réponse aux incidents de production
Enquêter rapidement pourquoi les messages WhatsApp ne sont pas livrés aux clients pendant un incident actif.
Débogage de webhooks
Inspecter les tentatives de livraison de webhooks pour comprendre pourquoi les messages entrants ou les mises à jour de statut ne sont pas reçus.
Surveillance de la santé
Exécuter des vérifications de santé périodiques sur les numéros de téléphone et les projets pour détecter de manière proactive les problèmes avant qu'ils n'impactent les utilisateurs.
Essayez ces prompts
Je dois vérifier si un message WhatsApp a été livré. Le numéro de téléphone est +1234567890. Aidez-moi à trouver la conversation et vérifiez son statut de livraison.
Notre point de terminaison webhook a cessé de recevoir des événements de WhatsApp. Utilisez le script webhook-deliveries pour vérifier les tentatives de livraison récentes et identifier les modèles d'erreur.
Nous constatons une augmentation des erreurs de messages en production. Effectuez le tri complet des erreurs : vérifiez les erreurs de messages, examinez les journaux API et identifiez les échecs de livraison de webhooks. Résumez la cause racine.
Exécutez une v��rification de santé sur l'ID de numéro de téléphone <id> et générez un rapport de statut. Incluez tous les indicateurs de santé échoués et les étapes de remédiation recommandées.
Bonnes pratiques
- Vérifiez toujours les erreurs de messages et les journaux API ensemble pour corréler les échecs avec les causes racines
- Exécutez les vérifications de santé de manière proactive avant de déployer des modifications aux intégrations WhatsApp
- Utilisez le script lookup-conversation pour obtenir le contexte complet lors de l'investigation de problèmes de messages individuels
Éviter
- N'exécutez pas les scripts de diagnostic de manière répétée en succession rapide, car cela pourrait limiter le taux d'accès API
- N'utilisez pas cette compétence pour la configuration ou les modifications de webhooks
- Évitez d'investiguer des problèmes sans vérifier d'abord que les identifiants API sont valides et non expirés