Webhooks pour l’envoi et la réception de messages

Cette fonction est spécialement conçue pour recevoir uniquement des événements, tels que des SMS, un chat WhatsApp, une réponse ussd et des notifications Android.

Cas d’utilisation

• Créez un bot de réponse automatique pour les SMS et WhatsApp.
• Enregistrez les messages et les chats dans votre propre base de données lors de la réception.
• Enregistrez les notifications dans votre propre base de données lors de leur réception.
• Enregistrez les réponses USSD dans votre propre base de données lors de la réception.
• Envoyez la charge utile aux adresses e-mail spécifiées.
• Envoyez un SMS/Chat lorsque vous recevez une notification de Facebook.
• Faites quelque chose lorsque vous recevez une notification d’une application.

Comment ça marche ?

Le système reçoit un événement reçu des deux sources, puis l’URL du webhook est appelée et les données de charge utile sont envoyées. Lorsque votre serveur de webhook le reçoit, vous pouvez faire n’importe quoi avec la charge utile vous-même. Les charges utiles sont envoyées avec la méthode POST pour assurer une livraison efficace.

Structure de la charge utile

La structure de la charge utile est simple ; Il vous suffit de vérifier le type de charge utile, puis de traiter le contenu du corps de données.

# 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
    ]
]

Exemple de code

 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;