Condividere
Webhooks are one of the most useful features of our platform. It allows developers and site owners to listen for events from the devices or WhatsApp server, which is useful for creating automated tasks. This function is specifically designed for receiving events only, such as sms, WhatsApp chat, ussd response, and android notifications.
Postato a: feb 10, 2023 - 1,672 Visualizzazioni
Casi d'uso
- Crea un bot di risposta automatica per SMS e WhatsApp.
- Salva i messaggi e le chat nel tuo database al momento della ricezione.
- Salva le notifiche nel tuo database alla ricezione.
- Salva le risposte USSD nel tuo database alla ricezione.
- Invia il payload agli indirizzi e-mail specificati.
- Invia un SMS/Chat quando ricevi una notifica da Facebook.
- Esegui un'operazione quando ricevi una notifica da un'app.
Come funziona
Il sistema riceve un evento ricevuto da entrambe le origini, quindi verrà richiamato l'URL del webhook e verranno inviati i dati del payload. Quando il server webhook lo riceve, puoi fare qualsiasi cosa con il payload da solo. I payload vengono inviati con il metodo POST per garantire una consegna efficiente.
Struttura del carico utile
La struttura del carico utile è semplice; È sufficiente controllare il tipo di payload e quindi elaborare il contenuto del corpo dati.
# 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
]
]
[
"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
]
]
Esempio di codice
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;