README.md

---
title: ByteMe Outreach Service
emoji: 📱
colorFrom: indigo
colorTo: green
sdk: docker
app_port: 7860
pinned: false
license: mit
---

# ByteMe Outreach Service

Twilio-powered Call & SMS outreach service deployed on Hugging Face Spaces.

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| GET | `/health` | Health check |
| POST | `/campaign/initiate/phonecall/{number}` | Initiate outbound voice call |
| POST | `/campaign/initiate/sms/{number}` | Send personalized SMS |
| GET | `/campaign/twiml/{call_id}` | TwiML webhook (Twilio) |
| POST | `/campaign/response` | DTMF response webhook (Twilio) |
| GET | `/campaign/status/{call_id}` | Poll call outcome |
| GET | `/campaign/sms/status/{sms_id}` | Poll SMS outcome |

## Required Secrets

Set these in **Space Settings → Repository Secrets**:

- `TWILIO_ACCOUNT_SID`
- `TWILIO_AUTH_TOKEN`
- `TWILIO_PHONE_NUMBER`
- `BASE_WEBHOOK_URL` — your Space URL, e.g. `https://<username>-byteme-outreach-service.hf.space`