Kampagne

Mit dieser Methode können Sie eine Kampagne an einen oder mehrere Empfänger senden.

POST

/send

Body-Parameter

text
notwendig
 Ihre Nachricht
value
notwendig
 Die Handynummern der Empfänger
pushtype Die Art des Versands (alert oder marketing)
delay Versanddatum Y-m-d H:i:s. Muss in der Zeitzone liegen Europe/Paris
sender Ermöglicht das Personalisieren des Absenders
gsmsmsid Eine selbst gewählte ID, um die Nachricht mit ihrer Empfangsbestätigung zu verknüpfen
unicode Activate the unicode mode, allowing special chars and reducing the length of one SMS to 70 characters. Standard 0

Beispiele


POST /send HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/json

{
  "sms": {
    "message": {
      "text": "Message via API",
      "pushtype": "alert",
      "sender": "Illidan",
      "delay": "2025-01-01 10:21:39",
      "unicode": 0
    },
    "recipients": {
      "gsm": [
        {
          "gsmsmsid": "100",
          "value": "33612345678"
        },
        {
          "gsmsmsid": "101",
          "value": "33612345677"
        }
      ]
    }
  }
}
          
        

<?xml version="1.0" encoding="UTF-8"?>
<sms>
  <message>
    <text>Message via API</text>
    <pushtype>alert</pushtype>
    <sender>Illidan</sender>
    <delay>2025-01-01 10:21:39</delay>
    <unicode>0</unicode>
  </message>
  <recipients>
    <gsm gsmsmsid="100">33612345678</gsm>
    <gsm gsmsmsid="101">33612345677</gsm>
  </recipients>
</sms>
        
      

\SMSFactor\SMSFactor::setApiToken('your token');

$response = \SMSFactor\Campaign::send([
  'sms' => [
    'message' => [
      'text' => 'Message via API',
      'pushtype' => 'alert',
      'sender' => 'Illidan',
      'delay' => '2025-01-01 10:21:39',
      'unicode' => 0
    'recipients' => [
      'gsm' => [
        [
          'gsmsmsid' => "100",
          'value' => '33612345678'
        ],
        [
          'gsmsmsid' => "101",
          'value' => '33612345677'
        ]
      ]
    ]
  ]
], false); // True to simulate the campaign (no SMS sent)

Ergebnisformat


{
  "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
  "npai": 0               //Number of npai numbers
  "invalid": 0,           //Number of invalid numbers
  "not_allowed": 0,       //Number of SMS sent to a not allowed country
  "flood": 0,             //Number of SMS filtered by anti-flood
  "country_limit": 0,     //Monthly limit for this country reached
}
          
        

<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>
  <npai>0</npai>
  <invalid>0</invalid>
  <not_allowed>0</not_allowed>
  <flood>0</flood>
  <country_limit>0</country_limit>
</response>