CRM wrap-up updates dialer master and writes student-wise history.

End-to-end flow

Status mapping

Dropdown values are CRM lead_status_val / tag_id codes. Dialer maps only these five for master updates:

Sub-disposition options (Status Remark modal) come from CRM table lead_tag_status_new where tag_id = the main status. They are stored on the history row as disposition_status / disposition_label; they do not change the dispose vs retry decision.

Schedule Callback modal statuses Payment (10) / Call Back (12) use /api/callbacks, not this disposition API.

Master updates

Table: fic_dialer_master_data, keyed by student_id (FIC / new_std_id).

Unlike hangup settle(), CRM dispose/retry does not require dial_status='Calling'. It works after wrap-up when the row is already Received / Not Connected / etc.

If the FIC id is not in master, history is still written (lead_found: false, master_updated: false). The engine will not dial disposed or Final Disposal rows.

History table

fic_dialer_disposition_history — migration 002_fic_dialer_disposition_history.sql.

vs call_attempts

Do not mix them: an answered call can later be tagged Not Interested in CRM. That is one attempt row (Received) plus one history row (dispose).

HTTP API

POST /api/dispositions — auth same as leads/callbacks (Authorization: Bearer WS_SECRET).

Copycurl -sS -X POST https://dialer.fastinfoclass.com/api/dispositions \
  -H "Authorization: Bearer YOUR_WS_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "student_id": "FIC178538363527762",
    "crm_std_id": 12345,
    "crm_lead_status": 4,
    "crm_lead_status_label": "Not Interested",
    "disposition_status": 12,
    "disposition_label": "Already enrolled",
    "remark": "Not interested in course",
    "tag_from": "fresh_tag",
    "agent_id": 42,
    "source": "crm"
  }'

Success shape includes action, dial_status_before/after, next_retry_at, master_updated, lead_found, history_id.

CRM wiring

Initial dropdown options are hardcoded in the view (same as AllData). They are not loaded from a dialer table. Sub-dispositions load via DialerController/tagDispositionStatus_new → lead_tag_status_new.

CRM config (critical)

On the live marketing server, in the exact application/config/config.php that CodeIgniter loads:

Copy$config['fic_dialer_api_base'] = 'https://dialer.fastinfoclass.com';
$config['fic_dialer_api_token'] = 'SAME_AS_DIALER_WS_SECRET';

If fic_dialer_api_base is missing, older DialerModel builds fell back to http://127.0.0.1:8000 — Postman on your laptop still worked, panel did not. Current DialerModel defaults to the public dialer host instead of localhost. Still set config correctly and reload PHP-FPM after upload.

FileZilla temp under /tmp/fz3temp-2/ is only a download copy. Live PHP reads the file under the webroot (e.g. /var/www/html/marketting/application/…).

Deploy

Dialer host

Copycd /opt/fic-dialer   # or your install path
git pull origin main
npm ci --omit=dev
npm run migrate      # applies 002_fic_dialer_disposition_history.sql
pm2 restart fic-dialer

Marketing / CRM host

Upload / sync at least:

• application/models/DialerModel.php
• application/controllers/DialerController.php
• Auto Dialer view table-v2.php (path as deployed)
• application/config/config.php with fic_dialer_api_*

Copysudo systemctl reload php-fpm   # or httpd / apache2
grep -n fic_dialer_api application/config/config.php

Verify

Report queries

Copy-- Latest wrap-ups for one student
SELECT student_id, crm_std_id, crm_lead_status_label, action,
       disposition_label, remark, agent_id, next_retry_at, created_at
FROM fic_dialer_disposition_history
WHERE student_id = 'FIC178538363527762'
ORDER BY created_at DESC;

-- Counts by disposition today
SELECT crm_lead_status, crm_lead_status_label, action, COUNT(*) AS n
FROM fic_dialer_disposition_history
WHERE created_at >= CURDATE()
GROUP BY crm_lead_status, crm_lead_status_label, action
ORDER BY n DESC;

-- Join telephony attempts (optional)
SELECT h.created_at AS tagged_at, h.crm_lead_status_label, h.action,
       a.tried_at, a.dial_status AS attempt_status, a.duration_seconds
FROM fic_dialer_disposition_history h
LEFT JOIN fic_dialer_call_attempts a
  ON a.student_id = h.student_id
 AND a.tried_at <= h.created_at
WHERE h.student_id = 'FIC178538363527762'
ORDER BY h.created_at DESC, a.tried_at DESC;

Troubleshooting

Code map (dialer): src/http/routes/disposition.routes.js → controller → disposition.service.js → lead.repository dispose/retry + disposition.repository insert. CRM map: DialerModel::push_disposition_to_dialer.