| --- |
| title: WhatsApp Bot |
| emoji: 💬 |
| colorFrom: green |
| colorTo: blue |
| sdk: docker |
| app_port: 7860 |
| pinned: false |
| thumbnail: >- |
| https://cdn-uploads.huggingface.co/production/uploads/69ef44f7daf9d56653d76e81/D9XBNpMMZAIZyMhg2nLS1.jpeg |
| --- |
| |
| # 💬 WhatsApp Bot on Hugging Face |
|
|
| A WhatsApp chatbot powered by AI, deployed as a Docker Space on Hugging Face. |
|
|
| ## Architecture |
|
|
| ``` |
| WhatsApp Cloud API (Meta) |
| │ |
| ▼ HTTPS webhooks |
| https://miftahulkhairim-whatsapp-bot.hf.space/webhook |
| │ |
| ▼ |
| HF Docker Space (FastAPI, port 7860) |
| ├── GET /webhook → Meta webhook verification |
| ├── POST /webhook → Receive message → AI reply → Send via WhatsApp API |
| └── GET / → Dashboard UI |
| ``` |
|
|
| ## Setup Guide |
|
|
| ### 1. Meta Developer Portal Setup |
|
|
| 1. Go to [developers.facebook.com](https://developers.facebook.com) → **Create App** → Choose **Business** type |
| 2. Add the **WhatsApp** product to your app |
| 3. In WhatsApp → Getting Started, note your: |
| - **Phone Number ID** |
| - **WhatsApp Business Account ID** |
| - **Temporary Access Token** (for testing) |
| 4. Go to WhatsApp → Configuration → Webhook: |
| - **Callback URL**: `https://miftahulkhairim-whatsapp-bot.hf.space/webhook` |
| - **Verify Token**: Choose any secret string (e.g., `my_verify_token_2024`) |
| - Subscribe to: `messages` |
|
|
| ### 2. HF Space Secrets |
|
|
| Go to Space Settings → **Repository Secrets** and add: |
|
|
| | Secret Name | Value | |
| |---|---| |
| | `WHATSAPP_VERIFY_TOKEN` | Your chosen verify token string | |
| | `WHATSAPP_TOKEN` | Meta access token (from Developer Portal) | |
| | `PHONE_NUMBER_ID` | Your WhatsApp Phone Number ID | |
| | `HF_TOKEN` | Your HF token (for AI inference) | |
|
|
| ### 3. Deploy |
|
|
| The Space auto-builds and deploys when you push changes. |
|
|
| ## Features |
|
|
| - 🤖 AI-powered responses using Hugging Face Inference API |
| - 💬 Handles text messages from WhatsApp |
| - 📊 Web dashboard showing bot status and recent messages |
| - 🔒 Secure webhook verification |
| - ⚡ Async message processing for fast responses |
|
|
| ## Notes |
|
|
| - Free Spaces sleep after ~15 min of inactivity. Consider upgrading to paid hardware for always-on availability. |
| - Access tokens from Meta expire. Use a **System User** permanent token for production. |
