التوثيق: API لرموز التحقق و SMS وواتساب والمكالمات والبريد
كل ما تحتاجه لربط Echo بمشروعك.
- البدء السريع من الصفر إلى أول رسالة في خمس دقائق.
- المصادقة يحمل كل طلب أحد مفاتيح API لتطبيقك في ترويسة Authorization. أنشئ المفاتيح من اللوحة في قسم التطبيقات.
- الرسائل ضع رسالة في الطابور. يختار Echo أحد هواتفك أو أرقام واتساب المتصلة ويبلّغ عن كل تغيير.
- التحقق أثبت أن الشخص يملك رقم الهاتف. الرموز عشوائية، تُستخدم مرة واحدة، تنتهي صلاحيتها، ولا تُعرض لك أو تُحفظ بشكل مقروء.
- المكالمات اجعل أحد هواتفك يرنّ لرقم ما، مثلاً لتنبيه شخص دون رسالة.
- الهواتف يرسل Echo عبر هواتف وأرقام تملكها. اربط هاتف أندرويد بتطبيق Echo بمسحة واحدة.
- واتساب اربط رقم واتساب بـ Echo وأرسل منه عبر الـ API نفسه.
- محادثات واتساب اقرأ محادثات كل رقم واتساب مرتبط، وافتح أيًّا منها بكامل سجلها وملفاتها، وأرسل نصًا أو ملفًا، والتقط صورة للمحادثة كما يعرضها واتساب ويب. والأمر نفسه في لوحة التحكم: الأجهزة، رقم واتساب، المحادثات.
- البريد الإلكتروني اربط حساب بريدك بـ Echo وأرسل منه رسائل بريد بمفتاح الـ API نفسه.
- أجهزة Echo عندما لا يستطيع أي من أجهزتك الوصول إلى رقم (لا شريحة من ذلك البلد، ولا رقم واتساب، ولا حساب بريد)، ترسل أجهزة Echo رمز التحقق الخاص بك: هواتف وأرقام واتساب وحسابات بريد يشاركها الناس مع Echo.
- شارك واربح كل شريحة ورقم واتساب وحساب بريد يمكنه إعارة جزء من يومه لأجهزة Echo. كل رمز يرسله لشخص آخر يربحك مالاً.
- شرائح محلية وحدود يومية الشريحة تراسل وتتصل بأرقام بلدها فقط، على أي مشغّل: لا إلى الخارج أبداً، والرسائل الواردة من الخارج تُتجاهل. وكل جهاز يلتزم أيضاً بحدود يومية واحدة للجميع.
- الـ Webhooks حدّد عنوان webhook لتطبيقك. يرسل Echo إليه أحداث JSON ويعيد المحاولة لمدة يوم إذا كان خادمك متوقفاً.
- الأخطاء كل خطأ له الشكل نفسه. احتفظ بـ request_id: يستطيع الدعم تتبّعه.
- الحدود والفوترة كل خطة تتضمن وحدات شهرية. بعدها، يُحسب الاستخدام الإضافي فقط إذا فعّلته، وحتى سقفك الشهري.
البدء السريع
من الصفر إلى أول رسالة في خمس دقائق.
- سجّل الدخول إلى اللوحة بحساب المنصة.
- أنشئ تطبيقاً ومفتاح API من قسم التطبيقات.
- اربط هاتف أندرويد أو رقم واتساب من قسم الأجهزة.
- استدعِ الـ API من خادمك باستخدام المفتاح.
أرسل رسالة
POST /v1/echo/messagesتحقق من رقم هاتف
POST /v1/echo/verificationsPOST /v1/echo/verifications/VERIFICATION_ID/checkلا يوجد هاتف مربوط بعد؟ يرد الإرسال بـ 409 no_device. اربط هاتفاً من الأجهزة أولاً.
