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 |
Über die Art der Sendung und den Absender
Wenn Sie die grundlegenden Informationen über SMS noch nicht gelesen haben, wäre es von Vorteil dies zu tun.
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": "2024-12-21 10:50:23",
"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>2024-12-21 10:50:23</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' => '2024-12-21 10:50:23',
'unicode' => 0
'recipients' => [
'gsm' => [
[
'gsmsmsid' => "100",
'value' => '33612345678'
],
[
'gsmsmsid' => "101",
'value' => '33612345677'
]
]
]
]
], false); // True to simulate the campaign (no SMS sent)
Ergebnisformat
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
"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>
Quelle est la différence entre cost, total et sent ?
Das Feld cost
ist die Anzahl der Credits, die Ihre Kampagne gekostet hat. Zur Erinnerung: Eine SMS mit mehr als 160 Zeichen kostet mindestens 2 Credits. Mehr darüber
Das Feld total
ist die Anzahl der Telefonnummern, die Sie zur Erstellung Ihrer Kampagne angegeben haben..
Das Feld sent
ist die Anzahl der Telefonnummern, an die wir tatsächlich eine SMS geschickt haben (nach Entfernung ungültiger Nummern, Blacklist ...).