Campagna con lista

Questo metodo ti permette di inviare una campagna a una lista.

POST

/send/lists

Parametri del body

text richiesto	Il messaggio
value richiesto	L’id della lista
pushtype	Il tipo di invio (`alert` o `marketing`)
delay	Data d’invio `Y-m-d H:i:s`
sender	Ti permette di personalizzare il mittente
unicode (default 0)	Attiva la modalità unicode, riducendo la lunghezza dell'SMS a 70 caratteri

A proposito del tipo di invio e del mittente

If you havn't already read the basic informations about the SMS and how pushtype and sender work, you might be interested in doing so.

Esempi


POST /send/lists HTTP/1.1
Host: api.smsup.ch
Authorization: Bearer your.token
Accept: application/json

{
  "sms": {
    "message": {
      "text": "Message via API",
      "pushtype": "alert",
      "sender": "Ganondorf",
      "delay": "2024-04-28 10:30:17",
      "unicode": 0
    },
    "lists": [
      {
        "value": 45190
      },
      {
        "value": 47854
      }
    ]
  }
}


POST /send/lists HTTP/1.1
Host: api.smsup.ch
Authorization: Bearer your.token
Accept: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<sms>
  <message>
    <text>Message via API</text>
    <pushtype>alert</pushtype>
    <sender>Ganondorf</sender>
    <delay>2024-04-28 10:30:17</delay>
    <unicode>0</unicode>
  </message>
  <lists>
    <value>45190</value>
  </lists>
  <lists>
    <value>47854</value>
  </lists>
</sms>

Formato della risposta

A status -8 doesn't mean your SMS won't be sent. No need to retry unless you want to send the same SMS multiple times 😉


{
  "status": 1,      
  "message": "OK",
  "ticket": "14672468",   //The id of your campaign
  "cost": 2,              //The cost of your campaign
  "credits": 642,         //Your credits after your campaign has been created
  "total": 2,             //Number of message before filtering  
  "sent": 2,              //Number of message after filtering
  "blacklisted": 0,       //Number of blacklisted numbers
  "duplicated": 0,        //Number of duplicated numbers
  "invalid": 0,           //Number of invalid numbers
  "npai": 0               //Number of npai numbers
}


<response>
  <status>1</status>
  <message>OK</message>
  <ticket>14672468</ticket>
  <cost>2</cost>
  <credits>642</credits>
  <total>2</total>
  <sent>2</sent>
  <blacklisted>0</blacklisted>
  <duplicated>0</duplicated>
  <invalid>0</invalid>
  <npai>0</npai>
</response>