meta-webhook-receiver-setup

Set up a FastAPI Meta Cloud API webhook receiver with Nginx and Cloudflare Tunnel.

5|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill meta-webhook-receiver-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: meta-webhook-receiver-setup
Source: https://github.com/rafael-fae/agent-ops-worflow/tree/main/archive/skills/meta-webhook-receiver-setup
Command: npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill meta-webhook-receiver-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the instability and operational risk of relying on a buggy Evolution API integration for Meta Cloud API webhooks, giving you a dedicated receiver with clearer control and fewer failures.

Core Features & Use Cases

  • FastAPI webhook receiver setup: Creates a standalone GET/POST endpoint for Meta webhook verification and message handling.
  • Production deployment path: Covers PM2 process management, Nginx reverse proxying, UFW access rules, and Cloudflare Tunnel routing.
  • Operational troubleshooting: Documents common failure modes such as Cloudflare Access blocks, tunnel misconfiguration, Docker-to-host networking issues, and Evolution API bugs.
  • Use Case: Use it when you need to replace an unreliable WhatsApp/Meta integration with a private, controllable webhook service that can be verified and routed through your existing infrastructure.

Quick Start

Ask the AI to set up a FastAPI-based Meta Cloud API webhook receiver, configure the environment variables, deploy it behind Nginx and Cloudflare Tunnel, and remove the unused Evolution Meta instance once verification succeeds.

Frequently Asked Questions about meta-webhook-receiver-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a FastAPI webhook receiver for Meta Cloud API?

You can replace an unstable Evolution API integration by deploying a dedicated FastAPI webhook receiver. This private service handles Meta Cloud API verification and message ingestion directly, bypassing Evolution API bugs and giving you clearer operational control.

How do I expose a local FastAPI webhook to Meta using Cloudflare Tunnel and Nginx?

Expose a local FastAPI webhook to Meta by configuring Nginx as a reverse proxy to Uvicorn, then routing traffic through a Cloudflare Tunnel. You must also set UFW access rules to ensure the Meta Cloud API can reach the endpoint for verification.

Why does Meta webhook verification fail behind Cloudflare Tunnel?

Meta webhook verification fails behind Cloudflare Tunnel due to Cloudflare Access blocks, tunnel misconfiguration, or Docker-to-host networking issues. Correcting the tunnel routing and bypassing access policies for the verification endpoint resolves these failures.

Do I need PM2 and Uvicorn to deploy a Meta webhook receiver in production?

Yes, PM2 and Uvicorn are required to manage the FastAPI process for a Meta webhook receiver in production. PM2 ensures the Uvicorn server stays running continuously, preventing webhook ingestion downtime when handling WhatsApp messages.

What is the best way to replace an unstable Evolution API WhatsApp integration?

The best way to replace an unstable Evolution API WhatsApp integration is building a private FastAPI webhook receiver. Deployed with Nginx and Cloudflare Tunnel, it provides stable Meta Cloud API verification and direct message ingestion without third-party API bugs.