Dê ao seu assistente o contrato, os exemplos e acesso de leitura aos eventos da academia. Ele pode ajudar a construir o receptor e conferir o resultado com você.
WELLBHOOK_API_KEY. Ela permite consultar os dados da sua academia no ambiente escolhido. O segredo de assinatura do webhook é outro valor e fica no servidor do receptor.O MCP usa a mesma chave da API: somente leitura, restrita à academia e ao ambiente da chave. Configuração de webhook, simulação e aprovação não são ferramentas do MCP. Faça as ações operacionais no painel.
Extraia o ZIP. A pasta wellbhook/ reúne a skill e os pacotes locais para Codex e Claude Code. Revise os arquivos antes de instalar no projeto.
Copie wellbhook/skills/wellbhook-integration/ para .agents/skills/ do seu projeto. Abra uma nova sessão e peça para usar a skill wellbhook-integration.
Para adicionar o MCP, execute:
codex mcp add wellbhook \ --url https://wellbhook.com.br/api/mcp \ --bearer-token-env-var WELLBHOOK_API_KEY
Com WELLBHOOK_API_KEY disponível no ambiente, abra o plugin local, que inclui a skill e a configuração MCP:
claude --plugin-dir ./wellbhook
Invoque /wellbhook:wellbhook-integration. Para usar apenas a skill, copie a pasta wellbhook/skills/wellbhook-integration/ para .claude/skills/ do projeto.
Defina a chave por um gerenciador de segredos ou entrada silenciosa antes de iniciar o cliente. Não cole o valor em prompts, arquivos versionados ou comandos que fiquem no histórico. O kit é uma instalação local; não exige publicação em marketplace.
Endpoint: https://wellbhook.com.br/api/mcp. Transporte Streamable HTTP, autenticado pelo cabeçalho Authorization: Bearer SUA_CHAVE. A configuração acima usa a variável de ambiente para preencher esse cabeçalho.
| Ferramenta | Como ajuda |
|---|---|
get_integration_guide | Consulta o contrato de integração, os eventos e as orientações para construir um receptor. |
list_checkins | Consulta check-ins com filtros e paginação no contexto autorizado pela chave. |
list_events | Consulta os eventos registrados, com ID, tipo, conteúdo e data de criação. |
Peça uma consulta com período, unidade e limite definidos. Para ampliar o resultado, use o cursor retornado em vez de repetir a primeira página. O agente não deve afirmar que consultou todo o histórico enquanto houver uma próxima página.
Um evento registrado não comprova a entrega HTTP ao receptor. Confira o estado de entrega e as tentativas na tela Webhooks do painel.
Uma chave DEMO não acessa LIVE, mesmo que o agente altere o filtro. Para retirar o acesso, revogue a chave em Configurações. Instalar a skill ou conectar o MCP não habilita nem homologa os conectores reais Wellhub e TotalPass.
Esta versão usa chave Bearer, sem fluxo OAuth. As instruções de plugin são para Claude Code; não representam um conector instalável no Claude web ou Desktop.
Use este roteiro depois de instalar a skill. O agente deve adaptar a persistência e os testes à arquitetura do sistema da academia.
Integre o Wellbhook ao sistema desta academia. 1. Leia a skill wellbhook-integration e o guia de integração. 2. Implemente um receptor HTTPS que verifique HMAC-SHA256 sobre timestamp + "." + corpo original, com tolerância de 5 minutos e comparação em tempo constante. 3. Persista o evento e deduplique por id em uma transação. Não dependa da ordem de entrega. Responda 2xx somente após persistência durável, inclusive para duplicados. 4. Separe DEMO de LIVE e preserve a identificação do provedor. 5. Teste assinatura inválida, replay, duplicidade e reenvio. 6. Use o MCP para consultar os eventos da demonstração e explique como configurar o destino no painel. Use variáveis de ambiente para os segredos. Não coloque chaves em código, mensagens, commits ou logs. Não trate um check-in aprovado como passagem comprovada por catraca.
WELLBHOOK_WEBHOOK_SECRET no seu servidor.Webhooks podem chegar fora de ordem e mais de uma vez. Preserve o ID para deduplicação, aceite versões conhecidas do envelope e mantenha transições de estado consistentes. A resposta 2xx confirma o recebimento persistido do evento; não deve esconder uma falha ao salvar.
Os arquivos abaixo são públicos e não exigem chave. Eles descrevem a integração; dados da academia continuam protegidos pela API e pelo MCP.
Confira se WELLBHOOK_API_KEY está disponível no processo que iniciou o cliente e se a chave não foi revogada. Use uma chave de API criada em Configurações, não o segredo de assinatura do webhook.
Confira ambiente, unidade, período e paginação. Uma chave criada em Demonstração só consulta dados fictícios. Simule um check-in no painel para gerar os primeiros registros.
As três ferramentas disponíveis são de leitura. Configure conexões e webhooks, simule check-ins e reenvie entregas pela plataforma. O agente pode orientar essas etapas e construir o código do receptor.
Sim. Forneça os guias públicos e a skill ao assistente. Para consultar dados via MCP, o cliente precisa aceitar o transporte HTTP e o cabeçalho Bearer. Também é possível consultar a API de leitura diretamente.