# Twilio Calling Skill

Outbound voice calling for approval escalation and customer outreach.

## Capabilities

1. **Approval Escalation**
   - Orange decisions: call Shay after 120 minutes no response
   - Red decisions: call immediately
   - Capture voice approval and proceed

2. **Customer Calling**
   - Outbound sales/support calls on demand
   - Conversational AI with context from Oliver
   - Call summary and next actions logged

## Twilio Setup

Credentials stored in `.env`:
- Account SID: AC1ffed788804bd5586e86a1e4787396c0
- Auth Token: (secured)
- Phone number: +16625910155

Voice config:
- Voice: female, Australian English
- Tone: conversational

## Usage

### Test Call
```
Call me to test the setup
```

### Approval Escalation (automatic)
Triggered when:
- Orange decision pending >120 minutes
- Red decision requires immediate approval

### Customer Calling
```
Call [customer name/number] about [topic]
[Provide context: their history, what to discuss, desired outcome]
```

## Implementation

See `scripts/`:
- `make-call.js` — core Twilio calling logic
- `approval-handler.js` — decision escalation webhook
- `customer-call.js` — outbound customer call flow

## Security

- Credentials in `.env` (gitignored)
- Call recordings stored locally, not on Twilio
- Customer data never logged in plain text