Webhooks برای ارسال و دریافت پیام

موارد استفاده

• یک ربات خودکار برای SMS و WhatsApp ایجاد کنید.
• ذخیره پیام ها و چت به پایگاه داده خود را در دریافت.
• اعلان ها را در پایگاه داده خود در دریافت ذخیره کنید.
• ذخیره پاسخ USSD به پایگاه داده خود را در دریافت.
• Payload را به ادرس های ایمیل مشخص شده ارسال کنید.
• ارسال SMS / چت زمانی که شما یک اطلاع رسانی از فیس بوک.
• وقتی اعلانی از یک برنامه دریافت می کنید کاری انجام دهید.

چگونه کار می کند

سیستم یک رویداد دریافت شده از هر دو منبع دریافت می کند، سپس url webhook فراخوانی می شود و داده های محموله ارسال می شود. هنگامی که سرور webhook شما ان را دریافت می کند، می توانید هر کاری را با محموله خود انجام دهید. Payloads با روش POST برای اطمینان از تحویل کارامد ارسال می شود.

ساختار ترابری

ساختار محموله ساده است؛ شما فقط باید نوع payload را بررسی کنید و سپس محتوای بدنه داده را پردازش کنید.

# sms

[
    "type" => "sms", // type of payload: received sms
    "data" => [
        "id" => 2, // unique id from the system
        "rid" => 10593, // unique id from the device
        "sim" => 1, // sim card slot
        "device" => "00000000-0000-0000-d57d-f30cb6a89289", // device unique id
        "phone" => "+639760713666", // sender phone number
        "message" => "Hello World!", // message
        "timestamp" => 1645684231 // receive timestamp
    ]
]

# whatsapp

[
    "type" => "whatsapp", // type of payload: received whatsapp chat
    "data" => [
        "id" => 2, // unique id from the system
        "wid" => "+639760713666", // whatsapp account phone number
        "phone" => "+639760666713", // sender phone number
        "message" => "Hello World!", // message
        "timestamp" => 1645684231 // receive timestamp
    ]
]

# ussd

[
    "type" => "ussd", // type of payload: received ussd response
    "data" => [
        "id" => 98, // unique id from the system
        "sim" => 1, // sim card slot
        "device" => "00000000-0000-0000-d57d-f30cb6a89289", // device unique id
        "code" => "*143#", // ussd code
        "response" => "Sorry! You are not allowed to use this service.", // ussd response
        "timestamp" => 1645684231 // receive timestamp
    ]
]

# notification

[
    "type" => "notification", // type of payload: received notification
    "data" => [
        "id" => 77, // unique id from the system
        "device" => "00000000-0000-0000-d57d-f30cb6a89289", // device unique id
        "package" => "com.facebook.katana", // application package name
        "title" => "Someone commented on your post!", // notification title
        "content" => "Someone commented on your post!", // notification content
        "timestamp" => 1645684231 // receive timestamp
    ]
]

کد مثال

 Webhooks)

    /**
     * Validate webhook secret
     */

    if(isset($request["secret"]) && $request["secret"] == $secret):
        // Valid webhook secret
        $payloadType = $request["type"];
        $payloadData = $request["data"];

        // do something with the payload
        print_r($payloadType);
        print_r($payloadData);
    else:
        // Invalid webhook secret
    endif;