Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openagno.com/llms.txt

Use this file to discover all available pages before exploring further.

When you develop locally with WhatsApp Cloud API, Meta needs a public HTTPS URL for webhook validation and incoming events. This page explains the fastest setup for developers and operators.

English

Option 1. ngrok

ngrok http 8000
Use the generated HTTPS URL as your webhook base URL.

Option 2. Cloudflare Tunnel

cloudflared tunnel --url http://localhost:8000
Use the generated public URL as your webhook base URL.

Meta webhook settings

Use these values in the Meta Developer Console:
  • Callback URL: https://your-public-url/whatsapp/webhook
  • Verify token: the same value you store in WHATSAPP_VERIFY_TOKEN

Development-only shortcut

If you need controlled local testing without a real signature:
WHATSAPP_SKIP_SIGNATURE_VALIDATION=true
Only use that in development.

Español

Opción 1. ngrok

ngrok http 8000
Usa la URL HTTPS generada como base del webhook.

Opción 2. Cloudflare Tunnel

cloudflared tunnel --url http://localhost:8000
Usa la URL pública generada como base del webhook.

Configuración en Meta

En Meta Developer Console usa:
  • Callback URL: https://tu-url-publica/whatsapp/webhook
  • Verify token: el mismo valor que guardas en WHATSAPP_VERIFY_TOKEN

Atajo solo para desarrollo

Si necesitas pruebas locales controladas sin firma real:
WHATSAPP_SKIP_SIGNATURE_VALIDATION=true
Úsalo solo en desarrollo.