Liste erstellen
Mit dieser Methode können Sie eine Kontaktliste erstellen. Jeder Kontakt kann bis zu 4 personalisierte Informationen enthalten. Diese Informationen können dann in jeder Nachricht integriert werden.
Wenn Sie zum Beispiel [info1]
in Ihren Text einfügen, wird dieser automatisch durch die entsprechenden personalisierten Kontaktinformationen ersetzt.
POST
/list
Body-Parameter
value
notwendig
|
Die Empfängernummer in format E.164 |
name | Der Name der Liste. Wenn kein Name angegeben wird, wird das Erstellungsdatum als Standardname verwendet |
info1 | Information 1 |
info2 | Information 2 |
info3 | Information 3 |
info4 | Information 4 |
Beispiele
POST /list HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/json
{
"list": {
"name": "My list",
"contacts": {
"gsm": [
{
"value": "33612345678",
"info1": "Louis",
"info2": "de Broglie",
"info3": "1892",
"info4": "Dieppe"
},
{
"value": "33612345677",
"info1": "Richard",
"info2": "Feynman",
"info3": "1918",
"info4": "New-York"
}
]
}
}
}
POST /list HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<list>
<name>My list</name>
<contacts>
<gsm>
<value>33612345678</value>
<info1>Louis</info1>
<info2>de Broglie</info2>
<info3>1892</info3>
<info4>Dieppe</info4>
</gsm>
<gsm>
<value>33612345677</value>
<info1>Richard</info1>
<info2>Feynman</info2>
<info3>1918</info3>
<info4>New-York</info4>
</gsm>
</contacts>
</list>
$response = \SMSFactor\ContactList::create([
'list' => [
'name' => 'My list',
'contacts' => [
'gsm' => [
[
'value' => '33612345678',
'info1' => 'Louis',
'info2' => 'de Broglie',
'info3' => '1892',
'info4' => 'Dieppe'
],
[
'value' => '33612345677',
'info1' => 'Richard',
'info2' => 'Feynman',
'info3' => '1918',
'info4' => 'New-York'
]
]
]
]
]);
Ergebnisformat
{
"status": 1,
"message": "OK",
"contacts": 2,
"invalid": 0,
"duplicates": 0,
"id": "5a0331bffc5886074551ce97" //the id of the created list. It's an ObjectId type (string of 12 chars)
}
<response>
<status>1</status>
<message>OK</message>
<contacts>2</contacts>
<invalid>0</invalid>
<duplicates>0</duplicates>
<id>50433</id>
</response>