shop-voice-checkin

Shop Voice Check-in

Use this skill when a shop owner has opted in to regular phone check-ins instead of entering data into an app. The agent calls, speaks in simple English, Pidgin-influenced English, or Hindi-English (Hinglish), asks about stock and sales, and returns structured JSON for a local shop ledger.

This skill is the voice layer of Voice Shop Manager — "your business manager, on the phone."

When to use

• Morning inventory check-in — approximate stock levels, low items, supplier mentions
• Evening sales recap — approximate daily revenue, top sellers, restock spend
• Voice-first workflows for informal retailers in Nigeria, West Africa, or similar markets (India via English/Hindi task variants)

Pair with the runnable app at apps/python/shop-voice-manager/ (relative to this submission repository root) to persist results in SQLite and generate weekly summaries.

Demo mode: Default hackathon path uses fixtures — no live call. See references/demo-mode.md.

When not to use

• Cold-calling retailers who did not consent
• Loan offers, credit scoring conversations, or regulated financial advice on the call
• Replacing a POS, accounting system, or tax filing workflow
• Batch supplier procurement calls without explicit authorization per recipient
• Recurring schedules without a separate scheduler wrapper — see call-reminder

Required fields

For each call, require:

• shop_id — stable identifier for the retailer
• call_type — inventory, sales, reorder_offer, vendor_order, order_status, or onboarding
• phone — E.164 number of the consenting shop owner (or, for vendor_order, the consenting vendor)
• region — CALL-E region code, e.g. NG or IN
• locale — CALL-E locale, e.g. en
• recipient_consented — must be true for live calls

Optional:

• currency — NGN, INR, etc.
• language_style — pidgin-english, english, or hindi-english
• products_to_ask — short list for morning check-ins
• timezone — IANA name for scheduling context