NOTICE: All information contained herein is, and remains
the property of TechnoCore Automate.
Updated : 2026-03-20
ObjHookHCScoreWA handles inbound WhatsApp lead scoring
webhooks. When a WhatsApp lead arrives, the hook:
bloom_hcscorewa_payloadbloom_hcscore formatHCSCORE workflow (bureau check + scoring)WhatsApp Lead -> bloom_hcscorewa_payload
|
ObjHookHCScoreWA.Process()
|
_normalize_payload()
-> Extract DOB from SA ID number
-> Infer gender from ID digit 7
-> Set defaults (country=SA, scorecard=1, etc.)
-> INSERT INTO bloom_hcscore
|
ObjWorkflow.Run("HCSCORE", guid)
-> Bureau check via AO system
-> Credit scoring pipeline
|
_forward_to_gateway()
-> Read CellNo, IDNumber, ShortCode
-> POST to hcawsgateway.technocore.co.za
-> Triggers HC account origination
Raw inbound payload from WhatsApp. Key fields:
| Field | Description |
|---|---|
| _guid | Record identifier |
| Guid | WhatsApp GUID |
| CellNo | Customer cell number |
| IDNumber | SA ID number (13 digits) |
| ShortCode | SMS shortcode for routing |
Normalized scoring record. Derived fields:
| Field | Source | Logic |
|---|---|---|
| Dob | IDNumber | First 6 digits -> YYYYMMDD |
| Gender | IDNumber | Digit 7: <5=F, >=5=M |
| Department | ShortCode | Mapped from shortcode |
| Leadorigin | Static | Always 14 (WhatsApp) |
POST https://hcawsgateway.technocore.co.za/webhook.py
Content-Type: application/json
User-Agent: Whatsapp
{
"content": "<IDNumber> | Whatsapp",
"smsLocation": "<ShortCode>",
"cellNumber": "<CellNo>",
"context": "homechoicedirect"
}
South African ID numbers are 13 digits: YYMMDDGSSSCAZ
Main entry point. Overrides webhook_code to HCSCORE
regardless of input. Uses param_1 as the record GUID.
Transforms bloom_hcscorewa_payload into bloom_hcscore
with DOB extraction, gender inference, and default values.
POSTs lead data to the HC AWS gateway. Reads cell number,
ID, and shortcode from the payload table.
ObjHookHCScore.py -- Main HCSCORE webhook handlerObjHookHCScoreCR.py -- Credico variantObjHookHCScoreAO.py -- Account Origination variantHCSCORE workflow -- Bureau scoring pipelineUpdated : 2026-03-20