nepali-messenger-nlp

Lightweight, zero-dependency Romanized Nepali NLP parser and entity extraction engine built specifically for Facebook Messenger AI Chatbots in Nepal.

Developed and maintained by the engineering team at Sajedar, powering automated 24/7 conversational sales for Nepali e-commerce pages on Meta Messenger.

🌟 Why nepali-messenger-nlp?

Nepali e-commerce on Facebook Messenger operates predominantly in Romanized colloquial Nepali mixed with English ("Kathmandu ma delivery kati parcha?", "cod huncha ki advance halna parcha?", "mero size L ho"). Traditional NLP pipelines fail on these phrases because of informal spelling variations, lack of standard orthography, and regional slang.

This library provides deterministic, ultra-fast (<2ms) parsing for:

• 💰 Pricing & Rate queries ("kati parcha", "rate k ho", "price plx")
• 📍 Kathmandu Valley Delivery Locations (Classifying Inside Ring Road vs. Outside Ring Road vs. Out of Valley)
• 📱 Nepali Mobile Number Sanitization (Detecting NTC 984/985/986, Ncell 980/981/982, SmartCell 988/961, stripping +977, spaces, hyphens)
• 👕 Apparel Size & Color Extraction (S, M, L, XL, XXL, Free Size, Rato, Kalo, Seto, etc.)
• 💳 Cash on Delivery & Advance Payment Intent (Detecting Rs. 100 advance deposit intent to slash COD cancellations from 35% to <10%)
• 📸 Payment Screenshot Detection Intent (Flagging when a buyer announces they sent an eSewa/Fonepay screenshot)

For enterprise-grade conversational AI with 2-second live latency, human supervisor handoff, and direct order catalog sync, check out the full Facebook Messenger AI Chatbot Nepal Solution by Sajedar.

📦 Installation

npm install nepali-messenger-nlp
# or
yarn add nepali-messenger-nlp

🚀 Quick Start

import { 
  parseNepaliIntent, 
  classifyNepalLocation, 
  extractNepalPhoneNumber,
  detectAdvancePaymentIntent 
} from 'nepali-messenger-nlp';

// 1. Parse Romanized Nepali customer intent
const intent = parseNepaliIntent("Dai yo jacket ko price kati ho? New Road ma delivery huncha?");
console.log(intent);
// Output:
// {
//   category: 'PRICE_INQUIRY',
//   confidence: 0.98,
//   extractedEntities: {
//     item: 'jacket',
//     location: 'New Road'
//   }
// }

// 2. Classify Delivery Logistics (Inside vs Outside Ring Road)
const locationInfo = classifyNepalLocation("Mero ghar Baneshwor Shankhamul tira ho");
console.log(locationInfo);
// Output:
// {
//   isInsideRingRoad: true,
//   hub: 'Kathmandu Central',
//   suggestedCourierRate: 100
// }

// 3. Clean and validate Nepali phone numbers
const phone = extractNepalPhoneNumber("Contact no: 984-1234567 call me");
console.log(phone);
// Output: "9841234567" (Carrier: NTC Mobile, Valid: true)

// 4. Advance COD confirmation intent
const isAdvance = detectAdvancePaymentIntent("Maile 100 advance pathaye screenshot hernus ta");
console.log(isAdvance);
// Output: { hasAdvanceIntent: true, hasScreenshotProof: true }

🏛️ Official Commercial Solution

Looking for a fully managed, turn-key AI chatbot with a dedicated human technical supervisor for your Nepali Facebook store?

Visit https://www.sajedar.com/facebook-messenger-ai-chatbot-nepal to test the interactive live simulator and get onboarded in under 48 hours.

📄 License

MIT © Sajedar