elevenlabs-webhook-nodejs 1.0.0

package/docs/database.md

@@ -0,0 +1,456 @@
+# Database Schema Documentation
+
+MongoDB database schema for Portal Asistan 7/24. All models use Mongoose ODM.
+
+---
+
+## 1. Tenant
+
+**Collection:** `tenants`
+**Description:** Multi-tenant root entity. Each clinic/business is a tenant.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `name` | String | yes | — | Clinic/business name |
+| `plan` | String | yes | `'free'` | Subscription plan slug |
+| `enabled_features` | String[] | no | `[]` | Active feature flags: `inbound_agent`, `outbound_campaigns`, `survey_builder`, `whatsapp_notifications`, `whatsapp_agent` |
+| `settings.kvkk_consent` | Boolean | no | `false` | KVKK (Turkish GDPR) consent flag |
+| `settings.notification_recipients` | String[] | no | `[]` | Email/phone list for notifications |
+| `settings.default_language` | String | no | `'tr'` | Default language code |
+| `settings.whatsapp_agent` | Object | no | — | WhatsApp agent configuration (see below) |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+### `settings.whatsapp_agent` sub-document
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `whatsapp_bridge_provider` | `'unipile'` \| `'baileys'` | `'unipile'` | Which WhatsApp bridge to use |
+| `unipile_account_id` | String \| null | `null` | Bridge account identifier |
+| `unipile_account_status` | String \| null | `null` | Bridge connection status |
+| `agent_id` | ObjectId \| null | `null` | Ref → `Agent`. The ElevenLabs agent for this tenant |
+| `connected_at` | Date \| null | `null` | When WhatsApp was connected |
+| `connected_phone` | String \| null | `null` | Connected WhatsApp phone number |
+| `grace_period_seconds` | Number | `180` | Wait time before AI takes over a new session |
+| `blacklisted_numbers` | String[] | `[]` | Phone numbers excluded from AI |
+| `ai_shift_enabled` | Boolean | `false` | Whether clinic-hours schedule is active |
+| `ai_shift_schedule` | Array | `[]` | Per-day schedule entries `{ day: 0-6, start: "HH:MM", end: "HH:MM" }` |
+| `fixed_first_message_enabled` | Boolean | `false` | Send a fixed first message instead of AI greeting |
+| `fixed_first_message` | String | `''` | The fixed first message text |
+| `profile_agent_id` | ObjectId \| null | `null` | Ref → `Agent`. Agent used for contact profile summarization |
+
+---
+
+## 2. User
+
+**Collection:** `users`
+**Description:** User accounts. Each user belongs to a tenant.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `email` | String | yes | — | Unique, lowercase, trimmed |
+| `password_hash` | String | yes | — | Bcrypt hash |
+| `role` | String | yes | `'viewer'` | `superadmin` \| `admin` \| `manager` \| `viewer` |
+| `name` | String | yes | — | Display name |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+**Indexes:** `tenant_id`, `email` (unique)
+
+---
+
+## 3. RefreshToken
+
+**Collection:** `refreshtokens`
+**Description:** JWT refresh tokens with automatic TTL expiry.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `user_id` | ObjectId | yes | — | Ref → `User` |
+| `token` | String | yes | — | Unique token string |
+| `expires_at` | Date | yes | — | Expiration timestamp |
+| `createdAt` | Date | auto | — | |
+
+**Indexes:** `user_id`, `token` (unique), `expires_at` (TTL — MongoDB auto-deletes expired docs)
+
+---
+
+## 4. Agent
+
+**Collection:** `agents`
+**Description:** ElevenLabs conversational AI agents. Used for both phone calls and WhatsApp.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `phone_number` | String | yes | — | Phone number assigned to agent |
+| `elevenlabs_agent_id` | String | yes | — | ElevenLabs platform agent ID |
+| `direction` | String | yes | — | `inbound` \| `outbound` \| `both` |
+| `agent_template` | String | yes | — | `receptionist` \| `survey` \| `custom` |
+| `config.voice_id` | String | yes | — | ElevenLabs voice ID |
+| `config.language` | String | no | `'tr'` | Language code |
+| `config.greeting` | String | no | `''` | Greeting message |
+| `config.template_data` | Mixed | no | `{}` | Template-specific config |
+| `post_call_processing.strategy` | String | no | `'summarize'` | `summarize` \| `extract_survey` \| `summarize_and_extract` \| `none` |
+| `post_call_processing.llm_provider` | String | no | `'openai'` | `openai` \| `gemini` |
+| `post_call_processing.whatsapp_notify` | Boolean | no | `true` | Send WhatsApp notification after call |
+| `post_call_processing.notification_template` | String | no | `'call_summary'` | `call_summary` \| `survey_progress` \| `custom` |
+| `post_call_processing.summary_prompt` | String | no | `''` | Custom LLM prompt for summarization |
+| `post_call_processing.system_message` | String | no | `''` | System message for LLM |
+| `post_call_processing.whatsapp_message_template` | String | no | `''` | WhatsApp notification template |
+| `is_active` | Boolean | no | `true` | Whether agent is active |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+**Indexes:** `tenant_id`, `elevenlabs_agent_id`
+
+---
+
+## 5. Plan
+
+**Collection:** `plans`
+**Description:** Subscription plans with pricing and minute allocations.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `name` | String | yes | — | Plan display name |
+| `slug` | String | yes | — | Unique URL-friendly identifier |
+| `price` | Number | yes | — | Monthly price |
+| `included_minutes` | Number | yes | — | Minutes included per month |
+| `overage_rate` | Number | yes | — | Cost per extra minute |
+| `language_support` | String | no | `'single'` | `single` \| `dual` \| `multi` |
+| `is_active` | Boolean | no | `true` | Whether plan is available |
+| `sort_order` | Number | no | `0` | Display ordering |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+**Indexes:** `slug` (unique)
+
+---
+
+## 6. BillingEvent
+
+**Collection:** `billingevents`
+**Description:** Financial transaction log (charges, subscriptions, top-ups, refunds).
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `type` | String | yes | — | `call_charge` \| `subscription` \| `top_up` \| `refund` |
+| `amount` | Number | yes | — | Transaction amount |
+| `currency` | String | no | `'TRY'` | Currency code |
+| `call_id` | ObjectId \| null | no | `null` | Ref → `Call` (for call charges) |
+| `param_transaction_id` | String \| null | no | `null` | External transaction ID |
+| `description` | String | no | `''` | Human-readable description |
+| `createdAt` | Date | auto | — | |
+
+**Indexes:** `{ tenant_id, createdAt: -1 }`
+
+---
+
+## 7. Payment
+
+**Collection:** `payments`
+**Description:** Manually recorded payments (cash, bank transfer).
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `type` | String | no | `'subscription'` | `subscription` \| `top_up` |
+| `plan_slug` | String | yes | — | Plan identifier |
+| `plan_name` | String | yes | — | Plan display name (snapshot) |
+| `amount` | Number | yes | — | Payment amount |
+| `extra_minutes` | Number | no | `0` | Additional minutes purchased |
+| `period_start` | Date | yes | — | Billing period start |
+| `period_end` | Date | yes | — | Billing period end |
+| `payment_method` | String | no | `'cash'` | `cash` \| `bank_transfer` \| `other` |
+| `notes` | String | no | `''` | Admin notes |
+| `recorded_by` | ObjectId | yes | — | Ref → `User`. Who recorded the payment |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+**Indexes:** `tenant_id`
+
+---
+
+## 8. Survey
+
+**Collection:** `surveys`
+**Description:** Survey templates with branching logic, used in outbound campaigns.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `name` | String | yes | — | Survey name |
+| `description` | String | no | `''` | Survey description |
+| `questions` | Array | no | `[]` | Survey questions (see below) |
+| `status` | String | no | `'draft'` | `draft` \| `active` \| `archived` |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+### `questions[]` sub-document
+
+| Field | Type | Required | Default | Description |
+|-------|------|---------|---------|-------------|
+| `id` | String | yes | — | Question identifier |
+| `text` | String | yes | — | Question text |
+| `type` | String | yes | — | `open` \| `multiple_choice` \| `rating` \| `yes_no` |
+| `options` | String[] | no | `[]` | Answer choices (for multiple_choice) |
+| `required` | Boolean | no | `true` | Whether answer is required |
+| `branch_logic` | Object \| null | no | `null` | `{ condition: string, go_to: string }` |
+
+**Indexes:** `tenant_id`
+
+---
+
+## 9. Campaign
+
+**Collection:** `campaigns`
+**Description:** Outbound call campaigns that dial a phone list using a survey + agent.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `survey_id` | ObjectId | yes | — | Ref → `Survey` |
+| `agent_id` | ObjectId | yes | — | Ref → `Agent` |
+| `name` | String | yes | — | Campaign name |
+| `status` | String | no | `'draft'` | `draft` \| `scheduled` \| `running` \| `paused` \| `completed` |
+| `phone_list` | Array | no | `[]` | Phone entries (see below) |
+| `schedule` | Object | yes | — | Scheduling config (see below) |
+| `stats` | Object | no | zeros | Aggregated call stats |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+### `phone_list[]` sub-document
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `number` | String | — | Phone number to call |
+| `status` | String | `'pending'` | `pending` \| `completed` \| `failed` \| `no_answer` \| `voicemail` |
+| `attempts` | Number | `0` | Number of call attempts |
+| `last_attempt_at` | Date \| null | `null` | Last attempt timestamp |
+
+### `schedule` sub-document
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `start_date` | Date | — | Campaign start date |
+| `end_date` | Date | — | Campaign end date |
+| `daily_start_time` | String | `'09:00'` | Daily calling window start |
+| `daily_end_time` | String | `'18:00'` | Daily calling window end |
+| `days_of_week` | Number[] | `[1,2,3,4,5]` | Days to call (0=Sun..6=Sat) |
+| `max_concurrent_calls` | Number | `1` | Max parallel calls |
+| `max_retries` | Number | `3` | Max retries per phone |
+| `retry_delay_minutes` | Number | `60` | Delay between retries |
+
+### `stats` sub-document
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `total` | Number | `0` | Total phone entries |
+| `completed` | Number | `0` | Successfully completed calls |
+| `failed` | Number | `0` | Failed calls |
+| `no_answer` | Number | `0` | No answer calls |
+| `voicemail` | Number | `0` | Voicemail calls |
+| `pending` | Number | `0` | Remaining calls |
+
+**Indexes:** `{ tenant_id, status }`
+
+---
+
+## 10. Call
+
+**Collection:** `calls`
+**Description:** Individual phone call records (inbound and outbound).
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `agent_id` | ObjectId | yes | — | Ref → `Agent` |
+| `campaign_id` | ObjectId \| null | no | `null` | Ref → `Campaign` (outbound only) |
+| `conversation_id` | String | no | `null` | ElevenLabs conversation ID |
+| `direction` | String | yes | — | `inbound` \| `outbound` |
+| `caller_number` | String | yes | — | Calling phone number |
+| `callee_number` | String | yes | — | Called phone number |
+| `duration_seconds` | Number | no | `0` | Call duration |
+| `start_time` | Date \| null | no | `null` | Call start timestamp |
+| `end_time` | Date \| null | no | `null` | Call end timestamp |
+| `termination_reason` | String \| null | no | `null` | Why call ended |
+| `cost` | Number \| null | no | `null` | ElevenLabs cost |
+| `call_language` | String \| null | no | `null` | Detected language |
+| `elevenlabs_status` | String \| null | no | `null` | ElevenLabs call status |
+| `status` | String | yes | — | `completed` \| `failed` \| `no_answer` \| `voicemail` \| `transferred` |
+| `transcript` | String | no | `''` | Full call transcript |
+| `llm_summary` | String \| null | no | `null` | LLM-generated call summary |
+| `survey_responses` | Array \| null | no | `null` | Extracted survey answers `[{ question_id, question_text, answer, parsed_value }]` |
+| `whatsapp_notification_sent` | Boolean | no | `false` | Whether WhatsApp notification was sent |
+| `recording_url` | String \| null | no | `null` | Call recording URL |
+| `analysis` | Mixed \| null | no | `null` | Additional call analysis data |
+| `createdAt` | Date | auto | — | |
+
+**Indexes:** `{ tenant_id, createdAt: -1 }`, `{ campaign_id, status }`, `{ tenant_id, direction, createdAt: -1 }`, `conversation_id`
+
+---
+
+## 11. WhatsAppChat
+
+**Collection:** `whatsappchat`
+**Description:** A conversation thread between a contact and a tenant's WhatsApp number.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `unipile_chat_id` | String | yes | — | Bridge chat ID (Baileys: `{accountId}:{jid}`) |
+| `unipile_account_id` | String | yes | — | Bridge account ID |
+| `contact_name` | String | no | `'Bilinmiyor'` | Contact's display name |
+| `contact_phone` | String | no | `''` | Contact's phone number |
+| `is_closed` | Boolean | no | `false` | Whether chat is closed by operator |
+| `active_session_id` | ObjectId \| null | no | `null` | Ref → `WhatsAppSession`. Current active session |
+| `last_message_at` | Date | no | now | Timestamp of last message |
+| `last_message_preview` | String | no | `''` | First 100 chars of last message |
+| `message_count` | Number | no | `0` | Total messages in this chat |
+| `contact_profile_id` | ObjectId \| null | no | `null` | Ref → `WhatsAppContactProfile` |
+| `deleted_at` | Date \| null | no | `null` | Soft-delete timestamp |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+**Indexes:** `{ tenant_id, last_message_at: -1 }`, `unipile_chat_id` (unique)
+
+---
+
+## 12. WhatsAppSession
+
+**Collection:** `whatsappsessions`
+**Description:** A conversation session within a chat. Tracks AI agent lifecycle (waiting → active → resolved).
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `chat_id` | ObjectId | yes | — | Ref → `WhatsAppChat` |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `status` | String | no | `'waiting'` | `waiting` \| `active` \| `resolved` |
+| `resolved_by` | String \| null | no | `null` | `human` \| `ai_timeout` \| `timeout` \| `manual` \| `null` |
+| `started_at` | Date | no | now | Session start time |
+| `resolved_at` | Date \| null | no | `null` | When session was resolved |
+| `grace_deadline` | Date \| null | no | `null` | Deadline for grace period (human gets first chance) |
+| `taken_over_by` | ObjectId \| null | no | `null` | Ref → `User`. Human who took over from AI |
+| `taken_over_at` | Date \| null | no | `null` | When takeover happened |
+| `elevenlabs_conversation_id` | String \| null | no | `null` | ElevenLabs conversation ID |
+| `elevenlabs_conversation_created_at` | Date \| null | no | `null` | When EL conversation was created |
+| `elevenlabs_last_interaction_at` | Date \| null | no | `null` | Last AI interaction timestamp |
+| `elevenlabs_cost` | Number \| null | no | `null` | ElevenLabs conversation cost |
+| `message_count` | Number | no | `0` | Messages in this session |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+**Session Lifecycle:**
+1. **waiting** — Grace period active, human can respond first
+2. **active** — AI agent is handling the conversation
+3. **resolved** — Session ended (by human, timeout, or manual)
+
+**Indexes:** `{ chat_id, status }`, `{ status, grace_deadline }`, `{ tenant_id, status }`
+
+---
+
+## 13. WhatsAppMessage
+
+**Collection:** `whatsappmessages`
+**Description:** Individual messages within a WhatsApp chat.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `chat_id` | ObjectId | yes | — | Ref → `WhatsAppChat` |
+| `session_id` | ObjectId \| null | no | `null` | Ref → `WhatsAppSession`. Null if no active session |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `unipile_message_id` | String \| null | no | `null` | Bridge message ID |
+| `sender` | String | yes | — | `contact` \| `ai` \| `human` |
+| `sender_name` | String | no | `''` | Sender display name (AI messages: `'AI'`) |
+| `text` | String | yes | — | Message text content |
+| `sent_via_unipile` | Boolean | no | `false` | Whether sent through bridge (outgoing) |
+| `createdAt` | Date | auto | — | |
+
+**Indexes:** `{ chat_id, createdAt }`, `{ session_id, createdAt }`
+
+---
+
+## 14. WhatsAppContactProfile
+
+**Collection:** `whatsappcontactprofiles`
+**Description:** Persistent contact profile across all sessions. AI-summarized after each session.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `tenant_id` | ObjectId | yes | — | Ref → `Tenant` |
+| `phone` | String | yes | — | Contact phone number |
+| `display_name` | String | no | `'Bilinmiyor'` | Contact display name |
+| `notes` | String | no | `''` | Manual notes by operators |
+| `tags` | String[] | no | `[]` | Categorization tags |
+| `ai_summary` | String | no | `''` | AI-generated profile summary (updated after each session) |
+| `metadata` | Mixed | no | `{}` | Arbitrary metadata |
+| `first_seen_at` | Date | no | now | First contact timestamp |
+| `last_seen_at` | Date | no | now | Most recent contact timestamp |
+| `total_sessions` | Number | no | `0` | Total session count |
+| `total_messages` | Number | no | `0` | Total message count |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+**Indexes:** `{ tenant_id, phone }` (unique), `{ tenant_id, last_seen_at: -1 }`
+
+---
+
+## 15. Migration
+
+**Collection:** `migrations`
+**Description:** Tracks database migration history.
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| `_id` | ObjectId | auto | — | Primary key |
+| `name` | String | yes | — | Migration name (unique) |
+| `ran_at` | Date | yes | — | When migration was executed |
+| `duration_ms` | Number | yes | — | Execution time in milliseconds |
+| `status` | String | yes | — | `success` \| `failed` |
+| `error` | String \| null | no | `null` | Error message if failed |
+| `createdAt` | Date | auto | — | |
+| `updatedAt` | Date | auto | — | |
+
+**Indexes:** `name` (unique)
+
+---
+
+## Entity Relationship Overview
+
+```
+Tenant (1) ──── (*) User
+   │                  │
+   │                  └── RefreshToken (*)
+   │
+   ├──── (*) Agent
+   │          │
+   │          ├──── (*) Call
+   │          └──── (*) Campaign ──── (1) Survey
+   │
+   ├──── (*) WhatsAppChat
+   │          │
+   │          ├──── (1) WhatsAppContactProfile
+   │          ├──── (*) WhatsAppSession
+   │          └──── (*) WhatsAppMessage
+   │
+   ├──── (*) BillingEvent
+   ├──── (*) Payment
+   └──── (*) Plan (global, not per-tenant)
+```

package/docs/ornek-randevu-onay.csv

@@ -0,0 +1,3 @@
+Hasta Adi,Telefon,Randevu Tarihi,Randevu Saati,Doktor,Bolum,Not
+Talha Mert Karakoc,+905413346074,15.03.2026,10:30,Dr. Mehmet Oz,Ortopedi,Kontrol muayenesi
+Tiumrhan Cebeci,+905352622048,16.03.2026,14:00,Dr. Ayse Kaya,Dahiliye,Kan tahlili sonucu

package/ecosystem.config.js

@@ -0,0 +1,16 @@
+module.exports = {
+  apps: [
+    {
+      name: "asistan724-webhook",
+      script: "/var/www/asistan724-webhook-handler/dist/index.js",
+      cwd: "/var/www/asistan724-webhook-handler",
+      instances: 1,
+      autorestart: true,
+      watch: false,
+      max_memory_restart: "500M",
+      env: {
+        NODE_ENV: "production",
+      },
+    },
+  ],
+};