v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:07:00.000Z▲ 0 upvotes

WhatsApp Cloud API + 1C: فاتورة الدفع من خلال وكيل الذكاء الاصطناعي مع تأكيد بشري

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

المهمة وحدودها

يكتب العميل على الواتساب: "نحتاج إلى 20 صندوقًا من ورق A4 و5 خراطيش لشركة HP، فاتورة لشركة Romashka LLP." أرغب في ظهور فاتورة 1C بمفردها وإرسال ملف PDF إلى العميل. المشكلة هي أن النموذج اللغوي يخطئ بثقة في أرقام المقالات ويخترع الأسعار ويربك المقاولين. لذلك، تم تصميم البنية بحيث يقوم النموذج فقط بما هو قوي فيه: تحويل النص الحر إلى بنية.

توزيع المسؤوليات:

  • LLM: استخراج قائمة الأصناف والكميات واسم المشتري من الرسالة.
  • 1C: العثور على العنصر والطرف المقابل، وحساب الأسعار والخصومات، وإنشاء مستند "فاتورة الدفع للمشتري"، وإنشاء نموذج مطبوع.
  • الرجل: قم بتأكيد الحساب بنقرة واحدة.
  • WhatsApp Cloud API: تسليم الرسالة والملف.

استقبال الرسائل

ترسل Cloud API خطافات الويب إلى عنوان HTTPS الخاص بك. عند التهيئة، يقوم Meta بإجراء طلب GET باستخدام المعلمات hub.mode، hub.verify_token و hub.challenge؛ تقوم بإرجاع hub.challenge إذا كان الرمز المميز مطابقًا. يتم توقيع المشاركات الواردة بالرأس X-Hub-Signature-256 - HMAC-SHA256 لنص الطلب في سر التطبيق.

// app/api/whatsapp/route.ts
import { createHmac, timingSafeEqual } from "node:crypto";

export async function GET(req: Request) {
  const u = new URL(req.url);
  if (u.searchParams.get("hub.mode") === "subscribe" &&
      u.searchParams.get("hub.verify_token") === process.env.WA_VERIFY_TOKEN) {
    return new Response(u.searchParams.get("hub.challenge") ?? "");
  }
  return new Response("forbidden", { status: 403 });
}

export async function POST(req: Request) {
  const raw = await req.text();
  const sig = req.headers.get("x-hub-signature-256") ?? "";
  const expected = "sha256=" + createHmac("sha256", process.env.WA_APP_SECRET!).update(raw).digest("hex");
  if (sig.length !== expected.length || !timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
    return new Response("bad signature", { status: 401 });
  }
  const body = JSON.parse(raw);
  const msg = body.entry?.[0]?.changes?.[0]?.value?.messages?.[0];
  if (msg?.type === "text") {
    await enqueueInvoiceRequest({ waId: msg.from, messageId: msg.id, text: msg.text.body });
  }
  return new Response("ok");   // отвечаем сразу, обработка в очереди
}

قم بتخزين msg.id بفهرس فريد: يمكن لـ Meta تسليم رسالة واحدة بشكل متكرر.

استرجاع الهيكل

يتم نقل النص ونظام الاستجابة الصارم فقط إلى النموذج. لا توجد أسعار أو كتالوج في الموجه - وإلا فإنها ستبدأ في "اختيارها".

import { z } from "zod";

export const InvoiceRequest = z.object({
  buyerName: z.string().nullable(),
  items: z.array(z.object({
    query: z.string(),          // как клиент назвал товар
    quantity: z.number().int().positive(),
    unit: z.string().nullable() // "коробка", "шт"
  })).min(1),
  needsClarification: z.string().nullable()
});

وبعد أن يستجيب النموذج، يتم التحقق من صحة النتيجة بواسطة الدائرة. إذا فشل التحقق من الصحة أو لم يكن needsClarification فارغًا، فسيطرح الروبوت على العميل سؤالًا توضيحيًا بدلاً من التخمين.

خدمة HTTP الضيقة في 1C

1C:Enterprise 8.3 لديه واجهة OData قياسية، ولكن منح الوكيل إمكانية الوصول إلى المستندات من خلالها أمر محفوف بالمخاطر: هذا عبارة عن CRUD واسع النطاق يشمل الجزء المنشور بالكامل من التكوين. من الأكثر موثوقية كتابة خدمة HTTP في تكوين (أو ملحق) بطريقتين:

  • POST /hs/invoices/draft - يقبل المشتري والعناصر كسلاسل استعلام، ويبحث عن العناصر والأطراف المقابلة، ويعيد مسودة بالعناصر التي تم العثور عليها والأسعار وقائمة بما لم يتم العثور عليه. لم يتم نشر الوثيقة.
  • POST /hs/invoices/{id}/confirm — ينشر المستند ويعيد ملف PDF للنموذج القابل للطباعة.

من الأفضل البحث عن التسميات باستخدام نص مجاني على الجانب 1C (بالاسم والمادة والمرادفات)، حيث توجد كتب مرجعية وقواعد تسعير حالية. انشر الخدمة على خادم ويب مع مستخدم 1C منفصل لديه حقوق هذه العمليات فقط، وأغلقها خلف قائمة VPN أو IP.

التأكيد والإرسال

تذهب المسودة إلى المدير (في Telegram أو CRM أو في نفس مراسلات WhatsApp، إذا كان رقم المدير متصلاً) باستخدام زري "تأكيد" و"صحيح". فقط بعد التأكيد يتم استدعاء confirm وإرسال ملف PDF إلى العميل:

async function sendInvoicePdf(to: string, pdfUrl: string, number: string) {
  const res = await fetch(
    `https://graph.facebook.com/${process.env.WA_GRAPH_VERSION}/${process.env.WA_PHONE_NUMBER_ID}/messages`,
    {
      method: "POST",
      headers: { Authorization: `Bearer ${process.env.WA_TOKEN}`, "Content-Type": "application/json" },
      body: JSON.stringify({
        messaging_product: "whatsapp",
        to,
        type: "document",
        document: { link: pdfUrl, filename: `Счёт ${number}.pdf`, caption: `Счёт ${number}` }
      })
    }
  );
  if (!res.ok) throw new Error(`WhatsApp API ${res.status}: ${await res.text()}`);
}

يجب أن يكون pdfUrl قابلاً للوصول عن طريق Meta عبر HTTPS؛ استخدم رابطًا موقّعًا قصير العمر بدلاً من المجلد العام الذي يحتوي على جميع الحسابات. احتفظ بإصدار Graph API في متغير بيئة وقم بتحديثه وفقًا لجدول إهمال Meta.

قيود الواتس اب التي يتذكرها الناس متأخرا

  • لا يمكن إرسال الرسائل المجانية إلا خلال 24 ساعة بعد آخر رسالة للعميل. إذا أكد المدير الفاتورة في اليوم التالي، فستحتاج إلى رسالة نموذجية تمت الموافقة عليها مسبقًا.
  • يجب أن يكون الرقم مسجلاً في منصة واتساب للأعمال. تعتمد إمكانية استخدام هذا الرقم في وقت واحد في تطبيق WhatsApp Business للهاتف المحمول على شروط التعريف الحالية - تحقق قبل الترحيل لتجنب فقدان المراسلات.
  • يتم تحميل الرسائل وفقًا لقواعد التعريف؛ تحقق من نموذج الدفع الحالي لمنطقتك.

عندما لا تؤتي الأتمتة ثمارها

إذا كان هناك العشرات من الفواتير يوميًا وكان نطاق المنتجات صغيرًا، فإن قالب الاستجابة السريعة والإنشاء اليدوي في 1C يكونان أسرع في التنفيذ وأسهل في الصيانة. يكون الوكيل منطقيًا عندما تكون الطلبات من نفس النوع، وهناك الكثير منها، ويتم الحفاظ على دليل العناصر في 1C بعناية. بدون مرجع نظيف، لن يتمكن أي نموذج من العثور على المواضع الصحيحة.

Нужна реализация под ваш проект или аудит архитектуры?

Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.

Обсуждение (0)

Ещё на vbcd4u.com