واجهة REST
أنشئ مكالمات، وأدر الوكلاء والحملات، واقرأ النصوص.
المطوّرون
واجهة REST وWebhooks موقّعة للمكالمات والحملات والنصوص.
أنشئ مكالمات، وأدر الوكلاء والحملات، واقرأ النصوص.
conversation.ended وappointment.booked بتوقيع HMAC وإعادة محاولة.
HTTPS وJSON مباشرة، مع أمثلة جاهزة لـ Node.js وPython وcURL.
اختبر الوكلاء بأمان قبل الإطلاق.
conversation.endedانتهت مكالمة، مع النتيجة والمدة وجهة الاتصال.appointment.bookedتم إنشاء موعد مؤكد.يحمل كل طلب Frontdesk-Signature: t=<ثوانٍ>,v1=<HMAC-SHA256 لـ t.body>. أعد حسابه بسرّ التوقيع وارفض الطوابع الزمنية القديمة.
const res = await fetch("https://api.frontdesk.example/v1/calls/outbound", { method: "POST", headers: { Authorization: `Bearer ${process.env.FRONTDESK_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ contactId: "c_8f2…", from: "+15550100190", idempotencyKey: crypto.randomUUID() })});// → 202 Accepted · conversation.ended webhook when the call finishesimport os, uuid, requests res = requests.post( "https://api.frontdesk.example/v1/calls/outbound", headers={"Authorization": f"Bearer {os.environ['FRONTDESK_KEY']}"}, json={"contactId": "c_8f2…", "from": "+15550100190", "idempotencyKey": str(uuid.uuid4())},)# → 202 Accepted · conversation.ended webhook when the call finishescurl -X POST https://api.frontdesk.example/v1/calls/outbound \ -H "Authorization: Bearer $FRONTDESK_KEY" \ -H "Content-Type: application/json" \ -d '{"contactId":"c_8f2…","from":"+15550100190","idempotencyKey":"7d1c…"}' # → 202 Acceptedتحدّث مع الذكاء الاصطناعي بنفسك. يستغرق الأمر عشر ثوانٍ.