Umhlahlandlela we-Agent USSD

I-agent USSD inika ema-field teams kanye nema-outlet teams i-channel letsite yemisebenti yekusebenta. I-agent flows yehlukaniswe ngenhloso ne-customer USSD kuze kube yimisebenti ye-outlet ihlale ku-*234# kantsi i-self-service ye-customer ihlale ku-*123#.

Note: I-customer self-service isebentisa *123#. I-agent operations isebentisa *234#. I-organization quick operations isebentisa *321#.

Ngamafuphi

Intfo	Inani
I-dial code	*234#
I-audience	Bo-agent kanye nema-super agent
Timalulwimi	English ne-siSwati
Kwatisa session	Agent MSISDN
Authentication	Agent PIN ngaphambi kwekutsi imenyu ivuleke
Session timeout	Imizuzu le-5 yekungasebenti
Test gateway	https://api.test.emali2.damplabs.com/api/v1/ussd/sessions
Local gateway	http://localhost:8805/ussd_gateway/api/v1/ussd/sessions

Imenyu ye-agent

Inketho	Umsebenti	Isetjentiselwa ini
1	Faka Imali	Cala i-deposit ye-customer esitolo
2	Dlulisela Float	Dlulisela float kulomunye agent lapho kuvuliwe
3	Khupha Float	Khipha operational float lapho kuvuliwe
4	Hlola Float	Buka simo se-float lesikhona
5	Commission Report	Hlola earnings kanye nema-window we-commission
6	Iphrofayela Yami	Buka profile details kanye netisetelo
7	Lusito	Buka operating limits kanye netinombolo tesekelo
0	Phuma	Vala i-agent session

Tibonelo temenyu lephila live

English PIN gate nemenyu

Enter your agent PIN to continue.

0. Back

AGENT SERVICES
Agent: John Dlamini (000001)
Type: REGULAR Agent

1. Cash In Service
2. Transfer Float
3. Withdraw Float
4. Check Float
5. Commission Report
6. My Profile
7. Help & Guidelines
0. Logout

siSwati PIN gate nemenyu

Faka i-agent PIN yakho kuze uchubeke.

0. Buyela emuva

AGENT SERVICES
Agent: John Dlamini (000001)
Luhlobo: PREMIUM Agent

1. Faka Imali
2. Dlulisela Float
3. Khupha Float
4. Hlola Float
5. Commission Report
6. Iphrofayela Yami
7. Lusito
0. Phuma

Indlela isession lechubeka ngayo

1. Agent ushaya *234#.
2. Isession icala ngekukhetsa lulwimi.
3. Ngemuva kwekukhetsa lulwimi, i-gateway ikhombisa i-agent PIN challenge masinyane.
4. Uma i-agent PIN seyemukelwe, isession ihlala kulolo lulwimi bese i-agent menu iyavuleka.
5. I-agent angahamba aye ku-float, profile, help, kanye ne-cash-in flows aze aphume noma session iphelelwe sikhatsi.

I-request format yesimulator

{
  "sessionId": "agent-menu-001",
  "msisdn": "+26876543001",
  "text": "",
  "serviceCode": "*234#",
  "networkCode": "ALL",
  "newSession": true
}

Uma i-gateway environment yakho idzinga request signing, faka X-Emali2-Ussd-Key header ku-request yesimulator. Kuma-public test kanye nema-local flow ingahle ingadzingeki.

Tibonelo te-flow

1. Cala i-agent session bese uyacinisekisa

BASE_URL="https://api.test.emali2.damplabs.com/api/v1/ussd/sessions"
SESSION_ID="agent-menu-001"

curl -sS "$BASE_URL" \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId":"'"$SESSION_ID"'",
    "msisdn":"+26876543001",
    "text":"",
    "serviceCode":"*234#",
    "networkCode":"ALL",
    "newSession":true
  }'

curl -sS "$BASE_URL" \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId":"'"$SESSION_ID"'",
    "msisdn":"+26876543001",
    "text":"1",
    "serviceCode":"*234#",
    "networkCode":"ALL",
    "newSession":false
  }'

curl -sS "$BASE_URL" \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId":"'"$SESSION_ID"'",
    "msisdn":"+26876543001",
    "text":"1234",
    "serviceCode":"*234#",
    "networkCode":"ALL",
    "newSession":false
  }'

2. Vula lusito

Le-help screen inika ema-outlet teams guidance yansuku tonkhe.

curl -sS "$BASE_URL" \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId":"'"$SESSION_ID"'",
    "msisdn":"+26876543001",
    "text":"7",
    "serviceCode":"*234#",
    "networkCode":"ALL",
    "newSession":false
  }'

I-response levamile:

AGENT GUIDELINES
Cash In/Out Limits:
Min: E10, Max: E5000

Working Hours:
6:00 AM - 10:00 PM

Emergency Support:
Call: 2505 0000

3. Cala i-cash-in flow

curl -sS "$BASE_URL" \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId":"'"$SESSION_ID"'",
    "msisdn":"+26876543001",
    "text":"1",
    "serviceCode":"*234#",
    "networkCode":"ALL",
    "newSession":false
  }'

I-response levamile:

Cash In Service
Help customer deposit money to their wallet.
Enter customer's mobile number:

4. Hlola float

curl -sS "$BASE_URL" \
  -H 'Content-Type: application/json' \
  -d '{
    "sessionId":"'"$SESSION_ID"'",
    "msisdn":"+26876543001",
    "text":"4",
    "serviceCode":"*234#",
    "networkCode":"ALL",
    "newSession":false
  }'

I-response levamile:

Float Balance
Checking your current float...
Please wait.

Guidance yekusebenta

Cash-in

• Cala ku-1. Faka Imali.
• Faka i-MSISDN ye-customer.
• Chubeka nge-amount kanye nema-confirmation prompts letikhonjiswa yimenyu.
• Nika customer iciniso lekucedvwa ngaphambi kwekutsi aphume esitolo.

Float operations

• Sebentisa 2. Dlulisela Float noma 3. Khupha Float kuphela uma role ye-agent kanye ne-backend configuration kukuvumela.
• Sebentisa 4. Hlola Float ngaphambi kwemisebenti lemikhulu yesitolo.
• Bo-supervisor kusamele basebentise i-web channel nge-reconciliation kanye ne-end-of-day review.

Commission kanye ne-profile

• Sebentisa 5. Commission Report kumawindow we-earnings.
• Sebentisa 6. Iphrofayela Yami kubona profile details, imisebenti ye-PIN, kanye netinketho letihlobene nesekelo.

I-customer cash-out handoff

I-customer cash-out ayicali ku-agent dial code.

1. I-customer icalisa i-cash out ku-*123#.
2. I-customer ifaka i-agent till kanye ne-amount.
3. I-customer itfola withdrawal code ngemuva kwe-confirmation.
4. I-agent icinisekisa le handoff esitolo bese icedzisa umnyakato wemali.

Loku kugcina withdrawals letigunyatwe yi-customer tihlala ku-customer channel futsi kugwema kutihlanganisa ne-agent root menu.

Inothi ye-rollout

I-root menu, kukhetsa lulwimi, i-PIN gate, kanye ne-help entry kuphila live futsi kuvivinyiwe. Kuvulwa kwema-transactional submenu kusewuhlobo lolungahluka nge-role, environment, kanye nenchubo ye-service provider, ngako kuhle kutsi supervisor anike umvumo ngaphambi kwekusabalalisa field training material.

Imodeli yekuvikeleka

Kubalulekile: Ngemuva kwekukhetsa lulwimi, i-agent kufanele ifake i-agent PIN levumelekile ngaphambi kwekutsi imenyu lenkhulu ivele.

• I-agent operations iboshelwe ku-agent MSISDN kanye ne-live session.
• I-dial code letsite ivimbela kutihlanganisa kwema-customer menu nema-agent menu.
• Logout ikhona ngco ku-agent root menu.

Tinkinga letivamile nekuyilungisa

Luphawu	Kuvamise kusho ini	Yini lokufanele yenziwe yi-agent
Incorrect PIN	I-agent PIN yiphutsa	Phindza ucophelela noma usebentise indlela lekhona ye-PIN reset
Agent not found	I-MSISDN ayiboshelwanga ku-agent losebentako	Cinisekisa onboarding kanye ne-MSISDN mapping
Float operation not available	Role noma backend permissions kunemkhawulo	Sebentisa web back office noma supervisor workflow
Session restarted	Isession iphelelwe sikhatsi	Shaya futsi bese ucala kabusha umsebenti

Imihlahlandlela lehlobene

• Customer USSD Guide
• Agent Guide
• Channels Matrix