ZapHook Skills

Skills oficiais do ZapHook para agentes de IA. Permite que agentes como Kiro CLI, Claude Code, Gemini CLI e outros gerenciem canais WhatsApp, enviem mensagens e monitorem eventos via API pública do ZapHook.

Instalação

npx zaphook-skills install

Configuração

npx zaphook-skills configure

Informe sua API Key (gerada no dashboard do ZapHook) e a base URL será configurada automaticamente. As credenciais ficam salvas em ~/.zaphook/config.json e não precisam ser informadas novamente.

Skills disponíveis

zaphook-api

Gerenciamento de canais e destinations. Criar, listar, atualizar e deletar canais. Configurar destinations para receber webhooks. Verificar saúde do número (WABA Health).

whatsapp-messaging

Envio de mensagens WhatsApp: texto, botões, listas, imagens, vídeo, áudio, documentos, stickers, localização, contatos, reações, templates e indicador de digitação.

observe-whatsapp

Monitoramento e debug de eventos: listar logs de webhook, filtrar por tipo/status/data, inspecionar payloads, verificar saúde do canal e gerenciar mídia.

Estrutura

~/.zaphook/
├── config.json          # API key e base URL (configurado uma vez)
├── lib/
│   ├── http.mjs         # Cliente HTTP compartilhado
│   └── config.mjs       # Leitor de configuração
└── skills/
    ├── zaphook-api/
    ├── whatsapp-messaging/
    └── observe-whatsapp/

Uso com agentes de IA

Após instalar e configurar, qualquer agente de IA com acesso ao filesystem consegue ler os SKILL.md e executar os scripts automaticamente:

# Kiro CLI
kiro-cli chat --agent zaphook

# Claude Code
claude -p "liste meus canais do zaphook"

Comandos disponíveis

| Comando | Descrição | |---------|-----------| | npx zaphook-skills install | Instala skills em ~/.zaphook/ | | npx zaphook-skills configure | Configura API key e base URL | | npx zaphook-skills status | Mostra config e skills instaladas | | npx zaphook-skills help | Mostra ajuda |

Requisitos

• Node.js 18+
• API Key do ZapHook (gere no dashboard)

Licença

MIT