JavaScript SDK

1. ثبّت الـ SDK

محتاج Node.js 20 أو أحدث، مع ESM (type: module في package.json). اسم الـ package wayo-agent. استخدم التحميل لحد ما ينزل على الـ registry.

npm install ./wayo-agent-javascript.tgz

npm install wayo-agent

2. حط الـ signing secret بتاعك

من الإعدادات ← المطوّرين، انسخ الـ signing secret بتاعك. الـ SDK محتاجه، سواء Chat أو Webhook أو REST.

$env:WAYO_SECRET="whsec_REPLACE_WITH_YOUR_REAL_SECRET"

export WAYO_SECRET="whsec_REPLACE_WITH_YOUR_REAL_SECRET"

3. رجّع أول رد

ابدأ بالمثال الكامل ده على جهازك. بيرجّع رد تجربة التوصيل.

import { createServer } from "node:http";
import { Wayo } from "wayo-agent";
const wayo = Wayo.fromEnv();
wayo.onMessage(async message => "Wayo is connected.");
createServer(wayo.nodeHandler()).listen(8080, "127.0.0.1");

node standalone.mjs

رجّع نص عادي أو object فيه reply مش فاضي. بدّل رد التجربة بالبحث في المخزون أو المحل بتاعك. سجّل handler واحد بس.

// Initialize wayo and register onMessage in a server-only module.
import { wayo } from "./business-integration.js";

export const POST = wayo.handler();
export const runtime = "nodejs";

4. وصّل في وايو

اعمل deploy ورا عنوان عام بـ HTTPS، أو افتح السيرفر اللي على جهازك من خلال HTTPS tunnel. الـ localhost ماينفعش يبقى endpoint لوايو.

https://your-business.example/

اختار Chat API، ودخّل الـ endpoint النهائي، ودوس جرّب التوصيل. المفروض يظهرلك “Wayo is connected.” وبعدين بدّل رد التجربة ببيانات حقيقية وجرّب تاني قبل ما تحفظ.

نفس الـ handler بياخد Webhook POST و REST GET. شوف الطلبات والردود عشان أشكالهم. أمثلة السيرفر المستقل للتطوير؛ استخدم الاستضافة العادية بتاعتك للـ production والزباين الحقيقيين.