Webhooks para enviar y recibir mensajes

Casos de uso

• Crea un bot de respuesta automática para SMS y WhatsApp.
• Guarde mensajes y chats en su propia base de datos al recibirlos.
• Guarde las notificaciones en su propia base de datos al recibirlas.
• Guarde las respuestas USSD en su propia base de datos al recibirlas.
• Envíe la carga útil a las direcciones de correo electrónico especificadas.
• Envía un SMS/Chat cuando recibas una notificación de Facebook.
• Haz algo cuando recibas una notificación de una aplicación.

Cómo funciona

El sistema recibe un evento recibido de ambas fuentes, luego se invocará la url del webhook y se enviarán los datos de la carga útil. Cuando su servidor de webhook lo recibe, puede hacer cualquier cosa con la carga útil usted mismo. Las cargas útiles se envían con el método POST para garantizar una entrega eficiente.

Estructura de carga útil

La estructura de la carga útil es sencilla; Solo necesita verificar el tipo de carga útil y luego procesar el contenido del cuerpo de datos.

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

Ejemplo de código

 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;