توثيق برمجي مصمم للمهندسين والمطورين
واجهات REST API موحدة، توقيعات Webhooks مشفرة بـ HMAC، ومفاتيح API بصلاحيات دقيقة لتكامل سهل مع أي نظام CRM أو ERP.
Base URL: https://api.chatour.me
POST/developer/messages/send
إرسال بريد إلكتروني أو رسالة برمجياً (مثل Resend)
إرسال رسائل بريد إلكتروني وقوالب HTML مباشرة باستخدام مفتاح الـ API Token. يشترط فقط أن يكون البريد الراسل من نطاقك الموثق (دون اشتراط إنشاء صندوق بريد مسبقاً).
Request Payload (cURL):
curl -X POST https://api.chatour.me/developer/messages/send \
-H "Authorization: Bearer chatour_live_9a8f3b2c1e4d" \
-H "Content-Type: application/json" \
-d '{
"from": "[email protected]",
"to": "[email protected]",
"subject": "فاتورة اشتراكك لشهر أكتوبر #48291",
"html": "<div style=\"font-family: sans-serif;\"><h2>مرحباً عميلنا العزيز</h2><p>تم إصدار فاتورتك بقيمة <b>50$</b> بنجاح.</p><a href=\"https://pay.chatour.me/inv_48291\" style=\"display:inline-block;padding:10px 18px;background:#2563EB;color:#fff;border-radius:6px;text-decoration:none;\">دفع الفاتورة</a></div>",
"body": "فاتورة اشتراكك لشهر أكتوبر بقيمة 50$ جاهزة للدفع عبر الرابط: https://pay.chatour.me/inv_48291"
}'Response (200 OK):
{
"success": true,
"messageId": "msg_9048f3e218b0c",
"smtpMessageId": "<[email protected]>",
"status": "DELIVERED",
"from": "[email protected]",
"to": "[email protected]",
"subject": "فاتورة اشتراكك لشهر أكتوبر #48291",
"createdAt": "2026-10-18T19:30:00.000Z"
}محاكي الـ Webhooks لحظياً
تلقى الأحداث في نظامك بمجرد استلام رسالة أو قراءة إيميل مع توقيع HMAC مشفر
Header: X-Chatour-Signature: sha256=9b82c3...HMAC Verified ✓
{
"event": "message.inbound",
"timestamp": "2026-10-15T01:30:00Z",
"channel": "whatsapp",
"from": "+201000000000",
"text": "أود الاستفسار عن تفاصيل عقد الصيانة السنوي.",
"assigned_workspace": "Sales & Inbound"
}صلاحيات مفاتيح الـ API (Scoped API Tokens)
لا تعطي كامل الصلاحيات لجميع التطبيقات؛ خصص صلاحيات دقيقة لكل نظام
ROLE-BASED TOKENS
messages:write
إرسال الرسائل الفورية والمجدولة فقط دون قراءة السجل
emails:send
إرسال الإيميلات الرسمية من عناوين محددة (مثل billing@)
webhooks:manage
إضافة وتعديل روابط استقبال الأحداث
channels:read
فحص حالة اتصال القنوات والبوتات ومصادقة النطاقات
احصل على مفتاح API تجريبي مجاناً فور إنشاء مساحة عملك.أنشئ حساب المطور مجاناً