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 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.smsup.ch
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.smsup.ch
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>
        
      

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>