Créer un webhook

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 plateforme 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 Vous pouvez créer une signature secrète afin que nous puissions signer les demandes de webhook avec ce secret dans l'en-tête 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"
    }
}
          
        

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>