observe-whatsapp
Depurar problemas de entrega de mensagens WhatsApp e webhooks
Solucione problemas de produção do WhatsApp com eficiência. Esta skill oferece comandos para inspecionar a entrega de mensagens, depurar falhas de webhooks e executar verificações de integridade na plataforma Kapso.
Baixar o ZIP da skill
Upload no Claude
Vá em Configurações → Capacidades → Skills → Upload skill
Ative e comece a usar
Testar
A utilizar "observe-whatsapp". Verificar entrega de mensagens para o número de telefone +1234567890
Resultado esperado:
Encontradas 3 mensagens para +1234567890. ID de mensagem msg_abc123: entregue em 2024-01-15 10:30:00. ID de mensagem msg_def456: pendente (webhook não reconhecido). ID de mensagem msg_ghi789: falhou - destinatário optou por não receber.
A utilizar "observe-whatsapp". Mostrar status de entrega de webhook na última hora
Resultado esperado:
Resumo de entregas de webhook: 45 com sucesso, 3 falharam. Entregas falhadas: 503 Serviço Indisponível do endpoint de webhook às 10:15, 10:22, 10:45. Contagem de repetições: 3/3. Recomendamos verificar a integridade do servidor de webhook.
Auditoria de Segurança
SeguroThis 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.
Pontuação de qualidade
O Que Você Pode Construir
Resposta a incidentes de produção
Investigue rapidamente por que as mensagens WhatsApp não estão sendo entregues aos clientes durante um incidente ativo.
Depuração de webhook
Inspecione as tentativas de entrega de webhook para entender por que mensagens recebidas ou atualizações de status não estão sendo recebidas.
Monitoramento de integridade
Execute verificações periódicas de integridade em números de telefone e projetos para detectar proativamente problemas antes que impactem os usuários.
Tente Estes Prompts
Preciso verificar se uma mensagem WhatsApp foi entregue. O número de telefone é +1234567890. Ajude-me a encontrar a conversa e verificar seu status de entrega.
Nosso endpoint de webhook parou de receber eventos do WhatsApp. Use o script webhook-deliveries para verificar tentativas de entrega recentes e identificar padrões de erro.
Estamos vendo erros aumentados de mensagens em produção. Execute a triagem completa de erros: verifique erros de mensagens, revise logs de API e identifique quaisquer falhas de entrega de webhook. Resuma a causa raiz.
Execute uma verificação de integridade no ID de número de telefone <id> e gere um relatório de status. Inclua quaisquer indicadores de integridade falhados e etapas de remediação recomendadas.
Melhores Práticas
- Sempre verifique erros de mensagens e logs de API juntos para correlacionar falhas com causas raiz
- Execute verificações de integridade proativamente antes de Implantar alterações em integrações WhatsApp
- Use o script lookup-conversation para obter contexto completo ao investigar problemas individuais de mensagens
Evitar
- Não execute scripts de diagnóstico repetidamente em rápida sucessão, pois isso pode limitar o acesso à API
- Não use esta skill para configuração ou alteração de setup de webhook
- Evite investigar problemas sem primeiro verificar se as credenciais da API são válidas e não expiraram