observe-whatsapp
Debug WhatsApp message delivery and webhook issues
Troubleshoot WhatsApp production issues efficiently. This skill provides commands to inspect message delivery, debug webhook failures, and run health checks on the Kapso platform.
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". Check message delivery for phone number +1234567890
RĂ©sultat attendu:
Found 3 messages for +1234567890. Message ID msg_abc123: delivered at 2024-01-15 10:30:00. Message ID msg_def456: pending (webhook not acknowledged). Message ID msg_ghi789: failed - recipient opted out.
Utilisation de "observe-whatsapp". Show webhook delivery status for the last hour
RĂ©sultat attendu:
Webhook deliveries summary: 45 successful, 3 failed. Failed deliveries: 503 Service Unavailable from webhook endpoint at 10:15, 10:22, 10:45. Retry count: 3/3. Recommend checking webhook server health.
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
Production incident response
Quickly investigate why WhatsApp messages are not being delivered to customers during an active incident.
Webhook debugging
Inspect webhook delivery attempts to understand why incoming messages or status updates are not being received.
Health monitoring
Run periodic health checks on phone numbers and projects to proactively detect issues before they impact users.
Essayez ces prompts
I need to check if a WhatsApp message was delivered. The phone number is +1234567890. Help me find the conversation and check its delivery status.
Our webhook endpoint stopped receiving events from WhatsApp. Use the webhook-deliveries script to check recent delivery attempts and identify any error patterns.
We're seeing increased message errors in production. Run through the full error triage: check message errors, review API logs, and identify any webhook delivery failures. Summarize the root cause.
Run a health check on phone number ID <id> and generate a status report. Include any failed health indicators and recommended remediation steps.
Bonnes pratiques
- Always check message errors and API logs together to correlate failures with root causes
- Run health checks proactively before deploying changes to WhatsApp integrations
- Use the lookup-conversation script to get full context when investigating individual message issues
Éviter
- Do not run diagnostic scripts repeatedly in quick succession, as this may rate-limit API access
- Do not use this skill for webhook setup or configuration changes
- Avoid investigating issues without first verifying that API credentials are valid and not expired