القائمة
Setup de webhook receiver FastAPI para Meta Cloud API substituindo integracao bugada da Evolution API.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Sistema de planejamento diario baseado em markdown para equipe multi-agente. Fluxo completo de 6 fases planejar, aprovar, delegar, executar, auditar, registrar.
Correção do bug de timezone no script fechamento_diario.sh. O date capturava UTC, causando data errada quando executado próximo à meia-noite BRT.
Diagnóstico e correção de CSS quebrado em produção com Express, EJS, PM2 e Cloudflare. Cobre cache busting, restauração de classes perdidas, migração de syntax highlighting, e verificação de cache CDN.
Procedimento para upgrade da Evolution API v2.3.7 → v2.4.0-rc2, ativação de licença, e integração com Meta Cloud API (WhatsApp Oficial). Inclui pitfalls de Cloudflare Tunnel, nginx, e licenciamento.
Pipeline de 3 fases para gerar documentos grandes com Gemini CLI sem estourar limite de contexto. Extração em lotes → compilação → blueprint. Reutilizável para PRDs, especificações técnicas, documentação extensa.
Arquitetura de agente Hermes Utility — dedicado exclusivamente a git versionamento de vault Obsidian. Memory desligado, sem criação de conteudo, apenas pull/commit/push sob autorizacao.
| name | meta-webhook-receiver-setup |
| description | Setup de webhook receiver FastAPI para Meta Cloud API substituindo integracao bugada da Evolution API. |
| category | devops |
A integracao nativa da Evolution API v2.4.0 com Meta Cloud API eh instavel. Usar um receiver FastAPI proprio.
WhatsApp → Meta Cloud API → Cloudflare Tunnel (subdominio SEM Access) → Nginx location /webhook/meta → proxy para host porta 8002 → FastAPI PM2.
{{COMMANDER_HOME}}/projects/meta-webhook/webhook_meta.py com FastAPI (endpoints GET/POST /webhook/meta).env.meta com META_VERIFY_TOKEN e META_ACCESS_TOKENpython3 -m venv .venv && .venv/bin/pip install fastapi uvicorn python-dotenvpm2 start webhook_meta.py --name webhook-meta --interpreter .venv/bin/python na porta 8002location /webhook/meta com proxy_pass http://172.18.0.1:8002; (172.18.0.1 = gateway da bridge Docker para o host)sudo ufw allow from 172.18.0.0/16 to any port 8002 proto tcpwebhook.oesteodontologia.com.br → localhost:80 no painel Zero Trust (gerenciamento remoto, não editar /etc/cloudflared/config.yml)WHATSAPP-BUSINESS no Evolution é inútil — deletar via manager ou API.sudo ufw allow from 172.18.0.0/16 to any port 8002 proto tcpsudo journalctl -u cloudflared | grep "config=". Se aparecerem hostnames que nao estao no /etc/cloudflared/config.yml, o tunnel eh gerenciado via Cloudflare Zero Trust dashboard (Networks → Tunnels). Editar la, nao no arquivo local.docker restart oeste-odontologia-nginxhomolog (19/05/2026) tem bug de FK constraint Setting_instanceId_fkey. rc2 (17/05/2026) funciona para criar instancias mas processa mensagens com TypeError. Usar webhook proprio em vez de depender da Evolution para Meta.docker compose stop evolution-api evolution-postgres evolution-redis && docker rm evolution-api evolution-postgres evolution-redis && docker volume rm oeste-odontologia_evolution_postgres_data oeste-odontologia_evolution_data oeste-odontologia_evolution_redis_data && docker compose up -d evolution-postgres evolution-redis evolution-api| Sintoma | Causa provavel | Acao |
|---|---|---|
| 502 Bad Gateway via Cloudflare | Tunnel nao tem hostname configurado | Adicionar no Zero Trust dashboard |
| 502 so no subdominio webhook (outros OK) | Cloudflared com service errado (ex: nginx:80 em vez de localhost:80) | Tunnel gerenciado remotamente: corrigir no painel |
| Meta "Nao foi possivel validar" | Cloudflare Access ativo no subdominio | Remover Access do subdominio webhook |
| POST nao chega no receiver | Meta nao re-verificou webhook apos mudanca | Clicar "Verify and Save" no Developer Dashboard |
| Docker exec timeout constante | Daemon Docker sobrecarregado ou container pesado | Reiniciar container afetado |
integrationSession.update() FK constraint | v2.4.0-homolog com migration quebrada | Usar rc2 ou resetar banco |
Cannot read properties of undefined | Bug na v2.4.0 ao processar mensagens Meta | Abandonar Evolution para Meta; usar receiver proprio |