Créer un webhook
Il existe un Historiques de Requêtes disponible sur notre plateforme pour vous aider à mettre en place vos webhooks.
Les webhooks sont un moyen simple pour recevoir les informations sur la réception de vos messages et leurs réponses. Pour créer un webhook, il vous suffit de vous connecter sur notre plate-forme puis d'aller dans le menu Developpeurs ou simplement avec l'API.
POST
/webhook
Paramètres du body
type
requis
|
Le type du webhook (MO / DLR / STOP / CLICKER / BALANCE_ALERT) |
url
requis
|
L'url du webhook |
signature | You can create a secret signature so we can sign the webhook requests with that secret in the header X-SMSFactor-Signature |
Exemples
POST /webhook HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/json
{
"webhook":{
"type": "DLR",
"url": "https://yourserverurl.com",
"signature": "mysignature123"
"status": "live",
"last_http_code": null
}
}
POST /webhook HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<webhook>
<type>DLR</type>
<url>https://yourserverurl.com</url>
<signature>mysignature123</signature>
<status>live</status>
<last_http_code>null</last_http_code>
</webhook>
$response = \SMSFactor\Webhook::create([
'webhook' => [
'type' => 'DLR',
'url' => "https://yourserverurl.com",
"signature" => "mysignature123"
]
]);
$webhook_id = $response->webhook->webhook_id;
Format de la réponse
{
{
"status": 1,
"message": "OK",
"webhook": {
"webhook_id": "66",
"type": "MO",
"url": "https://yourserverurl.com"
"signature": "mysignature123"
}
}
}
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>1</status>
<message>OK</message>
<webhook>
<webhook_id>66</webhook_id>
<type>DLR</type>
<url>https://yourserverurl.com</url>
</webhook>
</response>
Les adresses IP de nos serveurs
Vous allez peut-être devoir autoriser les requêtes issues de nos serveurs à votre pare-feu. Voici la liste des adresses IP de nos serveurs :
- 163.172.210.135
- 163.172.210.137
- 51.159.7.123
- 51.159.21.54